Piloterr

Idealista Search

GET
/v2/idealista/search

Search Idealista listings from a search URL and retrieve prices, specs, photos, agency info, and pagination.

Credit cost: 2 credits per call

Autorização

ApiKeyAuth
x-api-key<token>

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

In: header

Parâmetros de consulta

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 link with the Idealista Property endpoint for full listing data.

Corpo da resposta

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"}