Pricing

from $0.40 / 1,000 listing scrapeds

Try for free

Go to Apify Store

Idealista Scraper — Spain, Portugal & Italy listings

Try for free

Scrape idealista.com, idealista.pt and idealista.it from any search URL: price, m², rooms, floor, agency, photos, full details and energy class. Anti-bot handled. Pay per listing.

Pricing

from $0.40 / 1,000 listing scrapeds

Rating

0.0

(0)

Developer

Amit Aviv

Actor stats

Bookmarked

Total users

Monthly active users

a day ago

Last modified

Categories

Real estate

Lead generation

Automation

You can access the Idealista Scraper — Spain, Portugal & Italy listings 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": "oWUyV0QbE829797QE"
  },
  "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/",
            "items": {
              "type": "string"
            }
          },
          "maxItemsPerSearch": {
            "title": "Max listings per search URL",
            "minimum": 1,
            "maximum": 1800,
            "type": "integer",
            "description": "Stop after this many listings for each search URL (30 per page). Idealista shows at most 60 pages (1,800 listings) per search; narrow the search with filters to get everything.",
            "default": 60
          },
          "fetchDetails": {
            "title": "Fetch full property details",
            "type": "boolean",
            "description": "Also open every property page to get the full description, all features (bathrooms, year built, heating, orientation, condition...), energy certificate, reference, advertiser and all photos. Charged as an extra 'detail' event per listing.",
            "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.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "debug": {
            "title": "Debug",
            "type": "boolean",
            "description": "Save blocked pages to the key-value store for troubleshooting.",
            "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Idealista Scraper — Spain, Portugal & Italy Property Data 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 — Spain, Portugal & Italy listings 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 — Spain, Portugal & Italy listings API in Python

Idealista Scraper — Spain, Portugal & Italy listings API in JavaScript

Idealista Scraper — Spain, Portugal & Italy listings API through CLI

Idealista Scraper — Spain, Portugal & Italy listings API

Idealista Scraper — Spain, Portugal & Italy Listings

scrape.badger/idealista-scraper

Scrape Idealista property listings in Spain, Portugal and Italy: search for sale or rent with price, size and room filters, break the 1,800-result cap with tiled search, and pull full property detail and engagement stats.

ScrapeBadger

Idealista Scraper 🔥 $0.4/1K - ES, IT & PT Real Estate API

azzouzana/idealista-scraper

Fast - From $0.4/1K 💰 Idealista real estate scraper (Spain, Italy, Portugal). Beats the 1.5K limit. Buy, rent, new homes, commercial, holidays & more => 90+ points: prices, features, GPS coordinates, photos, agent contacts & much more! Paste URL → JSON/Excel/API. AI-agents ready - Start now!

Azzouzana

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 | Spain, Italy & Portugal Property Data

webdata_labs/idealista-scraper

[$0.90 / 1K listings - no start fee] Scrape any Idealista search across Spain, Italy and Portugal: homes, rooms, garages, offices, premises, land, buildings, storage, for sale or rent. Price, m2, EUR/m2 vs market median, agency and price cuts per row, plus optional listing-page detail.

WebData Labs

Idealista Scraper - Spain, Italy & Portugal Property Listings

dami_studio/idealista-scraper

Scrape Idealista property listings in Spain, Italy and Portugal. Each row has the price, size in m2, rooms, floor, address and neighbourhood. You also get photos and the link. The seller type is shown: agency or private. Paste a search URL, or use filters. No account, no API key, no proxy setup.

Dami's Studio

LoopNet Scraper — CRE Listings, Prices & Details

khadinakbar/loopnet-scraper

Extract LoopNet commercial real estate listings from locations, search URLs, or property pages. Returns canonical URLs, prices, property types, sizes, addresses, provenance, and optional building and broker details.

Khadin Akbar

Idealista $1💰 Search By URLs and Keywords

abotapi/idealista-scraper

From $1/1K. Extract property listings from Idealista Spain, Italy, and Portugal. Get prices, sizes, rooms, coordinates, advertiser details, phone numbers, descriptions, photos, and 35+ fields per listing. Supports buy, rent, and rooms via filters or direct Idealista URLs. Blazing fast, reliable.

Abot API

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.

Khadin Akbar

142

🏠 Idealista Scraper

scraper-engine/idealista-scraper

🏠 Idealista Scraper (idealista-scraper) extracts listings & key property details from Idealista—price, location, size, features & more. 🚀 Fast, reliable data for real estate analytics, lead gen, and market research.

Scraper Engine

Idealista Scraper: Spain, Italy & Portugal Real Estate

dltik/idealista-scraper

Scrape Idealista property listings (buy & rent) in Spain, Italy and Portugal: price, €/m², surface, bedrooms, floor, type, city, agency, tags and description. Passes DataDome with a stealth browser on a residential IP. Filter by location, transaction and price.