# Idealista Property ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/idealista/property` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/idealista-property | ## Description Extract full property details from an Idealista listing URL, including price, specs, photos by room, features, energy rating, and advertiser data. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/idealista/property' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Lookup Calle de Guzmán el Bueno, Madrid ```json { "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" } ``` ## Documentation ## Overview Extract comprehensive property details from an Idealista listing page. Returns pricing, title, address, room-by-room photos, floor plans, features, energy rating, description, and advertiser metadata via browser rendering. ## Quickstart ``` GET https://api.piloterr.com/v2/idealista/property?query=https://www.idealista.com/fr/inmueble/111463799/ ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Full Idealista property detail URL | ## Response fields | Field | Type | Description | |---|---|---| | `url` | string | Canonical listing URL | | `title` | string | Listing title | | `price` | integer | Listing price | | `currency` | string \| null | Currency when available | | `location` | string | Short location label | | `address` | array | Address lines (street, district, city) | | `updated` | string | Last update label | | `description` | string | Full listing description | | `plans` | array | Floor plan image URLs | | `images` | object | Photos grouped by room label | | `features` | object | Grouped feature strings; may include nested energy rating (`emissions`, `consumption`) | | `units` | array | Related units when available | | `advertiser_name` | string \| null | Agency or advertiser name | | `advertiser_url` | string \| null | Agency profile URL | ## Notes - Only full Idealista `/inmueble/` URLs are accepted as `query`. - Feature labels and image room names follow the Idealista page locale. - `currency`, `advertiser_name`, and `advertiser_url` may be `null` on some listings. ## Main use cases - Enrich CRM records with full property specs and agency data - Analyze listing features, energy rating, and room layout from photos - Extract advertiser attribution for lead routing - Power comp tools with price, surface, and location data