Get Idealista property details by listing ID

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

Returns the full record of a single Idealista property ad, identified by its numeric propertyId. Inputs: propertyId (required, the ad ID, echoed back as adid), location (required, the Idealista market: es for Spain, pt for Portugal, it for Italy) and language (required, the language of the ad text: en, es, it, pt, ca, de, fr, nl or nb). Fields observed in a live probe of one Spain sale listing (propertyId 112272495, language en, location es, HTTP 200): adid, price and priceInfo (amount, currencySuffix), operation, propertyType, extendedPropertyType, homeType, state, country, multimedia (images with url, tag, localizedName, width and height, plus videos, virtual3DTours and hasMultimediasMadeByIdealista), ubication (title, latitude, longitude, hasHiddenAddress, administrativeAreaLevel1 to 4, locationId, locationName), moreCharacteristics (roomNumber, bathNumber, constructedArea, floor, lift, garden, swimmingPool, exterior, energyPerformance and more), energyCertification, priceDropInfo, propertyComment and comments (with language and autoTranslated flags), translatedTexts, suggestedTexts, detailedType, labels, contactInfo (commercialName, userType, micrositeShortName, professional and related advertiser fields), detailWebLink, several allows* feature flags, tracking and modificationDate (an object with value and text). No published response example was supplied for this operation, so every field named here comes from that single probe; other listings, such as rentals, other countries or withdrawn ads, may omit or add fields. modificationDate reflects the last change to the ad, not its first publication date.

API Features

Single-listing lookup by ad ID Pass one numeric propertyId and receive the complete Idealista ad as a JSON object. The same ID comes back as adid, so results can be keyed, cached and deduplicated without extra mapping.
Photos, videos and 3D tours The multimedia object lists every image with its url, tag, localised name, width and height, followed by videos and virtual 3D tours, and a flag showing whether the portal itself produced any of the media.
Coordinates and area hierarchy The ubication object carries latitude, longitude, locationId, locationName and four administrative area levels, plus a hasHiddenAddress flag, which is enough to place a listing on a map or join it to a regional dataset.
Price drop and energy rating data Read the current price and priceInfo amount with its currency suffix, the priceDropInfo block with value, percentage and date, and the energyCertification block with consumption and emissions entries.
Rooms, area and amenity flags moreCharacteristics exposes roomNumber, bathNumber, constructedArea, floor and boolean amenity flags such as lift, garden, swimmingPool and exterior, ready for filtering or comparison tables.
Advertiser type and last-change date contactInfo shows whether the ad comes from a professional or a private advertiser, with commercialName and micrositeShortName for agencies, while modificationDate gives the last change as an epoch value and display text.
Ad text in nine languages The language parameter selects en, es, it, pt, ca, de, fr, nl or nb for the ad text; the comments array marks each entry with its language and whether it was auto-translated.

Live API Demo

GET /api/project/idealista/property-details

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/property-details?key=<API_KEY>&language=en&location=es&propertyId=112272495'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

What does the Property Details endpoint return?

It returns one JSON object describing a single Idealista ad. In the live probe of a Spain sale listing the object contained adid, price, priceInfo, operation, propertyType, homeType, state, multimedia, ubication, moreCharacteristics, energyCertification, contactInfo, detailWebLink and modificationDate, among other fields. No published response example was available, so other listings may differ.

Where do I get a propertyId?

propertyId is the numeric ad ID of the listing, usually the number in the listing's web address, and the response repeats it as adid. The listing search endpoints in this project are the natural place to collect IDs in bulk. The example value 112272495 is the listing used in the probe.

Which values do location and language accept?

location accepts es, pt or it, which are the Spain, Portugal and Italy markets. language accepts en, es, it, pt, ca, de, fr, nl or nb and sets the language of the ad text. Both are required. The probe used location es with language en, and the response reported country es.

Does the response include coordinates and photos?

Yes. In the probe, ubication held latitude and longitude along with locationId, locationName and administrative area levels 1 to 4, and multimedia held images with url, width and height, plus videos and virtual3DTours. A hasHiddenAddress flag is also returned, so check it before treating the position as an exact address.

What does modificationDate mean and can I use it as the listing age?

modificationDate came back as an object with a numeric value and a display text, and moreCharacteristics repeated the numeric value. It marks the last change to the ad, not the date it was first published, so it is useful for freshness checks but only approximates days on the market if you snapshot it over time.

Is advertiser contact information included, and should I store it?

contactInfo returned advertiser fields such as commercialName, userType, micrositeShortName, professional and contact details. Use userType and professional to tell agencies from private sellers, and keep personal contact data out of long-term datasets unless you have a lawful basis to process it.

How do I know a listing is still available?

The probed listing reported state active and an operation of sale. Only a successful lookup was probed, so behaviour for removed or expired ads was not verified. Read the state field on every response and handle non-200 results in your own code.

Related operations

Guides

View Subscription Plans →