Pricing

from $0.96 / 1,000 property listings

Idealista Scraper — Spain Real Estate Listings, Prices, m²

Scrape idealista.com (Spain #1 real estate portal) listings by location and operation. Returns title, price, size m², rooms, floor, location, agency, images, listing URL. Supports ES/IT/PT. Pay per result.

Pricing

from $0.96 / 1,000 property listings

Rating

0.0

(0)

Developer

Vitalii Bondarev

Actor stats

Bookmarked

Total users

Monthly active users

a day ago

Last modified

Categories

Real estate

Business

You can access the Idealista Scraper — Spain Real Estate Listings, Prices, m² 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": "DgempH91xTycGkIDF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/bovi~idealista-properties-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-bovi-idealista-properties-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/bovi~idealista-properties-scraper/runs": {
      "post": {
        "operationId": "runs-sync-bovi-idealista-properties-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/bovi~idealista-properties-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-bovi-idealista-properties-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": {
          "searchUrl": {
            "title": "Search URL (recommended)",
            "type": "string",
            "description": "Paste a complete idealista.com search URL from your browser (e.g. 'https://www.idealista.com/venta-viviendas/madrid-provincia/'). This is the most reliable way to apply filters — set them on idealista.com, copy the URL, paste here. Supports ES (idealista.com), IT (idealista.it), PT (idealista.pt). When set, overrides locationSlug + operation below."
          },
          "locationSlug": {
            "title": "Location slug",
            "type": "string",
            "description": "Location slug as it appears in idealista URLs, e.g. 'madrid-provincia', 'barcelona-provincia', 'valencia-provincia', 'sevilla-provincia'. Open a search on idealista.com, pick a location, copy the slug between /venta-viviendas/ and the trailing /. Leave blank if using Search URL above."
          },
          "operation": {
            "title": "Operation",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "Whether to search for sale (venta) or rental (alquiler) listings.",
            "default": "sale"
          },
          "propertyType": {
            "title": "Property type",
            "enum": [
              "viviendas",
              "oficinas",
              "locales",
              "garajes",
              "trasteros",
              "terrenos",
              "edificios"
            ],
            "type": "string",
            "description": "Type of property to search. 'Homes' (viviendas) covers apartments, houses, etc. Other types use their own idealista URL segment.",
            "default": "viviendas"
          },
          "priceMin": {
            "title": "Min price (client-side filter)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return listings priced at or above this amount. Applied locally after fetching — does not change the idealista URL. Leave blank for no lower bound."
          },
          "priceMax": {
            "title": "Max price (client-side filter)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return listings priced at or below this amount. Applied locally after fetching. Leave blank for no upper bound."
          },
          "minRooms": {
            "title": "Min rooms (client-side filter)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return listings with at least this many rooms/bedrooms. Applied locally. Leave blank for no minimum."
          },
          "maxItems": {
            "title": "Max listings to scrape",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of listings to return across all pages (before client-side filters). Set to 0 for all available results. Default 100.",
            "default": 100
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "REQUIRED. Idealista requires a residential proxy for reliable access — datacenter IPs are not reliable. Use Apify Residential proxy with country ES (Spain) for the best pass rate. No external proxy account needed.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "ES"
            }
          }
        }
      },
      "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 Property Listings, Prices, m² 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 Real Estate Listings, Prices, m² 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 Real Estate Listings, Prices, m² API in Python

Idealista Scraper — Spain Real Estate Listings, Prices, m² API in JavaScript

Idealista Scraper — Spain Real Estate Listings, Prices, m² API through CLI

Idealista Scraper — Spain Real Estate Listings, Prices, m² API

Idealista Scraper — Spain, Portugal & Italy Real Estate

rastriq/idealista-scraper

Scrape real estate listings from Idealista.com, the leading property portal in Spain, Portugal, and Italy. Extract price, location, size, rooms, floor, amenities, agency info, and photos for sale and rental properties. Essential for real estate market analysis in Southern Europe.

Rastriq — Structured data from the world

Fotocasa Property [$0.99] Scraper · Spain Real Estate Listings

memo23/fotocasa-scraper

[Only $0.99 per 1000 results] Scrape Fotocasa.es property listings — any buy/rent search URL with filters. Returns price, €/m², type, rooms, bathrooms, m², full address, coordinates, photos, agency, energy certificate (optional) and more as clean JSON/CSV. One row per property. No browser

Muhamed Didovic

Idealista Scraper - Spain, Portugal & Italy Real Estate

studio-amba/idealista-scraper

Scrape real estate listings from Idealista.com (Spain), Idealista.pt (Portugal), and Idealista.it (Italy). Get prices, addresses, property details, photos, energy certificates, and agent contacts for properties for sale or rent. No login or cookies required.

Studio Amba

Idealista Scraper

brilliant_gum/idealista-scraper

Scrape Idealista real estate listings across Spain, Portugal & Italy. Get 70+ fields per property: price, photos, contacts, energy rating, and price/m² analytics. Filter by location, price, size, features, and more. No account needed.

Yuliia Kulakova

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 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.

Khadin Akbar

116

Idealista Scraper

parseforge/idealista-scraper

Scrape property listings from Idealista, extracting data such as prices, property specifications, and agent details directly from the platform. The scraper collects structured information from Spain's largest real estate website, where thousands of properties are listed for sale and rent.

ParseForge

Otodom Scraper · Polish Property Listings & Agents · $2/1k

memo23/otodom-scraper

Scrape otodom.pl Polish property listings — sale or rent search (with any filters) and individual offers. Returns address, rooms, m², price, price/m², geo-coordinates, agency contacts (with phone numbers) and photos in clean JSON/CSV. Pure HTTP, no browser

Muhamed Didovic