{ "openapi": "3.0.1", "info": { "title": "Spain Property Tracker: Fotocasa, Habitaclia, pisos.com", "description": "Get homes for sale or rent from Fotocasa, Habitaclia and pisos.com in one clean list. The same home on many portals is merged. Monitor mode tells you what is new, what dropped in price and what was removed.", "version": "0.1", "x-build-id": "8dOZuG4uQ9gmYh6ei" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apizilla~spain-property-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apizilla-spain-property-tracker", "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/apizilla~spain-property-tracker/runs": { "post": { "operationId": "runs-sync-apizilla-spain-property-tracker", "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/apizilla~spain-property-tracker/run-sync": { "post": { "operationId": "run-sync-apizilla-spain-property-tracker", "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", "required": [ "searches" ], "properties": { "searches": { "title": "Searches", "type": "array", "description": "What to search. Each item is either a search URL copied from a portal, or an object like {\"location\": \"Madrid\", \"operation\": \"sale\", \"propertyType\": \"homes\", \"minPrice\": 200000, \"maxPrice\": 500000, \"minRooms\": 2, \"minSize\": 60}. operation is \"sale\" or \"rent\". propertyType is one of: any, homes, flat, house, penthouse, duplex, studio, room, office, commercial, garage, land. A URL search only runs on its own portal. A location search runs on every chosen portal." }, "portals": { "title": "Portals", "type": "array", "description": "Which portals to search. Idealista is beta and off by default. It has strong bot protection and needs the Apify residential proxy.", "items": { "type": "string", "enum": [ "fotocasa", "habitaclia", "pisos", "idealista" ], "enumTitles": [ "Fotocasa", "Habitaclia", "pisos.com", "Idealista (beta, needs residential proxy)" ] }, "default": [ "fotocasa", "habitaclia", "pisos" ] }, "maxListingsPerPortal": { "title": "Max listings per portal", "minimum": 1, "type": "integer", "description": "Stop after this many listings on each portal, for all searches together.", "default": 200 }, "includeDetails": { "title": "Include details", "type": "boolean", "description": "Add the full description and more features. On pisos.com and Idealista this opens each listing page, so it is slower. Charged as an extra event per listing.", "default": false }, "browserForBeta": { "title": "Use a real browser for the beta portal", "type": "boolean", "description": "Idealista (beta) blocks plain requests. When this is on, the Actor opens Idealista in a real browser (Firefox) with a residential proxy, like a normal visitor. It is slower and costs more. It does not solve captchas: if Idealista asks for one, Idealista is skipped. Other portals always use fast plain requests.", "default": true }, "monitor": { "title": "Monitor changes", "type": "boolean", "description": "Remember listings between runs and mark each one as new, price_drop, price_rise, removed, back or unchanged. Run it on a schedule with the same input.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Optional name for the saved monitor state. Use it to keep the same history after you change the searches. If empty, the ID is made from your searches and portals." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy is used by default. Idealista always uses the Spanish residential proxy when it is turned on.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }