Deprecated

Pricing

from $0.90 / 1,000 results

See alternative Actors

Go to Apify Store

Idealista Scraper — Spain, Portugal & Italy Real Estate

Deprecated

See alternative Actors

Scrape idealista.com — the top real estate portal in Spain, Portugal, and Italy with 1M+ sale and rental listings. Structured pricing, property details (rooms, area, floor), GPS coordinates, and incremental NEW/CHANGED/EXPIRED tracking.

Pricing

from $0.90 / 1,000 results

Rating

0.0

(0)

Developer

Black Falcon Data

Actor stats

Bookmarked

Total users

Monthly active users

6 days ago

Last modified

Categories

Real estate

Lead generation

Automation

You can access the Idealista Scraper — Spain, Portugal & Italy Real Estate 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 Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "lSpQNbGBlhbo9yLiB"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/blackfalcondata~idealista-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-blackfalcondata-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/blackfalcondata~idealista-scraper/runs": {
      "post": {
        "operationId": "runs-sync-blackfalcondata-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/blackfalcondata~idealista-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-blackfalcondata-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": {
          "location": {
            "title": "📍 Location",
            "type": "string",
            "description": "Location slug (e.g. \"madrid-madrid\", \"barcelona\", \"lisboa\", \"roma\"). Use JSON array for multiple locations."
          },
          "locationId": {
            "title": "Location ID",
            "type": "string",
            "description": "Idealista internal location ID (e.g. \"0-EU-ES-28-07-001-079\" for Madrid). Overrides location slug if provided."
          },
          "country": {
            "title": "🌍 Country",
            "enum": [
              "ES",
              "PT",
              "IT"
            ],
            "type": "string",
            "description": "Idealista market to search.",
            "default": "ES"
          },
          "operation": {
            "title": "Operation",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "Sale or rental listings.",
            "default": "sale"
          },
          "propertyType": {
            "title": "Property Type",
            "enum": [
              "homes",
              "offices",
              "premises",
              "garages",
              "bedrooms",
              "land"
            ],
            "type": "string",
            "description": "Type of property to search.",
            "default": "homes"
          },
          "maxResults": {
            "title": "💯 Max Results",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Maximum listings to return (0 = unlimited).",
            "default": 50
          },
          "maxPages": {
            "title": "Max Pages",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Maximum result pages per location (50 listings per page).",
            "default": 5
          },
          "minPrice": {
            "title": "Min Price (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum listing price filter."
          },
          "maxPrice": {
            "title": "Max Price (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum listing price filter."
          },
          "minRooms": {
            "title": "Min Rooms",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Minimum number of bedrooms."
          },
          "minSizeM2": {
            "title": "Min Size (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum floor area in square metres."
          },
          "maxSizeM2": {
            "title": "Max Size (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum floor area in square metres."
          },
          "distance": {
            "title": "Search radius (metres)",
            "minimum": 500,
            "maximum": 100000,
            "type": "integer",
            "description": "Radius in metres around the city centre when searching by location name (not used when locationId is provided). Default: 10000 (10 km).",
            "default": 10000
          },
          "descriptionMaxLength": {
            "title": "✂️ Description Max Length",
            "minimum": 0,
            "type": "integer",
            "description": "Truncate description to this many characters. 0 = no truncation.",
            "default": 0
          },
          "compact": {
            "title": "📦 Compact Output",
            "type": "boolean",
            "description": "Output only core fields (for AI-agent/MCP workflows).",
            "default": false
          },
          "incrementalMode": {
            "title": "♻️ Incremental Mode",
            "type": "boolean",
            "description": "Track new/changed/expired listings across runs. Requires stateKey.",
            "default": false
          },
          "stateKey": {
            "title": "🔑 State Key",
            "type": "string",
            "description": "Stable identifier for this tracking universe (e.g. \"es-madrid-sale-homes\")."
          },
          "emitUnchanged": {
            "title": "Emit Unchanged Records",
            "type": "boolean",
            "description": "When incremental, also emit listings that have not changed.",
            "default": false
          },
          "emitExpired": {
            "title": "Emit Expired Records",
            "type": "boolean",
            "description": "When incremental, also emit listings no longer found.",
            "default": false
          },
          "skipReposts": {
            "title": "🚫 Skip Reposts",
            "type": "boolean",
            "description": "When incremental, skip listings that are reposts of previously seen (now expired) listings.",
            "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 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 Real Estate 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 Real Estate API in Python

Idealista Scraper — Spain, Portugal & Italy Real Estate API in JavaScript

Idealista Scraper — Spain, Portugal & Italy Real Estate API through CLI

Idealista Scraper — Spain, Portugal & Italy Real Estate 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. Bypasses DataDome. Supports location search and direct URLs. MCP-ready.

Khadin Akbar

Idealista Scraper API - Spain, Italy & Portugal Real Estate

makework36/idealista-scraper

Scrape Idealista property listings (Spain, Italy, Portugal). Get price, location, size, rooms, description, photos. HTTP only, fast, pay per result.

deusex machine

Booking.com Scraper API - Hotels, Prices, Ratings & Rooms

makework36/fast-booking-scraper

Scrape Booking.com hotel listings, prices, ratings, reviews, and rooms by destination and dates. Fast Playwright extraction with residential proxy.

deusex machine

Idealista Scraper - Real Estate Data for Spain, Italy, Portugal

igolaizola/idealista-scraper

Extract real estate data from Spain, Italy, and Portugal on idealista.com, including pricing, property features, and contact information. Scrape listings for residential, office, and commercial properties available for sale or rent.

Iñigo Garcia Olaizola

1.5K

4.2

(20)

Idealista Api Actor

axlymxp/idealista-api-actor

Idealista API Scraper – Official API (never blocked). Spain, Italy & Portugal. Auto beachfronts (zoiId), agent phone search, full filters, GPS polygon, custom JS calculations, market stats. The strongest Idealista actor on Apify.

axly

Idealista Scraper

silentflow/idealista-scraper

Unlimited Idealista.com scraper. Extract rentals & sales from Spain, Portugal, Italy. 70+ fields: prices, agents, GPS, photos, price history. The richest output for real estate market research & lead generation. Built for agencies & investors who need predictable pricing at scale.

SilentFlow

Idealista Scraper Ppr

silentflow/idealista-scraper-ppr

Scrape Idealista.com properties across Spain, Portugal & Italy. 70+ data fields per listing: prices, GPS coordinates, agent contacts, amenities, price drops. Rentals & sales. $2/1K results. The richest output for real estate market research & lead generation.

SilentFlow

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

592

4.6

(13)

Smart Idealista Scraper

sian.agency/smart-idealista-scraper

🏠 Market's best price: $0.003/property + 33% bonus! Extract 1000+ listings in minutes instead of hours. Stop wasting hours copying Idealista properties manually! 64+filters, clean JSON/CSV. Zero technical skills needed. Real estate pros choose us! 🎯

SIÁN OÜ

370

5.0

(7)

Idealista | Only $1💰 | Spain | Italy | Portugal |

memo23/idealista-scraper

💰 $1 per 1,000 results. Extract comprehensive data: 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

302

5.0

(7)

Idealista Scraper

dz_omar/idealista-scraper

Extract unlimited property data from Idealista (Spain/Portugal/Italy). Bypasses 1,800-listing limit. Gets prices, specs, photos & contacts. Monthly $15 + API costs. One-day free trial.

FlowExtract API

244

5.0

(6)