Piloterr

Idealista Property

GET
/v2/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: 3 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

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.
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
url?string
plans?array<string>
price?integer
title?string
units?array<unknown>
images?
address?array<string>
updated?string
currency?unknown
features?
location?string
description?string
advertiser_url?string
advertiser_name?string
Example Request
curl -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"}