Search whole buildings on Idealista by area, price and size
View all Idealista Property Listings API for Spain, Portugal & Italy endpoints →Returns a paged list of whole-building listings from Idealista for one location. Required inputs are locale, location (country site es, it or pt), locationId (for example 0-EU-ES-28-07-001-079 for the Madrid municipality), operation (sale or rent), order (one of twelve sort orders), maxItems and numPage. Optional inputs narrow the search with minPrice and maxPrice, minSize and maxSize, a sinceDate publication window (T, Y, W or M) and micrositeShortName to keep only one agency's buildings. No live sample or response example has been recorded for this endpoint yet, so its response fields are not listed here; inspect a response from your own request before mapping fields.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/idealista/list-buildings API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-buildings?key=<API_KEY>&locale=es&location=es&locationId=0-EU-ES-28-07-001-079&maxItems=30&numPage=1&operation=sale&order=relevance'
Query Result
Use Cases
- Scan for whole buildings on sale within a price and size band as candidates for refurbishment or per-unit resale
- Compare the price per square metre of buildings with individual flats in the same neighbourhood
- Poll with sinceDate set to the last day or week to alert investors about newly listed buildings
- Scout hostel, aparthotel or co-living conversion candidates in a target city
- Build an agency portfolio view of the buildings an agency currently advertises through micrositeShortName
Frequently asked questions
What kind of listings does this endpoint return?
Whole buildings advertised on Idealista, not individual flats or houses. Use the dedicated home, office or land listing endpoints for those property types.
Where do I get the locationId?
Look the place up with the location suggestions endpoint and pass the locationId of the chosen match. For example, 0-EU-ES-28-07-001-079 is the Madrid municipality as returned by that endpoint.
What do the sinceDate values mean?
T is the last 24 hours and works with rent only, Y is the last 48 hours and works with sale only, W is the last week and M is the last month. Leave it blank for no publication-date restriction.
How do I page through the results?
Start with numPage=1 and increase it for each further page. maxItems sets the page size; the documented values are 30, 40 and 0, and the meaning of 0 is not documented.
Which sort orders are available?
relevance, lowestprice, highestprice, mostrecent, leastrecent, highestpricereduction, lowestpricem2, highestpricem2, biggest, smallest, highestfloors and lowestfloors.
Can I limit the search to one agency?
Yes. Pass the agency's microsite short name in micrositeShortName and the search is narrowed to that agency's buildings; omit it to include every advertiser.
Which response fields does this endpoint return?
No live sample has been recorded for this endpoint yet, so its field list is not documented here. Run a request with your own parameters and check the returned JSON before building a parser.