List land plots for sale or rent on Idealista

View all Idealista Property Listings API for Spain, Portugal & Italy endpoints →

Returns a paginated list of land plots advertised on Idealista for sale or rent in one location. Required inputs are the country site (location: es, it or pt), the response language (locale), a locationId taken from the suggestions or sublocations endpoints, the operation (sale or rent), a sort order, the page number (numPage) and the page size (maxItems). Optional filters narrow the search by land type (urban, buildingLand for buildable plots, nonBuildingLand for non-buildable plots), minimum and maximum price, minimum and maximum plot size, a publication window (sinceDate: T last 24 hours for rent only, Y last 48 hours for sale only, W last week, M last month) and an agency microsite short name. No live response was captured for this endpoint, so its response fields are unverified; it is expected to follow the paginated listing envelope seen on the new-homes listing (an elementList array of properties plus total, totalPages and actualPage), which you should confirm with a first call.

API Features

Land-type switches Three boolean flags, urban, buildingLand and nonBuildingLand, let you target urban plots, buildable plots or non-buildable (rustic) plots instead of mixing every parcel type in one result.
Price and plot-size window minPrice, maxPrice, minSize and maxSize bound a search to the budgets and parcel areas you care about, so small garden plots and large rural estates can be separated server-side.
Recency windows for new plots sinceDate limits results to plots published in the last 24 hours (T, rent only), 48 hours (Y, sale only), week (W) or month (M), which suits alerting on freshly listed land.
Agency-scoped land search The optional micrositeShortName parameter scopes the search to a single agency microsite, helping you audit what one land agent currently advertises.
Price-per-area and size sort orders The order parameter accepts twelve documented values including lowestpricem2, highestpricem2, biggest and smallest, so cheap-per-square-metre or largest-first rankings need no client-side sorting.
Spain, Portugal and Italy in nine languages Pick the country site with location (es, it, pt) and the text language with locale (es, it, pt, en, ca, de, fr, nl, nb) while reusing the same locationId workflow across markets.

Live API Demo

GET /api/project/idealista/list-lands

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-lands?key=<API_KEY>&locale=es%2Cit%2Cpt%2Cen%2Cca%2Cde%2Cfr%2Cnl%2Cnb&location=es%2Cit%2Cpt&locationId=0-EU-ES-28-07-001-079&maxItems=30%2C40%2C0&numPage=1&operation=sale%2Crent&order=relevance%2Clowestprice%2Chighestprice%2Cmostrecent%2Cleastrecent%2Chighestpricereduction%2Clowestpricem2%2Chighestpricem2%2Cbiggest%2Csmallest%2Chighestfloors%2Clowestfloors'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

Which land types can I filter by?

Three optional boolean flags are available: urban for urban land, buildingLand for buildable plots and nonBuildingLand for non-buildable (rustic) plots. The source does not document how combined flags behave, so test the combination you need on your target location.

What does the response look like?

No live response was captured for this endpoint, so its fields are not verified. The sibling new-homes listing returns an object with an elementList array and pagination fields (total, totalPages, actualPage, itemsPerPage); land results are expected to use the same envelope, but confirm that with a first call before relying on specific field names.

How do I get a valid locationId?

Use the suggestions endpoint of this API to resolve a place name to an ID and the sublocations endpoint to drill down into districts or neighbourhoods. The sample ID 0-EU-ES-28-07-001-079 resolved to Madrid in a new-homes sample call; the country segment of the ID should match the location parameter.

Why do some fields come prefilled with several values?

The documented defaults for locale, location, operation, order and maxItems list the accepted choices (for example sale,rent and 30,40,0). Replace them with a single value per request, such as operation=sale, order=relevance and maxItems=30.

What do the sinceDate values mean?

Leave sinceDate empty for no recency filter. T means the last 24 hours and is for rent operations only, Y means the last 48 hours and is for sale operations only, W means the last week and M means the last month.

How many plots can I request per page?

The listing endpoints of this API document a maximum of 40 items per page and a value of 0 to return only the result count. This endpoint prefills 30,40,0, which matches those values, but the cap is not separately confirmed for lands; page through results with numPage.

Related operations

Guides

View Subscription Plans →