{ "openapi": "3.0.1", "info": { "title": "Idealista Scraper — Spain, Italy & Portugal Properties", "description": "Scrape idealista.com, .it and .pt listings — homes, rentals, offices, land. Price, price drops, €/m², rooms, floor, lift, agency, photos and optional full details. Splits big searches past the 1,800 cap. No login.", "version": "1.0", "x-build-id": "m5z0Kz3Su197MhF9h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~idealista-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-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/logiover~idealista-scraper/runs": { "post": { "operationId": "runs-sync-logiover-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/logiover~idealista-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-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": "Start URLs", "type": "array", "description": "idealista search result pages from idealista.com (Spain), idealista.it (Italy) or idealista.pt (Portugal) — open your search in a browser, apply any filters you like (price, rooms, size, lift…) and paste the address. Single listing URLs (/inmueble/…, /immobile/…, /imovel/…) also work and are returned with full details.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Country", "enum": [ "es", "it", "pt" ], "type": "string", "description": "Used only with Locations below.", "default": "es" }, "operation": { "title": "Operation", "enum": [ "sale", "rent" ], "type": "string", "description": "Used only with Locations.", "default": "sale" }, "propertyType": { "title": "Property type", "enum": [ "homes", "offices", "premises", "garages", "land", "storage", "buildings", "rooms", "newDevelopments" ], "type": "string", "description": "Used only with Locations. Not every type exists in every country; unsupported combinations are skipped with a warning.", "default": "homes" }, "locations": { "title": "Locations", "type": "array", "description": "Location slugs exactly as they appear in idealista URLs, e.g. madrid-madrid, barcelona-barcelona, valencia-valencia, malaga-malaga, madrid-provincia (Spain); milano-milano, roma-roma (Italy); lisboa, porto (Portugal). Districts work too: madrid/barrio-de-salamanca.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max listings", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Stop after this many unique listings across all searches. 0 = no limit.", "default": 1000 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 60, "type": "integer", "description": "idealista shows at most 60 pages × 30 listings per search. Lower this to sample the first pages of many searches.", "default": 60 }, "splitLargeSearches": { "title": "Go past the 1,800-listing cap", "type": "boolean", "description": "When a search reports more listings than 60 pages can show, replace it with its districts/neighbourhoods (idealista's own breadcrumb — their counts add up exactly to the total), recursively. Leaf areas still over the cap are walked again under other sort orders. Filters and sort order in your URL are kept.", "default": true }, "fetchDetails": { "title": "Fetch full listing details", "type": "boolean", "description": "Open every listing page for the full description, all feature bullets (bathrooms, built/usable area, condition, year built, heating, orientation), energy certificate, ad reference, last-updated date and every photo URL. One extra request per listing — slower and pricier on proxy, so leave off for large exports.", "default": false }, "concurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum requests in flight at once, including duplicate (hedged) requests. idealista pages take 3–60 s each through the unblocker, so the Actor asks for every page it needs at the same time and re-asks slow ones on a fresh session (cancelled duplicates are not billed by the unblocker). 50 lets a 1,000-listing run fire all of its pages at once.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "idealista is protected by DataDome and refuses ordinary datacenter and residential proxies (measured HTTP 403). The Actor uses Apify's UNBLOCKER group; keep it unless you have your own unblocking proxy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 } } } } } } } } } }