{ "openapi": "3.0.1", "info": { "title": "Zoopla Scraper [$0.50/1KšŸ’°] | UK Property | Leads", "description": "Scrape Zoopla.co.uk for UK property listings: sale and rental prices, sold-price history, EPC ratings, agent contacts, floor area, tenure and council tax bands. Track price drops, monitor new listings and build agent lead lists across London, Manchester and all UK postcodes.", "version": "1.0", "x-build-id": "0jZzFcUxeHCihdhao" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~zoopla-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-zoopla-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/ahmed_jasarevic~zoopla-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-zoopla-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/ahmed_jasarevic~zoopla-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-zoopla-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", "required": [ "searchUrls" ], "properties": { "searchUrls": { "title": "Search or Listing URLs", "type": "array", "description": "Zoopla search URLs (e.g. https://www.zoopla.co.uk/for-sale/property/london/ or https://www.zoopla.co.uk/to-rent/property/manchester/) or direct listing URLs (https://www.zoopla.co.uk/for-sale/details/71644137/). Search URLs are paginated and their listings are scraped; direct listing URLs are scraped individually.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Listings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of property listings to save per run.", "default": 20 }, "maxPagesPerSearch": { "title": "Max Pages per Search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of result pages to follow per search URL (Zoopla paginates with ?pn=N). Each Zoopla page holds ~28 listings. Note: Max Listings still applies first ā€” extra pages are only fetched while the listing target isn't met.", "default": 5 }, "scrapeDetails": { "title": "Scrape Listing Detail Pages", "type": "boolean", "description": "Fetch each listing's detail page for EPC rating, UPRN, agent phone, sold-price history, tenure, council tax band and description. Disable for faster, cheaper runs (search-card data only). Note: detail-enriched listings are billed at the 'listing-detail' event price; search-only listings at the lower 'listing' event price.", "default": true }, "maxRequestsPerCrawl": { "title": "Max Requests per Crawl", "minimum": 1, "maximum": 3000, "type": "integer", "description": "Hard safety cap on total HTTP requests for the whole run (search pages + detail pages). Rule of thumb: Max Listings x (details ? 1 : 0.04) + a few search pages.", "default": 1100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify UNBLOCKER proxy is required ā€” Zoopla is fronted by Cloudflare Turnstile which blocks plain HTTP clients. The UNBLOCKER group solves the challenge automatically.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ], "apifyProxyCountry": "GB" } } } }, "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 } } } } } } } } } }