List the homes or garages of a new-build promotion on Idealista
View all Idealista Property Listings API for Spain, Portugal & Italy endpoints →Lists the individual units of one new-build promotion (development) on Idealista, described by the source as brand new homes or garages. Four inputs are required and there are no pagination or filter parameters: the country site (location: es, pt or it), the response language (locale), parentPromotionId, which the source says to take from promotionProperties -> promotionId, and propertyType (homes or garages), which the source says to take from promotionProperties -> propertyType. The documented sample promotion ID is 104907187. No live response was captured for this endpoint, so its response fields are unverified. The new-homes listing sample of this API exposed a promoName field and a development flag but no dedicated promotion identifier, so confirm on a live response where the promotionProperties values appear before chaining calls.
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-promotion-properties API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/idealista/list-promotion-properties?key=<API_KEY>&locale=es%2Cit%2Cpt%2Cen%2Cca%2Cde%2Cfr%2Cnl%2Cnb&location=es%2Cpt%2Cit&parentPromotionId=104907187&propertyType=homes%2Cgarages'
Query Result
Use Cases
- Development detail page that expands a promotion into its individual homes so buyers see every available unit.
- Sales-pace tracker that snapshots a promotion's units daily and counts how many disappear between runs.
- Unit-mix comparison between competing developments in the same district, grouped by what each promotion still offers.
- Sales-agent dashboard that lists the remaining units per development for a developer's commercial team.
- Parking add-on finder that requests propertyType=garages to see which garage units come with a new-build promotion.
- Off-plan buyer comparison table that calls the endpoint for several promotion IDs and lines the units up side by side.
Frequently asked questions
What does this endpoint return?
The source describes it only as listing promotion properties, meaning brand new homes or garages of a development. No live response was captured, so field names are unverified; make a first call and inspect the JSON before depending on specific fields.
Where do I get parentPromotionId?
The source says to take it from promotionProperties -> promotionId in a listing result. The new-homes sample of this API showed a promoName field and a development flag but no dedicated promotion identifier, so check a live response to see where the value appears.
What values does propertyType take?
The documented values are homes and garages, and the source says to take the value from promotionProperties -> propertyType. Send a single value per request; the prefilled homes,garages simply lists both.
Does this endpoint paginate or accept filters?
No. The documented inputs are only locale, location, parentPromotionId and propertyType, so there is no page number, page size, sort order, price filter or locationId.
Is the sample promotion ID 104907187 always valid?
It is the documented sample value. Promotions can sell out or be withdrawn, so it may stop returning units; replace it with a current ID from a fresh listing result.
Which countries and languages are supported?
location accepts es (Spain), pt (Portugal) and it (Italy), and locale accepts es, it, pt, en, ca, de, fr, nl and nb. Send one code for each; the prefilled values list the accepted choices.