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
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/property-details 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'
Query Result
Use Cases
- Enrich a shortlist of saved listings with photos from multimedia and coordinates from ubication so each one can be drawn on a map view.
- Re-fetch a listing and compare modificationDate before sending a price or availability alert, so stale ads are never pushed to users.
- Power the detail screen of a rental or buying app in the visitor's own language by passing the matching language value.
- Dedupe listings that arrive from several data sources by using adid as the canonical key for each Idealista ad.
- Separate agency ads from private sellers using the contactInfo advertiser type, while leaving personal contact data out of stored datasets.
- Estimate how long a property has been on the market by snapshotting modificationDate over time, remembering it marks the last change rather than the publication date.
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.