Pricing

from $0.40 / 1,000 listing scrapeds

Try for free

Go to Apify Store

Idealista Scraper - Any URL, Spain Portugal Italy

Try for free

Scrape Idealista property listings in Spain (idealista.com), Portugal (idealista.pt) and Italy (idealista.it) from any search URL, filters and sort order respected. Price, price drops, size, rooms, floor, agency, photos, description, energy class, coordinates. From $0.40 per 1,000. JSON, CSV, API.

Pricing

from $0.40 / 1,000 listing scrapeds

Rating

0.0

(0)

Developer

Amit Aviv

Actor stats

Bookmarked

Total users

Monthly active users

3 days ago

Last modified

Categories

Real estate

Automation

You can access the Idealista Scraper - Any URL, Spain Portugal Italy programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "gssXE4LK6x7MOevgu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/amitaviv~idealista-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-amitaviv-idealista-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/amitaviv~idealista-scraper/runs": {
      "post": {
        "operationId": "runs-sync-amitaviv-idealista-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/amitaviv~idealista-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-amitaviv-idealista-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchUrls": {
            "title": "Idealista search URLs",
            "type": "array",
            "description": "Paste one or more idealista search result URLs from idealista.com (Spain), idealista.pt (Portugal) or idealista.it (Italy), with any filters and sort order. Examples: https://www.idealista.com/venta-viviendas/madrid-madrid/con-precio-hasta_300000/ or https://www.idealista.pt/arrendar-casas/lisboa/. URLs without https:// or www, mobile (m.idealista...) links and translated pages (/en/...) are accepted. A URL that points at a later results page (pagina-3, lista-3) is collected from that page onwards. Property URLs pasted here are scraped as properties. Required unless \"Individual property URLs\" is given.",
            "items": {
              "type": "string"
            }
          },
          "maxItemsPerSearch": {
            "title": "Max listings per search URL",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum number of listings to return for each search URL (30 per results page), e.g. 300; default 60. Each listing is one record and one charged 'listing' event. Idealista shows at most 60 pages (1,800 listings) per search. Set a higher number to get more: the search is then split into price bands automatically (see 'Split searches with more than 1,800 results').",
            "default": 60
          },
          "fetchDetails": {
            "title": "Fetch full property details",
            "type": "boolean",
            "description": "Default off. Also open every property page to get the full description, all features (bathrooms, year built, heating, orientation, condition...), energy certificate, map coordinates, reference, advertiser and all photos. Charged as an extra 'detail' event per listing. Takes about 2 seconds per listing: 1,000 listings with details need a run timeout of at least 45 minutes.",
            "default": false
          },
          "propertyUrls": {
            "title": "Individual property URLs (optional)",
            "type": "array",
            "description": "Scrape specific properties by URL, e.g. https://www.idealista.com/inmueble/112367425/ — always returns full details ('listing' + 'detail' events). URLs that are no longer online are skipped and named in the run's status message; they are not charged.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "splitLargeSearches": {
            "title": "Split searches with more than 1,800 results",
            "type": "boolean",
            "description": "Only matters when 'Max listings per search URL' is above 1,800. A search with more results than idealista shows is then read as several price bands (lowest prices first), each small enough to be shown in full, and every listing is saved once. The status message and OUTPUT_SUMMARY say how many price bands were read and whether all were read to the end. Within a split search the sort order of your URL is not kept. Turn off to get the first 1,800 listings in the order of your URL.",
            "default": true
          },
          "includePrivateSellerData": {
            "title": "Include names of private advertisers",
            "type": "boolean",
            "description": "By default, detailed records of listings published by private individuals (not agencies) have 'advertiserName' and 'advertiserUrl' set to null and carry 'privateDataRedacted': true. Turn this on only if you need the names: by doing so you confirm that you have a lawful basis under the GDPR for processing personal data of private individuals. Agencies and other professional advertisers are always returned in full.",
            "default": false
          },
          "debug": {
            "title": "Debug",
            "type": "boolean",
            "description": "Default off; not needed for normal use. Save blocked pages and the first results page / property page to the key-value store as raw HTML, and log more, for troubleshooting. A private advertiser's property page is not saved unless 'Include names of private advertisers' is on.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Idealista Scraper API - Spain, Portugal & Italy OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Idealista Scraper - Any URL, Spain Portugal Italy from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Idealista Scraper - Any URL, Spain Portugal Italy API in Python

Idealista Scraper - Any URL, Spain Portugal Italy API in JavaScript

Idealista Scraper - Any URL, Spain Portugal Italy API through CLI

Idealista Scraper - Any URL, Spain Portugal Italy API

Smart Idealista Scraper - Spain, Italy, Portugal Properties

sian.agency/smart-idealista-scraper

Idealista scraper and property data API for Spain, Italy and Portugal. Search sale and rental homes, new builds, rooms, garages, offices, land and commercial units by city, search URL, map polygon or CSV; return price, size, rooms, energy rating, year built and price history.

SIÁN OÜ

699

4.4

(9)

Idealista Scraper: Extract Rent & Sale Listings

burbn/idealista-scraper

Powerful Idealista scraper for professional real estate data. Extract listings from IT, ES, and PT with 40+ filters. Get GPS coordinates, full descriptions, and media. Perfect for investors, developers, and data scientists.

Kevin

5.0

(1)

Idealista Scraper API - Properties & Agency Leads

trakk/idealista-scraper

124 fields per listing across Spain, Italy and Portugal. Advertiser phones on 93% of cards, agency emails with the public page they came from, GPS, floor plans and price per m2. Reads past Idealista's 1,500-result ceiling, and every run reports what Idealista claimed against what you got.

Kelopr_bk

Idealista Scraper API

dz_omar/idealista-scraper-api

💰 $0.5 per 1,000 results. Scrape Idealista properties & listings from Spain (.com), Portugal (.pt) & Italy (.it). Supports property URLs + search/listing URLs. Fast mobile API extraction with real-time NDJSON streaming. Standby mode for instant responses.

FlowExtract API

1.4K

4.9

(19)

Idealista Scraper

hotels-scrapers/idealista-scraper

Scrape Idealista real estate listings across Spain, Italy & Portugal. Extract price, GPS, energy rating, rooms, agency contact. DataDome bypass included.

Hotels Scraper

5.0

(1)

Idealista | Spain |Italy| Portugal | Richest Output | PPE V2

memo23/idealista-scraper-rental

Extract comprehensive property data from Idealista.com: prices, locations, images, agent contacts, property features (rooms, bathrooms, amenities), detailed descriptions in multiple languages, and market insights. Perfect for real estate analysis, investment research, and market monitoring across EU

Muhamed Didovic

5.0

(2)

Idealista Scraper API — Spain, Italy & Leads

pro100chok/idealista-scraper

Idealista scraper and unofficial Idealista API for Spain, Italy and Portugal — homes, offices, garages, land, sale or rent. 60+ fields per listing: price, €/m², size, rooms, amenities, energy rating, GPS + province/city/district, photos, plans, videos, 3D tours, agency contacts. From $0.70/1k.

Raven

Idealista Scraper

axlymxp/idealista-scraper

Scrape Idealista property listings across Spain, Italy, and Portugal. Search any location, filter by operation (sale/rent) and property type, and export full data — price, size, rooms, address, GPS coordinates, images, and agency contact. Pay only for the results you get.

axly

287

4.9

(2)

Idealista Scraper — Block-Resistant (ES, PT, IT)

viralanalyzer/idealista-es-pt

Scrape real estate listings from Idealista Spain, Portugal and Italy.

viralanalyzer

5.0

(1)

Idealista Scraper — Spain, Italy & Portugal Real Estate

khadinakbar/idealista-scraper

Scrape property listings from Idealista.com, Idealista.it, and Idealista.pt. Get prices, GPS, agent contacts, amenities, energy ratings, and 28+ fields. MCP/API-ready.