# Zoopla Listings Scraper (`nice_dev/zoopla-listings-scraper`) Actor

Scrape Zoopla.co.uk property listings (for sale, to rent, new homes) by area, postcode or search URL: price, beds, baths, GPS, full postcode, agent, photos, description, tenure, EPC, price history, sold prices and agency details.

- **URL**: https://apify.com/nice_dev/zoopla-listings-scraper.md
- **Developed by:** [Nice Dev](https://apify.com/nice_dev) (community)
- **Categories:** Real estate, Lead generation, MCP servers
- **Features:** Limited permissions
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.72 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### 🏠 What is Zoopla Listings Scraper?

**Zoopla Listings Scraper** extracts **property listings from [Zoopla.co.uk](https://www.zoopla.co.uk)**, one of the two big UK property portals: **asking price or rent, bedrooms, bathrooms, receptions, floor area, address with full postcode and GPS coordinates, estate agent with phone number, photos, floor plans, virtual tours, description, tenure and lease length, council tax band, service charge, deposit, EPC rating, nearest stations with distances and price history**, for sale, to rent and new homes. It works as a **Zoopla API alternative**: run it on a schedule, call it from your code, or plug it into Make, Zapier or n8n.

Type one or **many areas** (`London`, `Hampstead`, `Greater Manchester`, `SW1A`, `Leeds, West Yorkshire`), add **keywords, a search radius and any of Zoopla's own filters** (garden, parking, tenure, property sub-type, floor area, auctions, shared ownership, retirement homes, student lets, bills included…), or paste any Zoopla search URL or listing id, click **Start**, and download the listings in JSON, CSV or Excel. Optionally, each listing also gets its **estate agency's details** (website, office address, opening hours, team, professional bodies) and **the agency's e-mail, found on its own website**. Searches larger than Zoopla's **1,000-result cap are split into price bands automatically**, and **Only new listings** turns the Actor into a monitor. No login needed: **about 100 listings with full details in 2 minutes**.

### 📋 What data can you extract from Zoopla?

One item per listing, 107 fields:

| Category | What you get |
| --- | --- |
| 🏷️ **Listing** | title, link, listing number, for sale / to rent / new home, property type, link to the agent's contact form — `3 bed flat for sale` |
| 💰 **Price** | asking price or rent, currency, what the agent writes next to it (`Guide price`), rent per week, price per square foot, deposit, auction or not — `£160,000`, `£168 per sq ft` |
| 📉 **Price changes** | latest price cut in %, date of the last change, every past change with its date and direction |
| 📍 **Location** | address as Zoopla shows it, complete postcode, street, town, county, region, latitude and longitude, Street View position; house number or name and UPRN when the exact address is proven — `SE10 9QX` |
| 📐 **Size and layout** | bedrooms, bathrooms, reception rooms, floor area in square feet and where that figure comes from — `3 bed, 2 bath, 952 sq ft` |
| 🧾 **Ownership and running costs** | freehold or leasehold, years left on the lease, council tax band, service charge, ground rent, EPC rating with its graph and document, the agency's tenancy fees (rentals) — `Leasehold, band D, EPC C` |
| ✅ **Status** | just added, under offer, sold, chain-free, shared ownership, retirement home, furnished or not, available from, new build or resale, premium listing |
| 📝 **Text and media** | key features, agent's highlights, short and full description, water, heating, broadband and parking, every photo in full size, floor plans, brochures, virtual tours, videos |
| 🏢 **Estate agent** | agency or developer name, phone number, logo, branch page, brand — `Savills - Kensington`, `020 8022 3223` |
| 🚉 **Around the property** | nearest stations with their distance, nearest EV chargers with their address, connectors and distance — `Greenwich, 0.2 miles` |
| 🕒 **Dates** | publication date, what the date filters read; the search that found the listing; when it was scraped |
| 🏛️ **Agency details (option)** | agency website, office address, opening hours, team with roles and photos, professional bodies (ARLA, NAEA, TPO…), its listings, average price and weeks on the market, residential and commercial, its text and social pages |
| ✉️ **Agency e-mail (option)** | the e-mail published on the agency's own website, all the addresses found, the page they were on |
| 🏘️ **Sold prices (option)** | what the address sold for before (HM Land Registry), last sale price and date, every sale with its change, past adverts on Zoopla with the price asked |

Every field, with an example, is listed in the **Output** section below.

Fields marked **detail** in the Output tab (`postcode`, `description`, `features`, `tenure`, `leaseYears`, `councilTaxBand`, `serviceCharge`, `deposit`, `administrationFees`, `epcRating`, `epcImage`, `transports`, `evChargers`, `priceHistory`, all photos, `floorPlans`, `brochures`, `virtualTours`, `videos`, `streetView`) are filled when **Extract details** is on (default). Turn it off for a listing-card-only scrape that is 2× faster. `publishedOn` is a date-time with details, the day only (`2026-09-15`) without.

The five sold-price fields need **Add sold prices and past adverts**. Zoopla no longer prints the exact address on its listing pages, so these fields are filled only when the Actor can prove which address a listing is: never a neighbour's sales. Measured on 153 listings in 10 UK cities on 31 October 2026: 33 proven (20 of 73 sales, 13 of 80 rentals). New-build plots and brand-new towers have no address on record yet and stay empty. The other listings come out with those fields empty — never missing.

The agency fields need **Add the estate agency's details** or **Find the agency's e-mail on its website**: the Actor reads the agency's Zoopla page once per agency, whatever the number of its listings (17 agency pages for 20 Bristol listings on 19 September 2026; 18 of the 20 listings came with the agency's website).

### ✅ Why use Zoopla Listings Scraper?

- 🚀 **Fast**: about 100 listings with full details in 2 minutes.
- 🎯 **Type the places, not URLs**: 9 000+ Zoopla search areas are known by name (towns, London districts, counties, outcodes). Ambiguous names (`Leeds`) get a clear message with the candidates instead of a wrong area.
- 🗂️ **Several searches in one run**: keywords × areas, with a cap per search so that one big city cannot eat the whole budget.
- ♾️ **No 1,000-result wall**: a search Zoopla caps at 1,000 listings is split into price bands on its own, and every listing is delivered once.
- 🔎 **Every Zoopla filter**: keywords (with Zoopla's `"phrase"` and `-exclude` syntax), radius, bathrooms, sub-types, garden / parking / balcony, tenure, floor area, reduced price, auctions, shared ownership, retirement homes, sold / under offer, new builds in or out, bills included, house shares, student lets, let agreed, availability, weekly or monthly rent.
- 🗺️ **Search a map area**: give a GPS point and a radius in miles, or the corners of an area you draw yourself — Zoopla then answers only what falls inside the shape, whatever the place names say.
- 🏷️ **Sold prices**: add what each address sold for before (HM Land Registry) and the times it was advertised on Zoopla, so you can see the asking price next to the last sale.
- 🏢 **Agency details and e-mails**: website, office, opening hours, team, ARLA / NAEA / TPO membership and the agency's figures on Zoopla, read once per agency — plus, if you want, the e-mail the agency publishes on its own website (Zoopla itself only shows a contact form).
- 📍 **Find a listing by address**: type `81 Willis Road, Bristol, BS15 4SW` and get the listing advertised there today, or a clear message saying nothing is.
- 🔔 **Monitoring built in**: tick **Only new listings**, schedule the Actor, and each run returns (and charges) only what it has never delivered before.
- 📅 **Date filters**: `postedAfter: "7 days"` — a filtered-out listing is not saved; a listing you keep costs its normal price, a listing a filter drops costs a filter fee.
- 💷 **Numbers, not labels**: `price` is a number, `postcode` is complete, GPS coordinates are on every listing, stations come with their distance.
- 🔌 API, scheduling, monitoring, integrations (Make, Zapier, n8n, Google Sheets…) and JSON/CSV/Excel export via the Apify platform.

### 🚀 How to scrape Zoopla

1. Create a free Apify account.
2. Open **Zoopla Listings Scraper**, type a **Location** (e.g. `Bristol`) and, if you want, **More locations**; choose **for sale / to rent / new homes** and the **property type**; add filters (price, bedrooms, keywords, radius, garden, tenure, rentals…).
3. Or paste your own Zoopla URLs into **Start URLs** (any search results page, all filters kept, or single listing pages), listing ids into **Listing IDs**, or postal addresses into **Postal addresses**.
4. Set **Max listings** (100 by default, 0 = no limit) — and **Max listings per search** when you run several searches — then click **Start**.
5. Download the dataset in JSON, CSV, Excel or via API.

Zoopla shows at most **1,000 listings per search** (40 pages): the Actor splits a bigger search into price bands by itself when you ask for more.

### 💰 How much does it cost to scrape Zoopla?

This Actor uses **pay per event** pricing (the same amounts are in the **Pricing** tab): **$0.89 per 1,000 listings** on the Free plan, details included, down to **$0.72 on the Gold plan**, plus **$0.01 per run start**. You pay for the listings saved, and each option for what it adds.

Prices are per 1,000 events, by Apify plan (a higher plan pays less).

| What you pay for | Event | Free | Bronze | Silver | Gold |
| --- | --- | --- | --- | --- | --- |
| Listing saved, details and agency details included | `apify-default-dataset-item` | $0.89 | $0.84 | $0.78 | $0.72 |
| Listing delivered with at least one agency e-mail, only with **Find the agency's e-mail on its website** | `email-enriched` | $2.29 | $1.79 | $1.59 | $1.29 |
| Listing delivered with at least one sale or past advert, only with **Add sold prices and past adverts** | `sold-history` | $0.89 | $0.88 | $0.87 | $0.86 |
| Listing dropped by a filter of the Actor (a listing you keep pays its normal price instead) | `filter-check` | $0.35 | $0.34 | $0.33 | $0.32 |
| Run start | `apify-actor-start` | $0.01 per run | $0.01 per run | $0.01 per run | $0.01 per run |

Example on the Free plan: all houses for sale in Greater Manchester (1,000 listings) ≈ $0.90; a daily monitor of 200 new listings ≈ $0.19 a day. Platform usage (compute, proxy) is included in the price. Listings removed by **Only new listings** are not charged. The filters of the Actor itself (**Posted after / before**, **Exclude keywords**) read every listing of the search: a listing you keep costs its normal price, a listing a filter drops is charged a filter fee (event `filter-check`) — filtering never costs more than taking everything. Zoopla's own filters (price, keywords, garden…) cost nothing, since the listings they leave out are never read. The agency details (**Add the estate agency's details**) are included in the listing price. The agency e-mails (**Find the agency's e-mail on its website**) are a separate `email-enriched` event, charged per listing delivered with at least one e-mail (only the agency's own addresses count: those of a web agency, a host or a general page are left aside) — nothing when the option is off, when the agency gives no website or when its website shows no address. Both options are off by default. The sold prices and past adverts of each address (**Add sold prices and past adverts**, off by default) are a separate `sold-history` event, charged per listing delivered with at least one sale or past advert.

### ⚙️ Input

```json
{
    "location": "Bristol",
    "locations": ["Bath"],
    "listingType": "sale",
    "propertyType": "houses",
    "priceMax": 400000,
    "bedsMin": 3,
    "searchQueries": ["garage"],
    "mustHave": ["has_garden"],
    "radius": "1",
    "maxItems": 500,
    "maxItemsPerQuery": 250,
    "extractDetails": true
}
```

| Field | Description |
| --- | --- |
| `startUrls` | Zoopla search or listing URLs. When set (or `listingIds`), the search fields below are ignored. Every parameter you paste is kept as is. |
| `location`, `locations` | Area names, London districts, counties, outcodes or postcodes; one search per area. Ambiguous names must be qualified: `Leeds, West Yorkshire`. |
| `listingType` | `sale` (default), `rent`, `new-homes`. |
| `propertyType` | `property` (all, default), `houses`, `flats`, `bungalows`, `farms-land`. |
| `maxItems`, `maxItemsPerQuery` | Maximum listings to save in total (default 100, 0 = no limit) and per search (0 = no cap). |
| `priceMin`, `priceMax` | GBP; rent per month, or per week with `priceFrequency: "per_week"`. |
| `bedsMin`, `bedsMax`, `bathsMin`, `bathsMax` | Rooms. |
| `extractDetails` | Open each listing page for the detail fields (default true). |
| `searchQueries` | Keywords: one search per entry (× each area). Zoopla syntax: `"double garage"`, `-auction`. |
| `radius` | `0` (this area only) to `40` miles. |
| `propertySubTypes` | `detached`, `semi_detached`, `terraced`, `flats`, `bungalow`, `farms_land`, `park_home`, `land`. |
| `mustHave` | `has_garden`, `has_parking_garage`, `has_balcony_terrace` (all of them). |
| `tenure` | `freehold`, `leasehold`, `share_of_freehold`. |
| `floorAreaMin`, `floorAreaMax`, `floorAreaUnit` | Internal area, `sq_feet` (default) or `sq_metres`. |
| `sortBy` | `NEWEST` (default), `DEFAULT` (Zoopla recommended), `PRICE_DESC`, `PRICE_ASC`. |
| `addedWithin` | Zoopla's own window: `0` any time, `1`, `3`, `7`, `14`, `30` days. |
| `chainFree`, `reducedPriceOnly` | Sale: no onward chain only; price reduced only. |
| `auction`, `sharedOwnership`, `retirementHomes` | `ANY` (default), `ONLY` or `EXCLUDE`. |
| `includeSold` | Sale: also list the properties marked sold or sold subject to contract (Bristol: 3,850 listings without it, 7,123 with it). |
| `newHomes` | `ANY` (default, new builds kept), `ONLY`, `EXCLUDE`. |
| `latitude`, `longitude`, `aroundRadiusMiles` | Search a circle around a GPS point (0.05 to 50 miles) instead of a place name. |
| `polygon` | The corners of an area you draw: `[{ "latitude": 51.44, "longitude": -2.63 }, …]`, 3 to 200 points. Zoopla then answers only what falls inside. |
| `includeHistory` | Add the sold prices and the past adverts of each address, for the listings whose exact address can be proven: up to three extra pages per listing, needs `extractDetails`. |
| `includeAgentDetails` | Add the agency's details (website, office, hours, team, bodies, figures, social pages): one page per agency, needs `extractDetails`. |
| `enrichEmails` | Look for the agency's e-mail on its own website (3 pages at most, once per website), needs `extractDetails`; fills the agency details too. Only the agency's own addresses are kept: those on the domain of its website, or an address (a webmail one included) that carries its name or that of its website; the address of a web agency, a host or a general page is left aside. |
| `propertyAddresses` | Postal addresses to find the listing of, e.g. `81 Willis Road, Bristol, BS15 4SW`. |
| `priceFrequency`, `furnished`, `petsAllowed`, `billsIncluded`, `sharedAccommodation`, `studentAccommodation`, `includeLetAgreed`, `availableFrom` | Rentals: rent shown per month (`per_month`) or per week (`per_week`), furnishing, pets, bills included, house shares and student lets (include, only, or leave out), let agreed included, available now or within 1, 3, 6 or 12 months. |
| `postedAfter`, `postedBefore`, `excludeKeywords` | Post-filters of the Actor: publication date, words to leave out (`excludeKeywords` looks for WHOLE words: "garden" drops a listing tagged "Garden", not one that only says "Gardens"; several words in one entry must appear together). A dropped listing is not saved and costs a filter fee; a kept listing costs its normal price. |
| `onlyNew`, `stateKey`, `resetState` | Monitoring: only the listings a previous run with the same key has not delivered. |
| `listingIds` | Zoopla listing ids, scraped directly. |
| `proxyConfiguration`, `maxConcurrency`, `maxRequestsPerMinute`, `maxRequestRetries`, `debugLog` | Advanced. UK residential IPs by default, included in the price (paying Apify plans). Lower `maxRequestsPerMinute` if the log shows blocked requests. |

### 📦 Output

A real listing, shortened to its main fields:

```json
{
  "id": 74247423,
  "url": "https://www.zoopla.co.uk/for-sale/details/74247423/",
  "listingType": "sale",
  "isNewHome": false,
  "title": "3 bed flat for sale",
  "propertyType": "flat",
  "price": 160000,
  "currency": "GBP",
  "priceLabel": "£160,000",
  "priceQualifier": null,
  "pricePerSqft": 168,
  "address": "Norman Road, Greenwich SE10",
  "postcode": "SE10 9QX",
  "outcode": "SE10",
  "streetName": "Norman Road",
  "town": "London",
  "latitude": 51.479708,
  "longitude": -0.017117,
  "bedrooms": 3,
  "bathrooms": 2,
  "receptions": 0,
  "floorAreaSqft": 952,
  "tenure": "leasehold",
  "serviceCharge": "£152 per month",
  "sharedOwnership": true,
  "tags": [
    "Shared ownership",
    "Leasehold"
  ],
  "features": [
    "Three-bedroom shared ownership apartment",
    "Approximately 952 sq ft of internal space",
    "Residents' roof terrace"
  ],
  "description": "Saxon Wharf | Greenwich SE10\n\nDiscover modern waterside living at Saxon Wharf…",
  "propertyInfo": {
    "tenure": "Leasehold (Ask agent)",
    "service_charge": "£152 per month",
    "shared_ownership_percentage": "25%"
  },
  "mainImage": "https://lc.zoocdn.com/20f2f736a7a4862aa0d009a46ef1eb5252f3b9a8.jpg",
  "imageCount": 10,
  "floorPlans": [
    "https://lc.zoocdn.com/51558edca090d9070da716f41344933fc5d33fe4.png"
  ],
  "agentId": 169472,
  "agentName": "NHG Homes - Saxon Wharf Greenwich",
  "agentPhone": "020 8139 7356",
  "agentIsDeveloper": true,
  "agentWebsite": "https://nhghomes.com/",
  "agentAddress": "Sun Coal House, 46 Norman Road, London",
  "agentPostcode": "SE10 9PU",
  "contactUrl": "https://www.zoopla.co.uk/for-sale/contact/74247423/",
  "publishedOn": "2026-09-15T14:34:17.000Z",
  "nearestStations": [
    "Greenwich",
    "Cutty Sark",
    "Deptford"
  ],
  "transports": [
    {
      "name": "Greenwich",
      "distanceMiles": 0.2
    },
    {
      "name": "Cutty Sark",
      "distanceMiles": 0.3
    },
    {
      "name": "Deptford",
      "distanceMiles": 0.4
    }
  ],
  "leaseYears": null,
  "category": "residential",
  "countryCode": "GB",
  "searchUrl": "https://www.zoopla.co.uk/for-sale/property/london/?results_sort=newest_listings&pn=1",
  "searchLabel": "London",
  "scrapedAt": "2026-09-16T03:00:00.000Z"
}
```

You can download the dataset in various formats such as JSON, HTML, CSV or Excel.

#### All 107 fields

| Fields | What you get |
| --- | --- |
| `id`, `url`, `title`, `contactUrl` | `74247423`, `https://www.zoopla.co.uk/for-sale/details/74247423/`, `3 bed flat for sale`, contact form link |
| `listingType`, `isNewHome`, `propertyType`, `category` | `sale`, `false`, `flat`, `residential` |
| `price`, `currency`, `priceLabel`, `priceQualifier`, `isAuction` | `160000`, `GBP`, `£160,000`, `Guide price`, `false` |
| `rentFrequency`, `rentPerWeek`, `deposit`, `administrationFees` | `pcm`, `531`, `£1,500`, the agency's tenancy fees as text (rentals) |
| `pricePerSqft`, `priceDropPercent`, `lastPriceChange`, `priceHistory` | `168`, `9.1`, `2026-07-03`, `[{ date, isDrop, isIncrease, … }]` |
| `address`, `postcode`, `outcode`, `streetName`, `propertyNumberOrName`, `town`, `county`, `region`, `countryCode`, `uprn` | `Norman Road, Greenwich SE10`, `SE10 9QX`, `SE10`, `Norman Road`, `12a`, `London`, `London`, `London`, `GB`, `10008345678` |
| `latitude`, `longitude`, `streetView` | `51.479708`, `-0.017117`, `{ latitude, longitude, heading, pitch }` of the Street View picture of the listing |
| `bedrooms`, `bathrooms`, `receptions`, `floorAreaSqft`, `floorAreaSource` | `3`, `2`, `1`, `952`, `structured_data` |
| `tenure`, `leaseYears`, `councilTaxBand`, `serviceCharge`, `groundRent`, `epcRating`, `epcImage`, `epcPdf` | `leasehold`, `125`, `D`, `£152 per month`, `£250 per year`, `C`, EPC graph and document links |
| `listingCondition`, `listingStatus`, `statusLabel`, `underOffer`, `isPremium` | `pre-owned`, `for_sale`, `Just added`, `false`, `false` |
| `chainFree`, `sharedOwnership`, `retirementHome`, `furnishedState`, `availableFrom` | `true`, `false`, `false`, `furnished`, `immediately` |
| `tags`, `highlights`, `features` | `["Leasehold"]`, `["Viewing Advised"]`, `["Three double bedrooms", …]` |
| `summaryDescription`, `description`, `propertyInfo` | short and full text, `{ tenure, service_charge, water, heating, broadband, parking… }` |
| `mainImage`, `images`, `imageCount`, `floorPlans`, `floorPlanCount`, `brochures`, `videoCount`, `virtualTours`, `videos` | full-size photo URLs, `24`, floor-plan images, `2`, brochure links, `1` (videos and virtual tours), `["https://tour.giraffe360.com/…"]`, `["https://www.youtube.com/embed/…"]` |
| `agentId`, `agentName`, `agentPhone`, `agentUrl`, `agentLogo`, `agentIsDeveloper`, `brandName` | `169472`, `Savills - Kensington`, `020 8022 3223`, branch page, … |
| `agentWebsite`, `agentAddress`, `agentPostcode`, `agentHours`, `agentTeam`, `agentAccreditations`, `agentMarketStats`, `agentAbout`, `agentFacebook`, `agentInstagram`, `agentTwitter`, `agentLinkedin` | `http://www.bristolestateagent.co.uk/`, `Henleaze House, 13 Harbury Road, Bristol`, `BS9 4PN`, `[{ weekday: "Monday", opensAt: "9:00am", closesAt: "6:30pm" }, …]`, `[{ firstName, lastName, role, photoUrl }, …]`, `[{ body: "tpo", name: "The Property Ombudsman", link }]`, `{ saleListingCount: 518, saleAvgPrice: 416250, saleAvgWeeks: 14, … }` with the same figures for rentals and commercial property (with **Add the estate agency's details**) |
| `agentEmail`, `agentEmails`, `agentEmailSource` | `bradleystoke@cjhole.co.uk`, all addresses found, the page they were on (with **Find the agency's e-mail**) |
| `nearestStations`, `transports` | `["Greenwich", …]`, `[{ name: "Greenwich", distanceMiles: 0.2 }, …]` |
| `evChargers`, `nearestEvChargerMiles` | `[{ name, address, postcode, distanceMiles, connectors, latitude, longitude }, …]`, `0.1` |
| `lastSoldPrice`, `lastSoldDate`, `salesHistory`, `pastListings`, `soldPricesSource` | `250000`, `2018-04-06`, `[{ date, price, percentChange, priceChange }, …]`, `[{ date, price, priceType, url }, …]`, `landRegistry` (with **Add sold prices**) |
| `publishedOn`, `searchUrl`, `searchLabel`, `scrapedAt` | date the listing went live, the search that found it (`garden · Bristol`) |

### 💡 Tips

#### How to get more results

Set **Max listings** to what you need (`0` = everything) and add areas in **More locations**: searches beyond Zoopla's cap are split into price bands on their own. For a monitor, keep `sortBy: NEWEST`, tick **Only new listings** with a **Memory key** per schedule, and schedule the Actor daily.

#### How to reduce costs

The price is per listing, so the levers are `maxItems`, `maxItemsPerQuery`, Zoopla's own filters (price, keywords, garden…: the listings they leave out are never read) and `onlyNew` for recurring runs (you never pay twice for the same listing). Turning `extractDetails` off makes runs 2× faster but does not change the price.

#### Keyword tricks

`"double garage"` finds an exact phrase, `-auction` leaves a word out; several words in one entry must all be present.

#### Blocked requests in the log

Lower `maxRequestsPerMinute`. The Actor saves its progress, so a run that migrates or is resurrected goes on without duplicates.

#### Search a map area instead of a place

Fill **Latitude** and **Longitude** and the Actor asks Zoopla for the circle of **Radius around the point** miles around it — leave **Location** empty. For a shape of your own, put its corners in **Area drawn on a map**; the shape then decides on its own which listings come back, and the place name is ignored. Every other filter (price, bedrooms, keywords…) still applies. Measured on a 3 × 5 mile box over central Bristol: 1,131 listings for sale, 533 to rent.

#### Sold prices and past adverts

Tick **Add sold prices and past adverts** and each listing whose exact address can be proven also carries what that address sold for before (HM Land Registry, newest first), the times it was advertised on Zoopla with the price asked then, and its `uprn`, `streetName` and `propertyNumberOrName`. It reads up to three extra pages per listing, so a run takes two to three times as long. Zoopla no longer prints the exact address on its listing pages and the Actor never guesses: a listing it cannot tie to its address for certain comes out with those fields empty, never with a neighbour's sales, and no `sold-history` is charged for it. That was 120 listings out of 153 in the sample above: expect about 1 sale in 4 and 1 rental in 6 to be filled. A listing whose extra page fails is still delivered, with those fields empty.

#### Estate agency details and e-mails

Tick **Add the estate agency's details** and each listing carries what its agency publishes on Zoopla: website, office address and postcode, opening hours, team (names, roles, photos), professional bodies (ARLA, NAEA, TPO…), its number of listings, average price and weeks on the market, its text and its social pages. The agency page is read once per agency and run, so a search where one agency has 50 listings costs one extra page, not 50; a developer's branch is read the same way. Measured on 20 new Bristol listings: 17 agencies, 18 listings with a website, 16 with opening hours, 4 with a team.

Zoopla shows no e-mail for an agency, only a contact form. Tick **Find the agency's e-mail on its website** and the Actor visits the website the agency gives (home page, then its contact / legal pages, 3 pages at most, once per website — the five Ocean branches of Bristol share one) and adds the addresses published there: `agentEmail` is the first one, on the agency's own domain first, `agentEmails` all of them and `agentEmailSource` the page. Social-network pages are not visited, and a site that hides its address behind a form or JavaScript gives none. Measured on the same 20 listings: 7 came with an agency e-mail (CJ Hole, Andrews, Agreed.co.uk, Hunters). A listing whose agency page fails is still delivered, with those fields empty.

#### Find a listing by address

Put full addresses into **Postal addresses**. Zoopla resolves each one itself, the Actor picks the exact house number (`81 Willis Road` never becomes `83 Willis Road`) and scrapes the listing advertised there. An address nobody advertises, or one Zoopla does not know, ends as a failed request with a message saying which, and the other addresses are unaffected. Costs at least two extra pages per address (up to 15 more when the number is far down a long street or only its postcode lists it: `81 Willis Road` sits on the second page of its street).

#### Several searches in one run

Fill `locations` and / or `searchQueries`: the Actor runs one search per keyword × area (3 keywords × 4 areas = 12 searches, up to 500 per run). The single `location` field still works and is added to the list. A listing found by several searches is saved — and charged — once; `searchUrl` and `searchLabel` tell which search found it. Set `maxItemsPerQuery` to give every search its own cap: without it the first searches can use up the whole `maxItems` budget. You can also paste several search URLs into `startUrls`: each one is a search of its own, with the same cap.

#### More than 1,000 listings

Zoopla never shows more than 40 pages (1,000 listings) for one search. When a search has more and you ask for more, the Actor replaces it by price bands (same area, same filters), each under the cap, split again if needed; the counters and `searchUrl` stay those of your search, and the `SEARCH_STATS` record of the key-value store gives, per search, the total announced by Zoopla, the number of price bands and the listings saved. A search sorted newest first is read first and only split once its 1,000 newest listings are used: your first rows are the newest ones, and a daily monitor never pays for bands it does not need. A search sorted by price stays in that order: its bands are read cheapest (or dearest) first.

#### Monitoring: only the new listings

Tick **Only new listings** (`onlyNew`) and schedule the Actor. The first run returns everything; each later run skips the listings already delivered: they are not saved, not charged, and (for a search, a listing ID or a listing URL) their page is not even opened; for a postal address, the listing page is read and then dropped, without any charge. The memory lives in a named key-value store of your account (`zoopla-listings-scraper-seen`, up to 150,000 listings per key) and is only updated with listings that really reached the dataset, so a failed run never hides anything. Give each schedule its own `stateKey` (two schedules sharing a key would hide each other's listings), and tick `resetState` once to start over. With the default newest-first sort, a search stops once it meets 50 listings in a row that you already have (two results pages) — or, when `maxItems` / `maxItemsPerQuery` is smaller, 80% of that cap in all, since a previous run never delivered more and some of its listings have been sold since — and the older listings below that point are neither saved nor charged. 'Back to market' listings placed back at the top do not stop it, and the sponsored listings are not counted. With another sort, a search stops after 20 results pages in a row where every listing was already delivered (one new listing on a page starts the count again): a new listing placed further down is not found. A listing your filters drop is checked (and charged the filter check) once: the next runs with the same filters skip it for free; change a filter, or tick `resetState`, to check them again.

#### Filter by publication date

`postedAfter` and `postedBefore` take a date (`2026-09-01`, the whole day is included, UK time) or a period before now (`7 days`, `2 weeks`, `1 month`; via the API also `24 hours` or a full ISO date-time). The filter reads `publishedOn`, the date the listing went live: day by day on the listing card, to the second on the listing page. 'Back to market' listings keep their first date. A listing without a date is dropped as soon as a bound is set. Filtered-out listings are not saved and do not count in `maxItems`; each listing a filter of the Actor drops costs a filter fee, a kept one its normal price; the run summary tells how many were filtered. With `postedAfter`, the Actor also narrows the search with Zoopla's own "added in the last N days" filter and, sorted newest first, stops at the first page that is entirely too old.

### 🔌 Integrations and API

Call the Actor via the Apify API, the JavaScript or Python clients, or connect it with integrations and webhooks (Make, Zapier, n8n, Google Sheets, Slack, Airtable…). The dataset can be fetched as JSON or CSV from any tool. Failed requests and listings removed while the run read them, if any, are listed in the `FAILED_REQUESTS` record of the run's key-value store, and `SEARCH_STATS` sums up every search.

### 🤖 Use with AI agents (MCP)

AI agents (Claude, ChatGPT, Cursor…) can find and run this Actor through the [Apify MCP server](https://mcp.apify.com), billed to their Apify account like any run. It returns one item per Zoopla property listing. Actor id: `nice_dev/zoopla-listings-scraper`; MCP server with this Actor only: `https://mcp.apify.com/?tools=fetch-actor-details,nice_dev/zoopla-listings-scraper`.

Smallest input, for a cheap first call:

```json
{
    "location": "London",
    "maxItems": 10
}
```

Key output fields: `url`, `price`, `address`, `postcode`, `bedrooms`, `bathrooms`, `agentName` and `agentPhone`.

Cost: $0.89 per 1,000 listings, details included, plus $0.01 per run start ($0.72 per 1,000 on the Gold plan). The filters of the Actor, the agency e-mail option and the sold prices (`sold-history`) cost extra, see the pricing section above. Cap each call with `maxItems` and, through the API, with the run option `maxTotalChargeUsd`.

### ❓ FAQ

#### Is it legal to scrape Zoopla?

The Actor only reads what Zoopla shows publicly to any anonymous visitor: listings published by estate agents and developers, and what those agencies publish about themselves (office, website, staff names and roles), never anything about private sellers or buyers. With **Find the agency's e-mail**, it also reads a few public pages of the agency's own website (home, contact, legal notice), the way any visitor would. It logs in to nothing and fills no contact form. The sold prices come from HM Land Registry data that Zoopla republishes; the "Zoopla estimate" is not in the output. Results can contain personal data, which is protected by GDPR: staff names and e-mail addresses such as `firstname.lastname@agency.co.uk` are personal data, the agency options that collect them are off by default, and the rules for business e-mail prospecting in the UK apply to you. You are responsible for using the data in compliance with Zoopla's Terms of Use and applicable law. This Actor is not affiliated with Zoopla.

#### Does it need a login or a proxy?

No login. The Actor uses UK residential IPs, included in the price: leave the default proxy setting (**No proxy**, a country or a proxy group other than residential chosen in the form is ignored; the Apify residential group is refused). If you use your own proxies, they should be residential: Zoopla turns away most proxy addresses of hosting providers. A request the site turns away is retried at once on a new proxy session (without a proxy, after a pause of 5 seconds, doubled at each retry up to 150 seconds). If the log shows `Blocked` / `Rate-limited` lines and the run ends with fewer listings than expected, lower `maxRequestsPerMinute`.

**Apify free plan:** the included proxy is for paying Apify plans only. On the free plan, add your own proxy URLs in **Proxy configuration**; without them the run stops at once with a message saying so.

#### Is the data safe to open in Excel or to show on a web page?

Titles and descriptions are the sellers' own words, copied as they are. A text can begin with `-`, `+`, `=` or `@` (a feature line starting with `-`, a price cut written `-5%`): Excel and Google Sheets may read such a cell of a CSV file as a formula or as a number. The Actor leaves the text as it is, so that the JSON and the API give the real value: when you open a CSV, import these columns as text. Phone numbers keep the shape Zoopla gives them (`020 8022 3223`), so a spreadsheet does not eat the leading zero. Every URL field (`url`, `images`, `floorPlans`, `brochures`, `virtualTours`, `videos`, `agentLogo`, `agentWebsite`, `epcPdf`…) holds an `http(s)` address or `null` — never a `javascript:` or `data:` value — so you can put them straight in a link or an image. On a web page, escape every other field like any text written by a stranger.

#### Known limitations

- Price bands cannot hold listings without an asking price (POA): in a search split into bands, those beyond Zoopla's first 1,000 results may be missed. A band that still holds more than 1,000 listings after six splits (hundreds of homes at the exact same price) is read up to 1,000.
- Points of interest (schools, parks), view counts and the Zoopla estimate are not in the output: Zoopla's pages do not give them to an anonymous visitor (sold prices and past adverts are, with **Add sold prices and past adverts**). Zoopla shows no agency e-mail either: `agentEmail` comes from the agency's own website, and is empty when that site shows no address in its HTML.
- Since October 2026 Zoopla prints neither the house number nor the UPRN on its listing pages. `propertyNumberOrName` and `uprn` are filled with **Add sold prices and past adverts** or for a listing found by **Postal addresses**, and only when the exact address is proven: about 1 listing in 5 with the option. `streetName` stays empty when the address shown names a building or a development rather than a street.
- A listing read without its results card (a pasted listing URL, a listing id, a postal address) has `summaryDescription`, `isPremium`, `underOffer`, `priceDropPercent`, `lastPriceChange` and `availableFrom` set to `null`: only the card gives them. Every other field is the same whichever way the listing was found.
- The detail fields (`postcode`, `description`, `tenure`, `councilTaxBand`, `serviceCharge`, `deposit`, `epcRating`, `transports`, `priceHistory`, all photos, `floorPlans`, `brochures`, `administrationFees`, `virtualTours`, `videos`, `streetView`) are `null` or empty when `extractDetails` is off.
- `priceHistory` gives the dates of the price changes and whether each was a drop or a rise; Zoopla no longer sends the amounts on its listing pages (`priceDropPercent` from the card still gives the last drop).
- `onlyNew` remembers listing ids, not their content: a listing whose price changed is not returned again. With the newest-first sort, what lies under 50 delivered listings in a row (80% of a smaller `maxItems` / `maxItemsPerQuery`, counted in all) is not read (that is the point of a monitor).
- Two runs sharing the same `stateKey` at the same time may both return the same new listing.
- `excludeKeywords` words found only in the descriptions are checked on the listing page: if 300 listing pages in a row are dropped, the run stops (the words leave out almost everything) instead of reading thousands of pages for nothing.
- A run with 0 listings and failed requests ends as **failed**: an empty search is a success, a blocked run is not.

**A run that reaches its timeout** stops itself about 45 seconds before it: no new page is asked, what it read is saved and, with `onlyNew`, remembered, and the run ends *Succeeded* with "Stopped before the run's timeout". Resurrect it to go on from there, or give the next run a longer timeout (Run options).

**A run the platform stops without warning** (out of memory)

- Resurrect it: it goes on from where it stood at most a minute before the stop. What it had read since is read again, and the listings already saved are skipped: none is delivered or charged twice, and `maxItems` still counts them.
- With **Only new listings**, the memory is saved after each write (at most once every 2 seconds): resurrect the stopped run and the listings it had saved meanwhile join the memory; leave it stopped for good, and the next run may return the listings of its last 2 seconds once more.

#### Something doesn't work?

The last line of the log counts the listings saved, filtered out and no longer on Zoopla (removed while the run was reading them), and the requests that failed after every retry. Those requests and the removed listings are listed, with the reason, in the `FAILED_REQUESTS` record of the run's key-value store. A run that saved nothing and had failed requests fails, and its last message gives the cause (a search URL that does not exist, or an area Zoopla does not know, says so instead of "run it again"). A run that saved some listings fails too when at least as many requests failed for good as were read (results, listing, property, agency and address pages alike): a green run with a short dataset would hide the outage. One failed request among many is only a warning.

If Zoopla changes its pages, you are told instead of paying for blank rows. A results page that counts listings but gives none the Actor can read is an error (listed in `FAILED_REQUESTS`), never a quiet "No listings found". If the first 20 listings read all lack their title, price, address, GPS position, agent, publication date or — with `extractDetails` — description or postcode, the run saves nothing more, stops and fails, and its last message names the missing field: at most those first listings are charged. A listing that `postedAfter` / `postedBefore` drops because it has no date at all counts among those 20. A run of fewer listings (a scheduled `onlyNew` run that finds a few new ones, a small **Max listings**) is checked at its end, from 5 listings: its listings are already saved, and the run fails with the missing field instead of ending green.

### 🛟 Support

Open an issue in the **Issues** tab with a link to your run: the run log and the `FAILED_REQUESTS` record of the key-value store show exactly which URLs failed and why.

# Actor input Schema

## `startUrls` (type: `array`):

Zoopla search-result URLs (`https://www.zoopla.co.uk/for-sale/property/london/?beds_min=2`: all filters set on the site are kept, pagination is automatic) or single listing URLs (`https://www.zoopla.co.uk/for-sale/details/74247423/`). When this list (or **Listing IDs**) is not empty, the search fields below are ignored. Max 1 000 URLs.

## `location` (type: `string`):

Area name, town, London district, county, outcode or postcode, e.g. `London`, `Hampstead`, `Greater Manchester`, `SW1A`, `E8`, `Leeds, West Yorkshire`. Names are matched against Zoopla's own list of 9 000+ search areas; ambiguous names (`Leeds`) get a clear message listing the candidates. You can also paste the area path from a Zoopla URL (`west-yorkshire/leeds`).

## `locations` (type: `array`):

Several areas in one run, same format as **Location** (added to it): one search per area, and per keyword when **Keywords** is set (3 keywords × 4 areas = 12 searches, max 500). A listing found by two searches is saved once.

## `listingType` (type: `string`):

For sale, to rent, or new-build homes for sale.

## `propertyType` (type: `string`):

Zoopla category. `property` = all types. For finer types (detached, terraced, park home…) use **Property sub-types**.

## `maxItems` (type: `integer`):

Maximum number of listings to save (after deduplication), all searches together. 0 = no limit. Zoopla shows at most 1 000 results per search: a bigger search is split into price bands automatically.

## `maxItemsPerQuery` (type: `integer`):

Cap for EACH search (keyword × location, or search URL), so that the first search cannot use up the whole **Max listings** budget. 0 = no per-search cap.

## `priceMin` (type: `integer`):

Minimum asking price (sale) or rent (rent: per month, or per week with **Rent price per**), in GBP.

## `priceMax` (type: `integer`):

Maximum asking price (sale) or rent (rent: per month, or per week with **Rent price per**), in GBP.

## `bedsMin` (type: `integer`):

Minimum number of bedrooms (0 = studio).

## `bedsMax` (type: `integer`):

Maximum number of bedrooms.

## `extractDetails` (type: `boolean`):

Open each listing page (1 extra request per listing) for the full postcode, street, full description, key features, tenure and lease length, council tax band, service charge, deposit, EPC rating and graph, nearest stations with distances, price history, all photos, floor plans and brochures. Off = listing-card fields only (2× faster, same price).

## `searchQueries` (type: `array`):

Keyword searches inside the location(s): each entry is one search (`garage`, `garden`), several words in one entry must all be in the listing (`garage garden`). Zoopla's syntax works: quotes for a phrase (`"double garage"`), a minus sign to exclude a word (`-auction`).

## `radius` (type: `string`):

Also include listings around the area, up to this distance.

## `bathsMin` (type: `integer`):

Minimum number of bathrooms.

## `bathsMax` (type: `integer`):

Maximum number of bathrooms.

## `propertySubTypes` (type: `array`):

Only these kinds of property (any of them). Empty = all.

## `mustHave` (type: `array`):

Only listings that have ALL of these.

## `tenure` (type: `array`):

Only listings with one of these tenures. Empty = all.

## `floorAreaMin` (type: `integer`):

Minimum internal floor area, in the unit of **Floor area unit**. Listings without a floor area are left out by the site when a bound is set.

## `floorAreaMax` (type: `integer`):

Maximum internal floor area, in the unit of **Floor area unit**.

## `floorAreaUnit` (type: `string`):

Unit of **Min floor area** / **Max floor area**.

## `sortBy` (type: `string`):

`NEWEST` (default) returns each listing once and is the best choice for monitoring (it also lets **Only new listings** and **Posted after** stop reading early). Zoopla's own 'recommended' order repeats about 20 % of listings between pages (they are deduplicated, but fewer new listings per page).

## `addedWithin` (type: `string`):

Only listings added to Zoopla in the last N days (Zoopla's own filter; for any other period use **Posted after**).

## `chainFree` (type: `boolean`):

Only listings advertised with no onward chain. Sale searches only.

## `reducedPriceOnly` (type: `boolean`):

Only listings whose price has been reduced.

## `auction` (type: `string`):

Include, show only, or leave out properties sold at auction. Sale searches only.

## `sharedOwnership` (type: `string`):

Include, show only, or leave out shared-ownership homes. Sale and new-homes searches only.

## `retirementHomes` (type: `string`):

Include, show only, or leave out retirement homes. `Only` uses Zoopla's retirement section: it cannot be combined with **Property type** (use **Property sub-types**).

## `includeSold` (type: `boolean`):

Sale searches: also list the properties Zoopla marks as sold or sold subject to contract. Measured in Bristol on 2026-09-17: 3,850 listings without it, 7,123 with it.

## `newHomes` (type: `string`):

Keep new-build listings (default), take only them, or leave them out. Measured in Bristol: 3,850 listings with them, 3,651 without.

## `latitude` (type: `number`):

Search around a GPS point instead of a place name: Zoopla is asked for the circle of "Radius around the point" miles around it. Fill both latitude and longitude.

## `longitude` (type: `number`):

Longitude of the point to search around (with "Latitude").

## `aroundRadiusMiles` (type: `number`):

Half-width of the circle built around the GPS point, in miles (0.05 to 50).

## `polygon` (type: `array`):

The corners of the area to search in, as \[{"latitude": 51.44, "longitude": -2.63}, ...] (3 to 200 points; \[\[lat, lng], ...] works too). Zoopla then ignores the place name and answers only what falls inside the shape.

## `includeHistory` (type: `boolean`):

Reads up to three more pages per listing to add what its address sold for before (HM Land Registry), the times it was advertised on Zoopla, its UPRN and its house number or name. Zoopla no longer prints the exact address on its listing pages: only listings the Actor can tie to their address for certain get these fields (about 1 sale in 4, 1 rental in 6), never a neighbour's sales. Needs "Extract details". Charged as a separate `sold-history` event, only for listings saved with at least one sale or past advert.

## `includeAgentDetails` (type: `boolean`):

Reads the Zoopla page of each listing's agency — once per agency, whatever the number of its listings — and adds its website, office address and postcode, opening hours, team (names, roles, photos), professional bodies (ARLA, NAEA, TPO…), its figures on Zoopla (listings, average price, weeks on the market) and its social pages. Needs "Extract details". Included in the price of the listing.

## `enrichEmails` (type: `boolean`):

Zoopla shows no agency e-mail (a contact form instead). This visits the website the agency gives on its Zoopla page (home page, then its contact / legal pages, 3 pages at most, once per agency) and adds the addresses published there to `agentEmail` / `agentEmails`. Only the agency's own addresses are kept: those on the domain of its website, or an address (a webmail one included) that carries its name or that of its website; the address of a web agency, a host or a general page is left aside. Reads the agency page too (its details are then filled as well). Slower. Charged as a separate `email-enriched` event, only for listings delivered with at least one e-mail. Needs "Extract details".

## `priceFrequency` (type: `string`):

Unit of **Min price** / **Max price** for rentals (Zoopla converts weekly and monthly rents).

## `furnished` (type: `string`):

Rent searches only.

## `petsAllowed` (type: `boolean`):

Only rentals that accept pets.

## `billsIncluded` (type: `boolean`):

Only rentals with bills included.

## `sharedAccommodation` (type: `string`):

Include, show only, or leave out rooms in shared accommodation.

## `studentAccommodation` (type: `string`):

Include, show only, or leave out student accommodation.

## `includeLetAgreed` (type: `boolean`):

Also return rentals that are already let or let agreed (hidden by Zoopla by default).

## `availableFrom` (type: `string`):

Only rentals available now or within the chosen period.

## `postedAfter` (type: `string`):

Only listings that went live on Zoopla on or after this date: `2026-09-01`, or a period before now such as `7 days`, `2 weeks`, `1 month` (API: `24 hours` and full ISO date-times work too). Read on the listing card (the day, UK time), then to the second on the listing page. Relisted ('Back to market') listings keep their first date. Listings without a date are dropped.

## `postedBefore` (type: `string`):

Only listings that went live on or before this date (the whole day is included), or older than a period such as `30 days`.

## `excludeKeywords` (type: `array`):

Drop the listings whose texts contain one of these WHOLE words (case and accents ignored): title, summary, tags and, with **Extract details**, the full description and key features. `garden` drops a listing tagged "Garden" but not one that only says "Gardens". Several words in one entry (`hand made`) must appear together, in that order.

## `onlyNew` (type: `boolean`):

Skip the listings that a previous run (same **Memory key**) already delivered: they are not saved and not charged, and (for a search, a listing ID or a listing URL) their page is not even opened; for a postal address, the listing page is read and then dropped, without any charge. First run = everything is new.

## `stateKey` (type: `string`):

Name of the memory used by **Only new listings**. Give each schedule / task its own key (e.g. `london-rentals`) so that they do not share their memory. Letters, digits, `-` and `_`.

## `resetState` (type: `boolean`):

Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every listing again. Untick it afterwards.

## `listingIds` (type: `array`):

Zoopla listing ids (the number in `/for-sale/details/74247423/`), for sale, to rent or new homes. When this list (or **Start URLs**) is not empty, the search fields are ignored.

## `propertyAddresses` (type: `array`):

Find the listing of a precise address. Zoopla resolves the text itself, then the Actor opens the property page and scrapes the listing advertised there, if there is one. Costs at least two extra pages per address (up to 15 more when the number is far down a long street or only its postcode lists it), and answers a clear error when the address is unknown or nothing is advertised at it. Max 200 addresses.

## `proxyConfiguration` (type: `object`):

Keep **Apify Proxy**: the Actor then uses UK residential IPs, included in the price (**No proxy**, the country and a proxy group other than residential chosen here are ignored; the Apify residential group is refused). Your own proxies (`proxyUrls`) should be residential: Zoopla turns away most proxy addresses of hosting providers. On the Apify free plan the included proxy is not available: add your own proxy URLs, or the run stops at once with a message.

## `maxConcurrency` (type: `integer`):

Maximum number of requests processed in parallel.

## `maxRequestsPerMinute` (type: `integer`):

Global request rate. Lower it if the site answers HTTP 429 / 403 in the log.

## `maxRequestRetries` (type: `integer`):

Retries per request before it is marked as failed.

## `debugLog` (type: `boolean`):

Include debug messages in the run log.

## Actor input object example

```json
{
  "location": "London",
  "locations": [],
  "listingType": "sale",
  "propertyType": "property",
  "maxItems": 100,
  "maxItemsPerQuery": 0,
  "extractDetails": true,
  "searchQueries": [],
  "radius": "0",
  "propertySubTypes": [],
  "mustHave": [],
  "tenure": [],
  "floorAreaUnit": "sq_feet",
  "sortBy": "NEWEST",
  "addedWithin": "0",
  "chainFree": false,
  "reducedPriceOnly": false,
  "auction": "ANY",
  "sharedOwnership": "ANY",
  "retirementHomes": "ANY",
  "includeSold": false,
  "newHomes": "ANY",
  "aroundRadiusMiles": 1,
  "includeHistory": false,
  "includeAgentDetails": false,
  "enrichEmails": false,
  "priceFrequency": "per_month",
  "furnished": "ANY",
  "petsAllowed": false,
  "billsIncluded": false,
  "sharedAccommodation": "ANY",
  "studentAccommodation": "ANY",
  "includeLetAgreed": false,
  "availableFrom": "ANY",
  "excludeKeywords": [],
  "onlyNew": false,
  "stateKey": "default",
  "resetState": false,
  "listingIds": [],
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "maxConcurrency": 8,
  "maxRequestsPerMinute": 120,
  "maxRequestRetries": 5,
  "debugLog": false
}
```

# Actor output Schema

## `results` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "location": "London",
    "aroundRadiusMiles": 1,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nice_dev/zoopla-listings-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "location": "London",
    "aroundRadiusMiles": 1,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("nice_dev/zoopla-listings-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "location": "London",
  "aroundRadiusMiles": 1,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call nice_dev/zoopla-listings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nice_dev/zoopla-listings-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/We3vkqv7gAtesjaof/builds/wOWNBbujg2gNHhuBk/openapi.json
