Pricing

from $0.70 / 1,000 property scrapeds

Idealista Scraper API — Properties, Prices & Agency Contacts

Idealista scraper and unofficial Idealista API: extract property listings from Spain, Italy and Portugal — for sale and rent. Get prices, €/m², size, rooms, photos, energy rating, GPS and agency contacts by URL or filters. Export JSON, CSV, Excel. From $0.70/1k, no login or API key.

Pricing

from $0.70 / 1,000 property scrapeds

Rating

0.0

(0)

Developer

Raven

Actor stats

Bookmarked

Total users

Monthly active users

4 days ago

Last modified

Categories

Real estate

Automation

Developer tools

You can access the Idealista Scraper API — Properties, Prices & Agency Contacts 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": "1.0",
    "x-build-id": "H4tiT9MpkCfT1Pabv"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/pro100chok~idealista-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-pro100chok-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/pro100chok~idealista-scraper/runs": {
      "post": {
        "operationId": "runs-sync-pro100chok-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/pro100chok~idealista-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-pro100chok-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": {
          "startUrls": {
            "title": "Idealista URLs",
            "type": "array",
            "description": "Paste any Idealista URLs — search result pages, single property pages (/inmueble/, /immobile/, /imovel/), or agency pages (/pro/...). The type of each URL is detected automatically. This is the most reliable way to control exactly what is scraped: set your filters on idealista.com and paste the resulting URL. Works for idealista.com (Spain), idealista.it (Italy) and idealista.pt (Portugal).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Build a search without a URL: the location slug exactly as it appears in an Idealista URL, e.g. 'madrid-madrid', 'barcelona-barcelona', or a neighbourhood path like 'madrid/chamartin'. Combined with the fields below. Leave empty if you use 'Idealista URLs' above."
          },
          "country": {
            "title": "Country",
            "enum": [
              "es",
              "it",
              "pt"
            ],
            "type": "string",
            "description": "Idealista country/site to use when building a search from filters.",
            "default": "es"
          },
          "operation": {
            "title": "Operation",
            "enum": [
              "sale",
              "rent"
            ],
            "type": "string",
            "description": "Buy or rent.",
            "default": "sale"
          },
          "propertyType": {
            "title": "Property type",
            "enum": [
              "homes",
              "newDevelopments",
              "offices",
              "premises",
              "garages",
              "lands",
              "storageRooms",
              "buildings",
              "rooms"
            ],
            "type": "string",
            "description": "Type of property to search for.",
            "default": "homes"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "mostRecent",
              "leastRecent",
              "lowestPrice",
              "highestPrice",
              "biggest",
              "smallest",
              "highestPriceReduction"
            ],
            "type": "string",
            "description": "Ordering of the search results.",
            "default": "relevance"
          },
          "minPrice": {
            "title": "Min price (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum price in euros."
          },
          "maxPrice": {
            "title": "Max price (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum price in euros."
          },
          "minSize": {
            "title": "Min size (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum built size in m²."
          },
          "maxSize": {
            "title": "Max size (m²)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum built size in m²."
          },
          "bedrooms": {
            "title": "Bedrooms",
            "type": "array",
            "description": "Number of bedrooms (multiple allowed).",
            "items": {
              "type": "string",
              "enum": [
                "studio",
                "1",
                "2",
                "3",
                "4"
              ],
              "enumTitles": [
                "Studio",
                "1",
                "2",
                "3",
                "4+"
              ]
            }
          },
          "homeType": {
            "title": "Home type",
            "type": "array",
            "description": "Filter by home sub-type (multiple allowed).",
            "items": {
              "type": "string",
              "enum": [
                "flat",
                "penthouse",
                "duplex",
                "detachedHouse",
                "countryHouse",
                "studio"
              ],
              "enumTitles": [
                "Flat",
                "Penthouse",
                "Duplex",
                "Detached house / chalet",
                "Country house",
                "Studio"
              ]
            }
          },
          "condition": {
            "title": "Condition",
            "type": "array",
            "description": "Filter by property condition (multiple allowed).",
            "items": {
              "type": "string",
              "enum": [
                "newDevelopment",
                "good",
                "renew"
              ],
              "enumTitles": [
                "New development",
                "Good condition / second hand",
                "To renovate"
              ]
            }
          },
          "floor": {
            "title": "Floor",
            "type": "array",
            "description": "Filter by floor level (multiple allowed).",
            "items": {
              "type": "string",
              "enum": [
                "topFloor",
                "intermediateFloor",
                "groundFloor"
              ],
              "enumTitles": [
                "Top floor",
                "Intermediate floor",
                "Ground floor"
              ]
            }
          },
          "amenities": {
            "title": "Amenities",
            "type": "array",
            "description": "Filter by amenities (multiple allowed).",
            "items": {
              "type": "string",
              "enum": [
                "airConditioning",
                "lift",
                "terrace",
                "garage",
                "garden",
                "swimmingPool",
                "storageRoom",
                "fittedWardrobes",
                "exterior",
                "luxury",
                "accessible",
                "seaViews"
              ],
              "enumTitles": [
                "Air conditioning",
                "Lift",
                "Terrace",
                "Garage",
                "Garden",
                "Swimming pool",
                "Storage room",
                "Fitted wardrobes",
                "Exterior",
                "Luxury",
                "Accessible",
                "Sea views"
              ]
            }
          },
          "publicationDate": {
            "title": "Published within",
            "enum": [
              "",
              "24h",
              "48h",
              "week",
              "month"
            ],
            "type": "string",
            "description": "Only include listings published within this period.",
            "default": ""
          },
          "propertyCodes": {
            "title": "Property codes",
            "type": "array",
            "description": "Scrape specific properties by their Idealista code (the number in /inmueble/<code>/). Uses the Country selected above.",
            "items": {
              "type": "string"
            }
          },
          "agencySlugs": {
            "title": "Agency slugs",
            "type": "array",
            "description": "Scrape agency / professional profiles by slug (the part after /pro/ in the URL, e.g. 'gilmar-centro'). Uses the Country selected above.",
            "items": {
              "type": "string"
            }
          },
          "fetchDetails": {
            "title": "Scrape full detail for each result",
            "type": "boolean",
            "description": "For every search result, also open its property page to get the full description, all features, energy certificate, full photo gallery and coordinates. Slower and costs more requests.",
            "default": true
          },
          "fetchContacts": {
            "title": "Fetch advertiser / agency details",
            "type": "boolean",
            "description": "On detail pages, fetch the advertiser block (name, logo, microsite, agency id, reference). Reliable and recommended.",
            "default": true
          },
          "fetchPhones": {
            "title": "Reveal phone numbers",
            "type": "boolean",
            "description": "Reveal the advertiser's phone number for each property (returned as contactInfo.phone). Adds a few extra requests per property. Not every listing publishes a phone.",
            "default": true
          },
          "scrapeAgencies": {
            "title": "Output agencies instead of properties",
            "type": "boolean",
            "description": "For search URLs, return one row per unique agency/advertiser found (with profile details) instead of the properties.",
            "default": false
          },
          "monitoringMode": {
            "title": "Monitoring mode (only new listings)",
            "type": "boolean",
            "description": "Only output listings not seen in previous runs of this Actor (tracked by property code). Great for daily alerts.",
            "default": false
          },
          "splitByPrice": {
            "title": "Bypass the ~1,800 result limit",
            "type": "boolean",
            "description": "Idealista limits a single search to ~1,800 results. Enable this to automatically split the search into price bands and collect far more results (deduplicated).",
            "default": true
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of records to output (0 = no limit).",
            "default": 10
          },
          "endPage": {
            "title": "Max pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Stop each search after this many result pages (0 = until the last page). ~30 results per page.",
            "default": 0
          },
          "maxConcurrency": {
            "title": "Concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many properties/pages to process in parallel. Each parallel worker uses its own proxy IP. Higher = faster but more proxy traffic.",
            "default": 5
          },
          "maxRetries": {
            "title": "Max retries per request",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many times to rotate the proxy IP and retry when a request is blocked.",
            "default": 8
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Proxy used for scraping. Residential proxies are strongly recommended and the egress country is matched to the site automatically (Spain for .com, Italy for .it, Portugal for .pt).",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "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 API — Properties, Prices & Agency Contacts 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 API — Properties, Prices & Agency Contacts 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 API — Properties, Prices & Agency Contacts API in Python

Idealista Scraper API — Properties, Prices & Agency Contacts API in JavaScript

Idealista Scraper API — Properties, Prices & Agency Contacts API through CLI

Idealista Scraper API — Properties, Prices & Agency Contacts API

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 Property Scraper

xtracto/idealista-property-scraper

Collect property listings from Idealista (Spain, Italy, Portugal) — price, location, rooms, size, floor, description, and listing agency — from any search URL. For sale or rent.

Farhan Febrian Nauval

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

134

Idealista Scraper

crawlerbros/idealista-scraper

Scrape real estate listings from Idealista.com. Extract property prices, locations, features, photos, and agent contacts for Spain, Italy, and Portugal.

Crawler Bros

105

1.0

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

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

273

4.9

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

Idealista

happyendpoint/idealista-scraper-by-url

Scraped Idealista Listing by URL. 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.

Happy Endpoint

5.0

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 Property Data

benthepythondev/idealista-scraper

Scrape Idealista (Spain's #1 property portal), for sale or to rent: price, rooms, area (m2), floor, location, agency/agent, image and listing URL. Search by location name or paste an Idealista URL.