Idealista Scraper

ENDPOINTS
GET/locations/search

Search Locations

Get idealista's own location suggestions for a place name or postcode: slug, ID, type and listing count.

QUERY PARAMS

Place name or postcode, full or partial.

Examples: Ibiza, Chamberí, 28013

Market to search: es is idealista.com (Spain), it is idealista.it (Italy). An idealista URL passed in another parameter sets the market by itself.

Default: es

Allowed values: es, it

Buy or rent.

Default: sale

Allowed values: sale, rent

Type of property. rooms is rent only; new_developments and transfers are sale only.

Default: homes

Allowed values: homes, rooms, new_developments, offices, premises, transfers, garages, lands, storage_rooms, buildings

Language of titles, features and descriptions (idealista translates the descriptions).

Default: en

Allowed values: en, fr, de, it, pt, nl, ru

{
  "query": "Ibiza",
  "country": "es",
  "count": 10,
  "results": [
    {
      "name": "Ibiza, Balearic Islands",
      "id": "0-EU-ES-07-02",
      "slug": "balears-illes/ibiza",
      "link": "https://www.idealista.com/venta-viviendas/balears-illes/ibiza/",
      "type": "County",
      "parent_id": "0-EU-ES-07",
      "listings_count": 2628,
      "has_child_zones": true,
      "is_zone_of_interest": false,
      "is_postcode": false
    },
    {
      "name": "Ibiza, Madrid",
      "id": "0-EU-ES-28-07-001-079-03-004",
      "slug": "madrid/retiro/ibiza",
      "link": "https://www.idealista.com/venta-viviendas/madrid/retiro/ibiza/",
      "type": "Neighbourhood",
      "parent_id": "0-EU-ES-28-07-001-079-03",
      "listings_count": 332,
      "has_child_zones": false,
      "is_zone_of_interest": false,
      "is_postcode": false
    },
    {
      "name": "Eivissa, Balearic Islands",
      "id": "0-EU-ES-07-02-004-026",
      "slug": "eivissa-balears-illes",
      "link": "https://www.idealista.com/venta-viviendas/eivissa-balears-illes/",
      "type": "Municipality",
      "parent_id": "0-EU-ES-07-02",
      "listings_count": 736,
      "has_child_zones": true,
      "is_zone_of_interest": false,
      "is_postcode": false
    },
    {
      "name": "Ibiza - San Pedro, Villanueva del Pardillo",
      "id": "0-EU-ES-28-02-016-177-02",
      "slug": "villanueva-del-pardillo/ibiza-san-pedro",
      "link": "https://www.idealista.com/venta-viviendas/villanueva-del-pardillo/ibiza-san-pedro/",
      "type": "District",
      "parent_id": "0-EU-ES-28-02-016-177",
      "listings_count": 30,
      "has_child_zones": false,
      "is_zone_of_interest": false,
      "is_postcode": false
    },
    {
      "name": "Dalt Sant Joan-Plaça Eivissa, Maó/Mahón",
      "id": "0-EU-ES-07-03-001-032-01-002",
      "slug": "maomahon/mao/dalt-sant-joan-placa-eivissa",
      "link": "https://www.idealista.com/venta-viviendas/maomahon/mao/dalt-sant-joan-placa-eivissa/",
      "type": "Neighbourhood",
      "parent_id": "0-EU-ES-07-03-001-032-01",
      "listings_count": 15,
      "has_child_zones": false,
      "is_zone_of_interest": false,
      "is_postcode": false
    },
    {
      "name": "Marina Botafoc - Talamanca, Eivissa",
      "id": "0-EU-ES-07-02-004-026-04",
      "slug": "eivissa/marina-botafoc-talamanca",
      "link": "https://www.idealista.com/venta-viviendas/eivissa/marina-botafoc-talamanca/",
      "type": "District",
      "parent_id": "0-EU-ES-07-02-004-026",
      "listings_count": 284,
      "has_child_zones": false,
      "is_zone_of_interest": false,
      "is_postcode": false
    },
    {
      "name": "Dalt Vila - La Marina, Eivissa",
      "id": "0-EU-ES-07-02-004-026-01",
      "slug": "eivissa/dalt-vila-la-marina",
      "link": "https://www.idealista.com/venta-viviendas/eivissa/dalt-vila-la-marina/",
      "type": "District",
      "parent_id": "0-EU-ES-07-02-004-026",
      "listings_count": 142,
      "has_child_zones": false,
      "is_zone_of_interest": false,
      "is_postcode": false
    },
    {
      "name": "Figueretes - Platja d'En Bossa, Eivissa",
      "id": "0-EU-ES-07-02-004-026-03",
      "slug": "eivissa/figueretes-platja-d-en-bossa",
      "link": "https://www.idealista.com/venta-viviendas/eivissa/figueretes-platja-d-en-bossa/",
      "type": "District",
      "parent_id": "0-EU-ES-07-02-004-026",
      "listings_count": 154,
      "has_child_zones": false,
      "is_zone_of_interest": false,
      "is_postcode": false
    },
    {
      "name": "Centro - S'Eixample - Can Misses, Eivissa",
      "id": "0-EU-ES-07-02-004-026-02",
      "slug": "eivissa/centro-s-eixample-can-misses",
      "link": "https://www.idealista.com/venta-viviendas/eivissa/centro-s-eixample-can-misses/",
      "type": "District",
      "parent_id": "0-EU-ES-07-02-004-026",
      "listings_count": 132,
      "has_child_zones": false,
      "is_zone_of_interest": false,
      "is_postcode": false
    },
    {
      "name": "Los Molinos, Eivissa",
      "id": "0-EU-ES-07-02-004-026-05",
      "slug": "eivissa/los-molinos",
      "link": "https://www.idealista.com/venta-viviendas/eivissa/los-molinos/",
      "type": "District",
      "parent_id": "0-EU-ES-07-02-004-026",
      "listings_count": 24,
      "has_child_zones": false,
      "is_zone_of_interest": false,
      "is_postcode": false
    }
  ]
}