{ "openapi": "3.0.1", "info": { "title": "Fotocasa Scraper — Spain Real Estate Data Extractor", "description": "Scrape property listings from Fotocasa.es — Spain's leading real estate portal. Extract prices, rooms, area, GPS coordinates, agency contacts, and images for sale, rent, and shared listings. Filter by city, price, size, and property type. Export as JSON, CSV, Excel, or via API.", "version": "1.0", "x-build-id": "ilcbC9fv4hxk1Yvcx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~fotocasa-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-fotocasa-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/parsebird~fotocasa-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-fotocasa-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/parsebird~fotocasa-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-fotocasa-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": { "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of property listings to scrape.", "default": 10 }, "location": { "title": "Location", "type": "string", "description": "Location to search for properties (e.g., city name or region). Examples: Madrid, Barcelona, Valencia, Sevilla, Málaga.", "default": "Madrid" }, "operation": { "title": "Operation", "enum": [ "buy", "rent", "share", "rentBuyOption", "transfer" ], "type": "string", "description": "Type of property operation to search for.", "default": "buy" }, "rentalTypes": { "title": "Rental Duration", "type": "array", "description": "Rental duration filter (only applies when operation is 'rent').", "items": { "type": "string", "enum": [ "longTerm", "temporary" ], "enumTitles": [ "Long Term", "Temporary" ] }, "default": [] }, "propertyType": { "title": "Property Type", "enum": [ "home", "newHome", "premises", "garages", "office", "boxRoom", "land", "building" ], "type": "string", "description": "Category of property to search for.", "default": "home" }, "minPrice": { "title": "Min Price (€)", "minimum": 0, "type": "integer", "description": "Minimum property price in euros. Set to 0 for no minimum.", "default": 0 }, "maxPrice": { "title": "Max Price (€)", "minimum": 0, "type": "integer", "description": "Maximum property price in euros. Set to 0 for no maximum.", "default": 0 }, "minSize": { "title": "Min Size (m²)", "minimum": 0, "type": "integer", "description": "Minimum property area in square meters. Set to 0 for no minimum.", "default": 0 }, "maxSize": { "title": "Max Size (m²)", "minimum": 0, "type": "integer", "description": "Maximum property area in square meters. Set to 0 for no maximum.", "default": 0 }, "publicationDate": { "title": "Publication Date", "enum": [ "", "last48h", "lastWeek", "lastMonth" ], "type": "string", "description": "Filter by when the listing was published.", "default": "" }, "sortBy": { "title": "Sort By", "enum": [ "rating", "latest", "cheapest", "mostExpensive", "biggest", "smallest", "cheapestPerM2" ], "type": "string", "description": "How to sort the search results.", "default": "rating" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for the scraper. Residential proxies are recommended for fotocasa.es.", "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 } } } } } } } } } }