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
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-lands 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'
Query Result
Use Cases
- Land-bank scouting for developers who flag urban and buildable plots in a municipality before bidding or optioning.
- Price-per-square-metre comparison of buildable versus non-building plots across municipalities using the price and size filters.
- New-plot alerts that poll sinceDate=W or sinceDate=M for a set of sublocations and notify when a parcel appears.
- Rural plot hunting for self-build, farming or off-grid projects by combining nonBuildingLand with a maximum price.
- Supply benchmarking across neighbouring sublocations to decide where to concentrate land acquisition effort.
- Agency land inventory audits that scope a search to one microsite short name and track how its plot stock changes.
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.