Idealista Property
Extract full property details from an Idealista listing URL, including price, specs, photos by room, features, energy rating, and advertiser data.
Credit cost: 2 credits per call
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
query*string
Full 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.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.piloterr.com/v2/idealista/property?query=string"{
"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"
}{
"error": "Bad Request"
}{
"error": "Invalid API Key"
}{
"error": "Payment required"
}{
"error": "Rate limit exceeded for the API key: quota monthly"
}{
"error": "Internal Error"
}