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

Unit-level view of one development A single parentPromotionId expands a new-build promotion into the individual homes or garages it contains, instead of the one summary row shown in a listing search.
Homes or garages switch The propertyType parameter selects whether you retrieve the homes or the garages of the promotion, so parking add-ons can be pulled separately from residential units.
Chains from listing results The source documents that parentPromotionId and propertyType come from the promotionProperties data of a listing result, so the endpoint works as a drill-down step after a new-build search.
Four-parameter request Only locale, location, parentPromotionId and propertyType are needed, with no page number, sort order or filters, which keeps scheduled unit snapshots simple to automate.
Promotions across three country sites location takes es, pt or it and locale takes nine language codes, so the same call shape works for promotions in Spain, Portugal and Italy.
Prefilled sample promotion The documented sample promotion ID 104907187 is prefilled so you can send a first request immediately and inspect the live response shape before wiring in your own IDs.

Live API Demo

GET /api/project/idealista/list-promotion-properties

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-promotion-properties?key=<API_KEY>&locale=es%2Cit%2Cpt%2Cen%2Cca%2Cde%2Cfr%2Cnl%2Cnb&location=es%2Cpt%2Cit&parentPromotionId=104907187&propertyType=homes%2Cgarages'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →