{ "openapi": "3.0.1", "info": { "title": "Idealista Scraper — Spain, Portugal & Italy Property Listings", "description": "Scrape Idealista property listings for sale and rent in Spain, Portugal and Italy: price, €/m², size, rooms, floor, agency, photos, coordinates, energy rating.", "version": "0.1", "x-build-id": "rj2vQEpre6QE4KRzi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tortuga~idealista-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tortuga-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/tortuga~idealista-scraper/runs": { "post": { "operationId": "runs-sync-tortuga-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/tortuga~idealista-scraper/run-sync": { "post": { "operationId": "run-sync-tortuga-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 pages from idealista.com (Spain), idealista.pt (Portugal) or idealista.it (Italy), with any filters and sort order applied in the browser, e.g. https://www.idealista.com/venta-viviendas/madrid-madrid/ or https://www.idealista.pt/arrendar-casas/lisboa/. Homes, offices, garages, land and other search types work the same way. A single listing URL (…/inmueble/123/, …/imovel/123/, …/immobile/123/) returns that listing with full details. Leave empty if you use Locations instead.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "locations": { "title": "Locations", "type": "array", "description": "Alternative to Start URLs: location slugs exactly as they appear in Idealista URLs, e.g. \"madrid-madrid\", \"barcelona-barcelona\", \"malaga-malaga\", \"lisboa\", \"porto\", \"milano-milano\", \"roma-roma\", or a district such as \"madrid/centro\". Searches homes in the country and for the operation chosen below, with the filters below.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "es", "pt", "it" ], "type": "string", "description": "Used with Locations: which Idealista site to search.", "default": "es" }, "operation": { "title": "For sale or to rent", "enum": [ "sale", "rent" ], "type": "string", "description": "Used with Locations.", "default": "sale" }, "minPrice": { "title": "Min price (EUR)", "minimum": 0, "type": "integer", "description": "Used with Locations. Sale price, or monthly rent for rentals." }, "maxPrice": { "title": "Max price (EUR)", "minimum": 0, "type": "integer", "description": "Used with Locations. Sale price, or monthly rent for rentals." }, "minSize": { "title": "Min size (m²)", "minimum": 0, "type": "integer", "description": "Used with Locations." }, "maxSize": { "title": "Max size (m²)", "minimum": 0, "type": "integer", "description": "Used with Locations." }, "sort": { "title": "Sort by", "enum": [ "", "newest", "oldest", "price_asc", "price_desc", "price_per_sqm_asc", "price_per_sqm_desc", "size_desc", "size_asc", "biggest_price_drop" ], "type": "string", "description": "Used with Locations. Default is Idealista's relevance order (paid 'Top' listings first). 'Newest' sorts by publication date (by last update on idealista.pt).", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many listings in total (across all searches). Keeps cost predictable. Idealista shows 30 listings per page.", "default": 100 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Stop each search after this many result pages (30 listings each). Use filters or several locations to get more results.", "default": 10 }, "includeDetails": { "title": "Include listing details", "type": "boolean", "description": "Also open every listing page to get the full description, all photos and floor plans, bathrooms, year built, full feature list, energy rating and consumption, last-update date, location hierarchy and reference. One extra request per listing (about $0.0015 of Unblocker proxy usage each) and an extra 'detail' event per listing.", "default": false }, "onlyNewOrChanged": { "title": "Only new or changed items", "type": "boolean", "description": "Remember what earlier runs of this search returned and output only new listings or listings whose price or crossed-out old price (price drop) changed. Use with a Schedule; unchanged listings are not charged and their listing pages are not opened. With this on, Max items is the number of listings checked per run (e.g. the newest 30 with sort 'newest', one Unblocker request per 30).", "default": false }, "monitoringKey": { "title": "Monitoring key", "type": "string", "description": "Name for this watch, so several schedules on the same search stay separate; defaults to a key derived from the search input" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Idealista blocks datacenter and residential IPs (DataDome), so Apify's UNBLOCKER proxy group is the default. Each successful request costs about $0.0015 of proxy usage on your account: one request per 30 listings from search pages, plus one per listing with 'Include listing details'.", "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 } } } } } } } } } }