# Zoopla Agent Scraper (`shahidirfan/zoopla-agent-scraper`) Actor Extract real estate agent details directly from Zoopla, one of the UK's leading property portals. Quickly gather agent names, contact information, and agency profiles. For optimal success rates and to prevent blocking, the use of residential proxies is strongly recommended. - **URL**: https://apify.com/shahidirfan/zoopla-agent-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 14 total users, 4 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Zoopla Estate Agent Scraper Extract Zoopla estate agent and branch data in a fast, reliable, and automated way. Collect contact details, listing activity, pricing indicators, and branch-level insights for lead generation, market research, and competitive monitoring. Built for structured datasets you can export and use immediately. ### Features - **Agent Directory Extraction** — Collect agent and branch records from Zoopla search pages. - **Rich Branch Profiles** — Gather contact, location, memberships, and operational branch details. - **Listing Activity Signals** — Capture for-sale and to-rent counts with pricing indicators. - **Clean Output Dataset** — Empty and null values are automatically excluded. - **Proxy Editor Support** — Proxy can be enabled or disabled directly in input proxy settings. - **Pagination Support** — Continue collecting records across multiple result pages. ### Use Cases #### Lead Generation Build targeted estate agent lists by city or area. Use phone, address, and branch details to support outreach workflows and CRM enrichment. #### Competitor Monitoring Track agency presence and activity across regions. Compare listing volumes and branch expansion trends over time. #### Property Market Intelligence Analyze average pricing signals and branch performance indicators. Support strategic decisions with structured regional datasets. #### Directory Enrichment Enhance existing databases with branch profile details and operational metadata. Keep your internal records complete and current. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `startUrls` | Array | Yes | `[`"https://www.zoopla.co.uk/find-agents/estate-agents/london/"`]` | One or more Zoopla directory URLs to scrape. | | `results_wanted` | Integer | No | `20` | Maximum number of agent records to collect. | | `max_pages` | Integer | No | `2` | Maximum pages to process per start URL. | | `proxyConfiguration` | Object | No | `{"useApifyProxy": true}` | Proxy settings from Apify proxy editor. | --- ### Output Data Each dataset item can contain: | Field | Type | Description | |-------|------|-------------| | `agentId` | String | Unique agent or branch identifier. | | `name` | String | Main public name of the agency/branch. | | `branchName` | String | Branch name. | | `companyName` | String | Parent company or brand name. | | `url` | String | Branch profile URL. | | `branchUri` | String | Branch URI slug. | | `contactUrl` | String | Contact page URL. | | `address` | String | Full branch address. | | `postalCode` | String | UK postcode when available. | | `outcode` | String | Postcode outcode when available. | | `locality` | String | Local area or city. | | `phone` | String | Contact phone number. | | `logo` | String | Branch logo URL. | | `featured` | Boolean | Whether the branch is marked as featured. | | `rating` | Number | Rating value when available. | | `reviewCount` | Number | Number of reviews when available. | | `listingsForSale` | Number | Number of active sale listings. | | `listingsToRent` | Number | Number of active rental listings. | | `avgAskingPrice` | Number | Average sale asking price signal. | | `avgRentPrice` | Number | Average rent asking price signal. | | `avgWeeksOnMarketSale` | Number | Average sale listing time on market. | | `avgWeeksOnMarketRent` | Number | Average rental listing time on market. | | `commercialSaleTotal` | Number | Commercial listings for sale count. | | `commercialRentTotal` | Number | Commercial listings to rent count. | | `latitude` | Number | Branch latitude. | | `longitude` | Number | Branch longitude. | | `memberships` | Array | Membership/affiliation details. | | `socialUrls` | Object | Available social profile links. | | `openingTimes` | Array | Branch opening schedule when present. | | `branchImages` | Array | Branch image URLs. | | `staffMembers` | Array | Staff details when available. | | `listingsPreview` | Object | Sample listing cards for sale/rent. | | `source` | String | Source marker for the extracted record. | | `sourcePage` | Number | Result page number where found. | | `searchUrl` | String | Input search URL that produced the record. | | `scrapedAt` | String | ISO timestamp of extraction. | --- ### Usage Examples #### Basic Extraction ```json { "startUrls": [ "https://www.zoopla.co.uk/find-agents/estate-agents/london/" ], "results_wanted": 20, "max_pages": 2 } ```` #### Multi-Location Collection ```json { "startUrls": [ "https://www.zoopla.co.uk/find-agents/estate-agents/london/", "https://www.zoopla.co.uk/find-agents/estate-agents/manchester/", "https://www.zoopla.co.uk/find-agents/estate-agents/birmingham/" ], "results_wanted": 120, "max_pages": 6 } ``` #### Proxy-Enabled Run ```json { "startUrls": [ "https://www.zoopla.co.uk/find-agents/estate-agents/london/" ], "results_wanted": 60, "max_pages": 4, "proxyConfiguration": { "useApifyProxy": true } } ``` *** ### Sample Output ```json { "agentId": "162401", "name": "& Co", "branchName": "& Co", "companyName": "& Co", "url": "https://www.zoopla.co.uk/find-agents/branch/and-co-london-162401/", "contactUrl": "https://www.zoopla.co.uk/find-agents/contact/and-co-london-162401/", "address": "167-169 Great Portland Street, London", "postalCode": "W1W 5PF", "locality": "London", "phone": "020 8139 3867", "listingsForSale": 49, "listingsToRent": 1, "avgAskingPrice": 609082, "avgRentPrice": 576, "latitude": 51.521608, "longitude": -0.143704, "source": "api", "sourcePage": 1, "scrapedAt": "2026-02-18T12:00:00.000Z" } ``` *** ### Tips for Best Results #### Start With One URL - Begin with a single proven URL and a low `results_wanted` value. - Confirm output structure before scaling to multiple areas. #### Scale Gradually - Increase `results_wanted` in steps for stable long runs. - Use more start URLs instead of very high page depth on one URL. #### Use Proxy Only When Needed - Run without proxy for quick validation and small tests. - Enable proxy for larger jobs or when reliability drops. #### Keep Location URLs Specific - Use clear city/location pages for more relevant records. - Avoid unrelated directory pages to reduce noisy output. *** ### Proxy Configuration Proxy usage is controlled in `proxyConfiguration`. ```json { "proxyConfiguration": { "useApifyProxy": true } } ``` To run without proxy: ```json { "proxyConfiguration": { "useApifyProxy": false } } ``` *** ### Integrations Connect your dataset with: - **Google Sheets** — Share and analyze records quickly. - **Airtable** — Build searchable lead and market databases. - **Make** — Automate enrichment and downstream workflows. - **Zapier** — Trigger CRM and notification automations. - **Webhooks** — Push data into custom pipelines. #### Export Formats - **JSON** — Developer-friendly structured output. - **CSV** — Spreadsheet analysis and bulk filtering. - **Excel** — Reporting and stakeholder sharing. - **XML** — System integration workflows. *** ### Frequently Asked Questions #### Can I run this actor without proxy? Yes. Set `proxyConfiguration.useApifyProxy` to `false`. #### Can I enable proxy when needed? Yes. Set `proxyConfiguration.useApifyProxy` to `true`. #### How many records can I collect? Set `results_wanted` to your target volume. Collection depends on available results. #### Can I scrape multiple cities in one run? Yes. Add multiple URLs in `startUrls`. #### Why are some fields missing for certain agents? Some branches do not publish every data point. Only available values are returned. #### Does output include empty fields? No. Empty and null values are excluded from dataset items. *** ### Support For issues or feature requests, use the actor issue tracker or Apify Console support. #### Resources - [Apify Documentation](https://docs.apify.com/) - [Apify API Reference](https://docs.apify.com/api/v2) - [Apify Schedules](https://docs.apify.com/platform/schedules) *** ### Legal Notice This actor is intended for lawful data collection and analysis. You are responsible for complying with applicable laws, platform terms, and responsible usage practices. # Actor input Schema ## `startUrls` (type: `array`): List of Zoopla agent directory URLs to crawl. ## `results_wanted` (type: `integer`): Maximum number of agents to collect. Pages are estimated and capped by max pages. ## `max_pages` (type: `integer`): Maximum number of directory pages to crawl per search URL. ## `proxyConfiguration` (type: `object`): Proxy settings. Default is selected, but you can disable it in the proxy editor. ## Actor input object example ```json { "startUrls": [ "https://www.zoopla.co.uk/find-agents/estate-agents/london/" ], "results_wanted": 20, "max_pages": 2, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://www.zoopla.co.uk/find-agents/estate-agents/london/" ], "results_wanted": 20, "max_pages": 2, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/zoopla-agent-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["https://www.zoopla.co.uk/find-agents/estate-agents/london/"], "results_wanted": 20, "max_pages": 2, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/zoopla-agent-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://www.zoopla.co.uk/find-agents/estate-agents/london/" ], "results_wanted": 20, "max_pages": 2, "proxyConfiguration": { "useApifyProxy": true } }' | apify call shahidirfan/zoopla-agent-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/zoopla-agent-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zoopla Agent Scraper", "description": "Extract real estate agent details directly from Zoopla, one of the UK's leading property portals. Quickly gather agent names, contact information, and agency profiles. For optimal success rates and to prevent blocking, the use of residential proxies is strongly recommended.", "version": "0.0", "x-build-id": "ZrvxqbcOXdIlpaPiq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~zoopla-agent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-zoopla-agent-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/shahidirfan~zoopla-agent-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-zoopla-agent-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/shahidirfan~zoopla-agent-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-zoopla-agent-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "List of Zoopla agent directory URLs to crawl.", "default": [ "https://www.zoopla.co.uk/find-agents/estate-agents/london/" ], "items": { "type": "string" } }, "results_wanted": { "title": "Maximum agents", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of agents to collect. Pages are estimated and capped by max pages.", "default": 20 }, "max_pages": { "title": "Maximum pages", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of directory pages to crawl per search URL.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Default is selected, but you can disable it in the proxy editor.", "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 } } }, "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 } } } } } } } } } } ```