Idealista Search
Search Idealista listings from a search URL and retrieve prices, specs, photos, agency info, and pagination.
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 search results URL.
Example 1 (neighborhood search):
https://www.idealista.com/venta-viviendas/barcelona/ciutat-vella/la-barceloneta/Example 2 (city search):
https://www.idealista.com/venta-viviendas/madrid-madrid/Notes:
- Only Idealista search URLs are accepted.
- Pagination parameters in the URL are respected.
- Use each result's
linkwith the Idealista Property endpoint for full listing data.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/idealista/search?query=string"{ "results": [ { "link": "https://www.idealista.com/fr/inmueble/111463799/", "price": 1650000, "title": "Appartement - Calle de Guzmán el Bueno, Gaztambide, Madrid", "details": [ "4 ch.", "190 m²", "4ème étage logement sur rue avec ascenseur" ], "picture": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/e7/b4/e6/1437388651.jpg", "currency": "€", "description": "Appartement de Luxe à Chamberí - Madrid | 190 m² | 4 ChambresDé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 qu", "listing_company": "Hills Properties", "parking_included": false, "listing_company_url": "https://www.idealista.com/fr/pro/hillspropertiesbcn/" }, { "link": "https://www.idealista.com/fr/inmueble/109948217/", "price": 968000, "title": "Appartement - Calle de Gaztambide, 39, Gaztambide, Madrid", "details": [ "3 ch.", "126 m²", "1er étage logement sur rue avec ascenseur" ], "picture": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/a9/12/99/1391364999.jpg", "currency": "€", "description": "Découvrez votre nouveau chez-vous au cœur du quartier de Gaztambide! Ce spectaculaire appartement, entièrement rénové et neuf, dispose de 126 m² construits qui offrent une ambiance lumineuse et accueillante. Avec 3 chambres et 2 salles de bain (dont une en suite), cet espace est idéal pour les familles ou pour ceux qui", "listing_company": "Gilmar Chamberi - Argüelles", "parking_included": false, "listing_company_url": "https://www.idealista.com/fr/pro/gilmarchamberi/" }, { "link": "https://www.idealista.com/fr/inmueble/109948315/", "price": 1795000, "title": "Penthouse - Calle de Fernando el Católico, Gaztambide, Madrid", "details": [ "4 ch.", "230 m²", "6ème étage logement sur rue avec ascenseur" ], "picture": "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/b5/00/c4/1391354207.jpg", "currency": "€", "description": "Découvrez ce spectaculaire penthouse situé dans le quartier prisé de Gaztambide, dans le district de Chamberí, à Madrid. Une propriété qui combine élégance, espace et possibilités infinies dans l'un des quartiers les plus exclusifs de la capitale. Avec une superficie construite de 230 m² et une impressionnante terrasse", "listing_company": "Gilmar Chamberi - Argüelles", "parking_included": false, "listing_company_url": "https://www.idealista.com/fr/pro/gilmarchamberi/" } ], "pagination": { "next": 2, "current": 1, "other_pages": [ 2, 3, 4, 5, 6 ], "total_pages": 6, "has_next_page": true }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}