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

Whole-building listings only Targets entire buildings on sale or rent rather than single flats, which suits investors who buy a block and refurbish or resell it unit by unit.
Price band and size band filters minPrice, maxPrice, minSize and maxSize cut the result set to the buildings that fit a budget and a footprint, all as plain numbers.
Twelve sort orders including price per square metre order accepts relevance, lowestprice, highestprice, mostrecent, leastrecent, highestpricereduction, lowestpricem2, highestpricem2, biggest, smallest, highestfloors and lowestfloors.
Publication windows through sinceDate T limits results to the last 24 hours (rent only), Y to the last 48 hours (sale only), W to the last week and M to the last month; leaving it blank applies no date limit.
Agency-scoped building search Set micrositeShortName to see only the buildings published by a single agency, which makes an agency portfolio view possible.
Page-by-page retrieval numPage starts at 1 and maxItems sets the page size, so a full area can be collected over several requests.
Country and language selection location switches between the Spain, Italy and Portugal sites and locale accepts es, it, pt, en, ca, de, fr, nl or nb.

Live API Demo

GET /api/project/idealista/list-buildings

Request cost is temporarily unavailable. No price is assumed.

View pricing

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'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →