Piloterr

Idealista Search

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

Credit cost: 2 credits per call

GET
/v2/idealista/search

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 link with 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://api.piloterr.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"
}