Idealista Property
GET
Extract full property details from an Idealista listing URL, including price, specs, photos by room, features, energy rating, and advertiser data.
Credit cost: 3 credits per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringFull Idealista property detail URL.
Example:
https://www.idealista.com/fr/inmueble/111463799/Notes:
- Only Idealista
/inmueble/listing URLs are accepted. - Copy the listing URL from search results or from idealista.com.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
url?stringplans?array<string>price?integertitle?stringunits?array<unknown>images?address?array<string>updated?stringcurrency?unknownfeatures?location?stringdescription?stringadvertiser_url?stringadvertiser_name?stringcurl -X GET 'https://api.piloterr.com/v2/idealista/property?query=string'Example Response
{ "url": "https://www.idealista.com/fr/inmueble/111463799/", "plans": [ "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/40/06/bd/1437393638.jpg" ], "price": 1650000, "title": "Appartement à vendre - Calle de Guzmán el Bueno", "units": [], "images": { "Photo": [ "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/ef/d3/38/1437388712.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/f9/a7/7c/1437388648.jpg" ], "Salon": [ "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/e7/b4/e6/1437388651.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/d8/27/78/1437388731.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/7f/5e/d2/1437388732.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/cd/7a/2d/1437388727.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/13/a4/ec/1437388726.jpg" ], "Chambre": [ "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/4d/a4/f9/1437388711.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/32/0c/c6/1437388713.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/7d/0c/b8/1437388714.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/39/89/a8/1437388725.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/5a/ae/4c/1437388554.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/58/54/25/1437388553.jpg", "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/3c/10/96/1437388708.jpg" ], "Cuisine": [ "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/ff/c9/ed/1437388730.jpg" ], "Salle de bains": [ "https://img4.idealista.com/blur/WEB_DETAIL/0/id.pro.es.image.master/10/6f/0b/1437388710.jpg" ] }, "address": [ "Calle de Guzmán el Bueno", "Quartier Gaztambide", "District Chamberí", "Madrid", "Madrid capitale, Madrid" ], "updated": "Annonce actualisée le 14 mai", "currency": null, "features": { "Immeuble": [ "4ème étage logement sur rue", "Avec ascenseur" ], "Équipement": [ "Climatisation" ], "Caractéristiques": [ "Surface construite 190 m²", "4 chambres", "3 salles de bains", "Terrasse", "D'occasion/en bon état", "Armoires encastrées", "Orientation ouest", "Construit en 1862", "Chauffage individuel: Gaz naturel" ], "Diagnostic de performance énergétique": { "emissions": "D", "consumption": "C" } }, "location": "Gaztambide, Madrid", "description": "Appartement de Luxe à Chamberí - Madrid | 190 m² | 4 Chambres\nDécouvrez votre nouveau chez-vous dans l'un des quartiers les plus exclusifs de Madrid! Nous vous présentons cet appartement spectaculaire de 190 m², entièrement rénové à neuf, situé dans la prestigieuse rue Guzmán el Bueno, au cœur de Chamberí. Situé au quatrième étage avec ascenseur, ce bien combine l'élégance classique d'un immeuble de 1862 avec toutes les commodités modernes dont vous avez besoin.\nCaractéristiques Principales\nCet appartement se distingue par sa distribution parfaite avec 4 chambres spacieuses et 3 salles de bains complètes, dont une suite parentale avec salle de bains privative. Le logement dispose de placards intégrés dans toutes les chambres, garantissant un rangement optimal. La cuisine est entièrement équipée d'appareils électroménagers intégrés de dernière génération, prête à être utilisée dès le premier jour.\nConfort et Luminosité\nL'excellente orientation ouest et la hauteur du quatrième étage garantissent une luminosité exceptionnelle dans tout le logement. De plus, il dispose d'une terrasse privée parfaite pour profiter de l'extérieur. Le bien comprend la climatisation et le chauffage par pompe à froid/chaud avec gaz naturel, assurant votre confort tout au long de l'année.\nEntièrement Meublé et Prêt à Habiter\nVous n'aurez rien à faire! L'appartement est entièrement meublé et décoré avec goût, prêt à emménager.\nEmplacement Privilégié\nChamberí est synonyme de qualité de vie. Votre nouveau chez-vous sera entouré de commerces de choix, de restaurants renommés, d'écoles prestigieuses et d'espaces verts. Les connexions de transport sont excellentes, facilitant vos déplacements dans toute la ville.\nIdéal pour résidence principale ou comme investissement de haut niveau. Contactez-nous pour une visite sans engagement!", "advertiser_url": "https://www.idealista.com/fr/pro/hillspropertiesbcn/", "advertiser_name": "Hills Properties"}