List new-build homes for sale or rent on Idealista
View all Idealista Property Listings API for Spain, Portugal & Italy endpoints →Lists new-build home properties (Buy/Rent > New home) on Idealista for one location, with optional filters. Required inputs are the country site (location: es, it or pt), the response language (locale), a locationId from the suggestions or sublocations endpoints, the operation (sale or rent), a sort order, the page number (numPage) and the page size (maxItems, up to 40; 0 returns only the item count). Optional filters cover finished new builds, rent-to-own, state-subsidized housing, bank offers, flats, houses or chalets, bedroom counts (bedrooms0 to bedrooms4, where bedrooms4 means four or more) and minPrice/maxPrice. In an observed sample call (locale=es, location=es, locationId=0-EU-ES-28-07-001-079, operation=sale, order=relevance, maxItems=5) the response was a JSON object with elementList (array of listings), total, totalPages, actualPage, itemsPerPage, numPaginations, summary, filter, alertName, totalAppliedFilters, searchTitle, lowerRangePosition, upperRangePosition and paginable. Each observed listing carried fields such as propertyCode, price, priceInfo, propertyType, operation, address, municipality, district, locationId, latitude, longitude, url, description, numPhotos, multimedia, contactInfo, newDevelopmentFinished, isRentToOwn and promoName.
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-new-homes API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-new-homes?key=<API_KEY>&locale=es&location=es&locationId=<locationId>&maxItems=30%2C40&numPage=<numPage>&operation=sale&order=relevance'
Query Result
Use Cases
- New-build pipeline tracker per city that separates finished stock from under-construction projects using the finished flag and newDevelopmentFinished.
- First-time-buyer finder that lists state-subsidized developments under a maxPrice ceiling for a chosen municipality.
- Rent-to-own aggregator that searches operation=rent with rentToOwn=true and compares monthly price information across sublocations.
- Developer competitor price monitor that compares flats against houses or chalets and tracks promoName and priceInfo over time.
- Mortgage lead-generation page that highlights new builds carrying a bank offer next to a loan calculator.
- Market-size dashboard that calls maxItems=0 for many location IDs to chart new-build supply cheaply.
- Interactive development map that plots latitude and longitude from each row and links back to the portal listing.
Frequently asked questions
What does the response contain?
In an observed call the response was a JSON object with an elementList array of listings plus total, totalPages, actualPage, itemsPerPage, numPaginations, summary, filter, alertName, totalAppliedFilters, searchTitle, lowerRangePosition, upperRangePosition and paginable. Listings carried propertyCode, price, priceInfo, address, latitude, longitude, url, contactInfo, multimedia flags, newDevelopmentFinished, isRentToOwn and promoName, among others.
How do I count new-build listings without downloading them?
Set maxItems to 0, which the parameter documentation describes as returning the item count as a fast response. The observed sample used maxItems=5 instead, so the count-only mode comes from the documentation rather than from a captured call.
How do I get only finished new homes?
Set finished to true. Leave it unset to include new builds at every stage; each row also reports newDevelopmentFinished so you can classify stock yourself.
Can I search rentals, rent-to-own or subsidized homes?
Set operation to rent for rentals and combine it with rentToOwn=true for rentals with a buying option. Set stateSubsidized=true to filter subsidized housing. Rows expose an isRentToOwn flag in the observed response.
Where do I get locationId and which country should I use?
Resolve a place name with the suggestions endpoint of this API and drill down with the sublocations endpoint. The sample ID 0-EU-ES-28-07-001-079 returned results for Madrid (filter.locationName was Madrid) with location=es. Use es, it or pt for the country that matches the ID.
How do the bedroom filters work?
bedrooms0 to bedrooms3 are separate boolean switches and bedrooms4 means four or more bedrooms. Combining several switches is expected to widen the match like a multi-select, but that behaviour was not exercised in the observed call, so test the combination you need.
What is the maximum page size and how do I paginate?
maxItems accepts up to 40; larger values are ignored. Increase numPage and stop at totalPages. In the observed sample, numPage=1 with maxItems=5 returned actualPage 1, itemsPerPage 5, total 271 and totalPages 55, so totals reflect the market at call time.
Does it identify the development behind each unit?
Observed rows include promoName and a newDevelopment flag, but no dedicated promotion identifier field was seen in the sample. Check a live response before wiring results into the promotion-units endpoint of this API.