# Zoopla Scraper — UK Property API · Sale + Rent + Valuations (`sian.agency/zoopla-property-scraper`) Actor

🇬🇧 Stable, API-backed Zoopla scraper for UK property data — sale + rent listings, valuation estimates (sale & rent), market KPIs (median price, £/sqft, area breakdowns), HTML report. Bulk-location PAID. Independent tool — not affiliated with Zoopla / ZPG.

- **URL**: https://apify.com/sian.agency/zoopla-property-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 property extracteds

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/platform/actors/running/actors-in-store#pay-per-event

## 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 Property Scraper — UK Real Estate API · Sale + Rent + Valuations

> **Stable, API-backed UK property data from Zoopla.** For-sale + to-rent listings across England, Scotland, Wales and Northern Ireland — search by location, postcode, coordinates, or pasted Zoopla URL. Per-listing valuation estimates (sale + rent), built-in market KPIs (median price, £/sqft, area breakdowns), and an HTML report. Built on a stable upstream tier so your scrapes don't break when Zoopla rotates its layout — and so UK property data extraction is just an API call, not a maintenance project.

By [SIÁN Agency](https://apify.com/sian.agency?fpr=sian) · Independent tool — **not affiliated with Zoopla or Zoopla Property Group (ZPG)**.

---

### 🚀 What you get on every run

- **Structured listings** — propertyId, full address, GBP price, beds/baths/receptions, sqft, lat/lon, photos, estate-agent branch
- **For-sale + to-rent in one call** — set `listingType: both` (PAID) and get both sides of the market in a single dataset
- **Auto-computed £/sqft** — for every sale listing with usable floor area
- **Market KPIs** — median price, price-distribution stats, area + property-type breakdowns, surfaced in a polished HTML report
- **Valuation estimates** (optional, PAID) — sale + rent estimate with confidence band per listing
- **Retry-helper record** — even on partial failures you get a JSON summary of what failed so you can rerun cheaply

---

### 🎯 Built for

- **Buy-to-let investors** — pull comparables (UK comps) for underwriting in seconds; compute yield from `listingType: both` runs
- **Estate agents** — track local rent and sale trends across postcode areas
- **Mortgage brokers** — generate 100-listing comp sets for valuation reports
- **PropTech teams** — feed your AVM / rent-prediction models with consistent UK training data
- **Investment funds** — schedule weekly sweeps of London / Manchester / Birmingham micro-markets

---

### 🧭 5 search modes

| Mode | Best for |
|---|---|
| **By location** | Free-text — "Hampstead, London", "Oxford", "NW3" |
| **By postcode** | UK postcode outward code (`NW3`, `SW1A`, `M1`, `EC1A`) |
| **By coordinates** | Lat/lon + radius (miles) — e.g. for map-based UI |
| **By URL** | Paste any Zoopla search URL — filters auto-read from the URL |
| **Bulk locations** (PAID) | Sweep an array of locations in one run |

All modes share the same UK filter set: property type, tenure (freehold/leasehold/share-of-freehold), price/beds/baths/sqft ranges, new homes, chain-free, furnished state, pets allowed, bills included, and free-text keywords.

---

### 💰 Transparent pricing

Pay-per-event — no monthly subscription, no per-page overhead. **Charged only on successful extraction.** Apify subscription discounts apply automatically (Starter ≈ 67% off · Scale ≈ 71% off · Business ≈ 75% off vs Free).

| Event | Free | Starter | Scale | Business | Triggered when |
|---|---|---|---|---|---|
| Run started | $0.050 | $0.005 | $0.005 | $0.005 | Once per run |
| Property extracted | $0.015 | $0.005 | $0.0045 | $0.004 | Per listing successfully pushed to dataset |
| Valuation enriched | — | $0.003 | $0.0027 | $0.0024 | Per successful estimate (only when `includeEstimates: true`) |

**Free tier** is built for low-volume testing — capped at 5 queries / 25 listings per run, no enrichment, no `listingType: both`.
**Paid tiers (Starter and up)** unlock unlimited listings, bulk locations, valuation enrichment, and `listingType: both`.

---

### 📦 Sample output (sale)

```json
{
  "propertyId": "73109201",
  "listingType": "sale",
  "url": "https://www.zoopla.co.uk/for-sale/details/73109201/",
  "thumbnailUrl": "https://lid.zoocdn.com/645/430/...jpg",
  "propertyTitle": "3 bed flat for sale",
  "address": { "full": "Lancaster Grove, Belsize Park, London NW3" },
  "pricing": {
    "price": 1850000,
    "priceCurrency": "GBP",
    "priceDisplay": "£1,850,000",
    "priceShort": "£1.85m",
    "pricePerSqft": 1390
  },
  "specs": { "beds": 3, "baths": 2, "receptions": 1, "sizeSqft": 1331 },
  "location": { "latitude": 51.54644, "longitude": -0.171423 },
  "branch": {
    "name": "ADN Residential",
    "phone": "020 8128 2227",
    "branchUrl": "https://www.zoopla.co.uk/find-agents/branch/adn-residential-london-159325/"
  },
  "tags": ["Share of Freehold"],
  "scrapedAt": "2026-05-05T17:05:43.123Z"
}
````

> **Note on `tags`:** This array always exists on every record (empty `[]` when the listing has no tags). On for-sale listings it typically carries the tenure label (`Freehold`, `Leasehold`, `Share of Freehold`); on rental listings it's usually empty. Filter `tenure` is supported as an *input* parameter, but tenure is reported on output as a string inside `tags[]`, not as its own structured field.

With `includeEstimates: true` (PAID), each listing additionally carries:

```json
{
  "estimate": {
    "uprn": "5068790",
    "saleEstimate": { "current": 2216000, "lower": 1994000, "upper": 2438000, "confidence": "MEDIUM" },
    "rentEstimate": null
  }
}
```

***

### ⚙️ Quick start

1. **Click "Try for free"** above — paste any UK location, postcode, or Zoopla URL.
2. **Run.** First 25 listings are free.
3. **Check the dataset** for your structured listings, and the **HTML report** in the key-value store for market KPIs.

For automation: schedule via Apify's built-in scheduler, or call our REST API with your Apify token.

***

### ❓ FAQ

**Does this work for sold prices?**
v1 supports live for-sale and to-rent listings only. Sold-price history is on the v0.2 roadmap.

**Can I scrape estate agent details?**
Not in v1 — we focus on property listings. A separate `zoopla-agent-scraper` is on the roadmap.

**What about Northern Ireland / Scotland?**
Zoopla covers all four UK nations; this actor inherits that coverage.

**Why outward postcodes instead of full postcodes?**
Zoopla's slug-based search treats `NW3 1AA` as one literal — it usually returns 0 results. Outward codes (`NW3`, `SW1A`) resolve to area slugs and return real inventory. We auto-strip the inward code if you paste a full postcode.

**Can I get the estate agent's email?**
Branch name, phone, logo and Zoopla branch-URL are returned. Email is not exposed by Zoopla's public surface.

***

### ⚠️ Trademark Disclaimer

This Actor is an independent tool and is **not affiliated with, endorsed by, or sponsored by Zoopla, Zoopla Property Group (ZPG), or any of its subsidiaries**. "Zoopla" is used solely in a descriptive sense to identify the public data source the Actor reads from. All trademarks are the property of their respective owners.

***

### 📚 Legal & Scraping Notes

- This actor reads only **publicly visible** Zoopla pages — no logins, no bypassing of paywalls.
- You are responsible for complying with Zoopla's Terms of Service and applicable UK / EU data laws (UK GDPR, Data Protection Act 2018) when using the data.
- Personal data of estate agents (e.g. branch phone) is included only as published on Zoopla's public site.

***

### 🧰 More from SIÁN Agency

- 🏙️ [StreetEasy NYC Property Scraper](https://apify.com/sian.agency/streeteasy-property-scraper?fpr=sian)
- 🏠 [Zillow Property Scraper](https://apify.com/sian.agency/zillow-property-scraper?fpr=sian)
- ✈️ [Airbnb STR-Investor Scraper](https://apify.com/sian.agency/airbnb-property-scraper?fpr=sian)
- 🌐 [Browse all SIÁN Agency actors →](https://apify.com/sian.agency?fpr=sian)

# Actor input Schema

## `searchMode` (type: `string`):

How to specify what to scrape.

• **bylocation** — free-text UK location (town, neighbourhood, postcode area)
• **byzip** — UK postcode (outward code preferred — e.g. NW3, SW1A)
• **bycoordinates** — latitude + longitude + radius (miles)
• **byurl** — paste a Zoopla search URL — filters are read from the URL
• **bulklocations** — array of locations in one run (PAID)

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

Which side of the UK market to scrape.

• **sale** — properties for sale
• **rent** — properties to rent
• **both** — runs each query twice — sale + rent (PAID)

Note: ignored when Search Mode = byurl (the URL itself encodes whether it's a for-sale or to-rent search).

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

Free-text UK location — neighbourhood, town, county, region, postcode area, or full address.

Examples: `London`, `Hampstead, London`, `Camden`, `Oxford, Oxfordshire`, `NW3`

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

Array of UK location strings to sweep in one run. PAID tier only.

## `postalCode` (type: `string`):

UK postcode — **outward code preferred** (the part before the space).

Full postcodes like `NW3 1AA` may return 0 results — outward codes (`NW3`, `SW1A`, `M1`, `EC1A`) resolve to area slugs.

Examples: `NW3`, `SW1A`, `EC1A`, `M1`, `OX1`

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

Latitude in decimal degrees. London centre ≈ `51.5074`.

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

Longitude in decimal degrees. Negative = west of Greenwich. London centre ≈ `-0.1278`.

## `zooplaUrl` (type: `string`):

Paste any search/filter URL from the Zoopla site.

Examples:

- `https://www.zoopla.co.uk/for-sale/property/london/?price_min=500000&beds_min=2`
- `https://www.zoopla.co.uk/to-rent/property/manchester/?price_max=1500&furnished_state=furnished`

## `radius` (type: `number`):

Search radius around the location/postcode/coordinates, in miles. Allowed: 0, 0.25, 0.5, 1, 3, 5, 10, 20, 40. Default: 1.

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

Comma-separated UK property types. Leave empty to include all.

Allowed: `flat, house, bungalow, terraced, semi_detached, detached, land, park_home, farm`

Examples: `flat`, `house,bungalow`, `terraced,semi_detached`

## `priceRange` (type: `string`):

Price range in GBP. Format: `min:N`, `max:N`, or `min:N,max:N`.

For sale: total price. For rent: monthly rent (pcm).

Examples: `min:500000,max:1500000`, `max:2000`, `min:300000`

## `bedsRange` (type: `string`):

Bedroom range. Studio = `min:0`. Format: `min:N`, `max:N`, or `min:N,max:N`.

Examples: `min:2`, `min:3,max:3`, `min:2,max:5`

## `bathsRange` (type: `string`):

Bathroom range. Format: `min:N`, `max:N`, or `min:N,max:N`.

## `sizeSqftRange` (type: `string`):

Floor-area range in square feet. Format: `min:N`, `max:N`, or `min:N,max:N`.

## `tenure` (type: `string`):

UK property tenure. Leave empty for any.

• **freehold** — own the building and the land
• **leasehold** — own the property for a fixed term
• **share\_of\_freehold** — leasehold + share in the building's freehold company

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

New-build filter.

• **(any)** — Zoopla default (include new builds)
• **false** — exclude new builds
• **only** — only new builds

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

Furnishing state — only used when listingType = rent.

## `keywords` (type: `string`):

Free-text amenity keywords matched against listing descriptions.

Examples: `garden`, `parking`, `period features`, `garden parking`

## `sortOrder` (type: `string`):

How results are sorted. Default: Newest.

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

Return only chain-free listings (no onward chain — common for new builds, executor sales, repossessions).

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

Also include sold-STC / under-offer listings alongside live ones.

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

Return only pet-friendly rentals.

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

Return only rentals with bills included in rent.

## `includeRented` (type: `boolean`):

Also include let-agreed / already-rented listings alongside live ones.

## `maxResults` (type: `integer`):

Hard cap on listings returned per query. Auto-paginates until the cap is reached or the search is fully drained. Default 25 = one API page. FREE tier is always capped at 25 listings per run.

## `includeEstimates` (type: `boolean`):

When ON, fetches sale + rent valuation estimates for each listing (1 extra API call per listing). Adds an estimate-enriched charge per successful enrichment. Disabled on FREE tier.

Note: works best when listings have a clear UK postcode in the address. Listings without a resolvable address are silently skipped (no charge).

## Actor input object example

```json
{
  "searchMode": "bylocation",
  "listingType": "sale",
  "location": "Hampstead, London",
  "postalCode": "NW3",
  "latitude": 51.5074,
  "longitude": -0.1278,
  "radius": 1,
  "tenure": "",
  "newHomes": "",
  "furnished": "",
  "sortOrder": "",
  "chainFree": false,
  "includeSold": false,
  "petsAllowed": false,
  "billsIncluded": false,
  "includeRented": false,
  "maxResults": 25,
  "includeEstimates": false
}
```

# Actor output Schema

## `results` (type: `string`):

Structured Zoopla sale and rent listings with calculated £/sqft and (optional) valuation estimates.

## `htmlReport` (type: `string`):

HTML summary with run stats, market KPIs (median price, £/sqft distribution), area + property-type breakdowns, and per-query totals.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/zoopla-property-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/zoopla-property-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 '{}' |
apify call sian.agency/zoopla-property-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sian.agency/zoopla-property-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Zoopla Scraper — UK Property API · Sale + Rent + Valuations",
        "description": "🇬🇧 Stable, API-backed Zoopla scraper for UK property data — sale + rent listings, valuation estimates (sale & rent), market KPIs (median price, £/sqft, area breakdowns), HTML report. Bulk-location PAID. Independent tool — not affiliated with Zoopla / ZPG.",
        "version": "1.0",
        "x-build-id": "2akBJatldLUn82xwM"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sian.agency~zoopla-property-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sian.agency-zoopla-property-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/sian.agency~zoopla-property-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sian.agency-zoopla-property-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/sian.agency~zoopla-property-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sian.agency-zoopla-property-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "searchMode": {
                        "title": "🧭 Search Mode",
                        "enum": [
                            "bylocation",
                            "byzip",
                            "bycoordinates",
                            "byurl",
                            "bulklocations"
                        ],
                        "type": "string",
                        "description": "How to specify what to scrape.\n\n• **bylocation** — free-text UK location (town, neighbourhood, postcode area)\n• **byzip** — UK postcode (outward code preferred — e.g. NW3, SW1A)\n• **bycoordinates** — latitude + longitude + radius (miles)\n• **byurl** — paste a Zoopla search URL — filters are read from the URL\n• **bulklocations** — array of locations in one run (PAID)",
                        "default": "bylocation"
                    },
                    "listingType": {
                        "title": "🏠 Listing Type",
                        "enum": [
                            "sale",
                            "rent",
                            "both"
                        ],
                        "type": "string",
                        "description": "Which side of the UK market to scrape.\n\n• **sale** — properties for sale\n• **rent** — properties to rent\n• **both** — runs each query twice — sale + rent (PAID)\n\nNote: ignored when Search Mode = byurl (the URL itself encodes whether it's a for-sale or to-rent search).",
                        "default": "sale"
                    },
                    "location": {
                        "title": "📍 Location  (used when Search Mode = bylocation)",
                        "type": "string",
                        "description": "Free-text UK location — neighbourhood, town, county, region, postcode area, or full address.\n\nExamples: `London`, `Hampstead, London`, `Camden`, `Oxford, Oxfordshire`, `NW3`",
                        "default": "Hampstead, London"
                    },
                    "locations": {
                        "title": "📋 Bulk Locations  (PAID, bulklocations mode)",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Array of UK location strings to sweep in one run. PAID tier only.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "postalCode": {
                        "title": "📮 Postcode  (used when Search Mode = byzip)",
                        "type": "string",
                        "description": "UK postcode — **outward code preferred** (the part before the space).\n\nFull postcodes like `NW3 1AA` may return 0 results — outward codes (`NW3`, `SW1A`, `M1`, `EC1A`) resolve to area slugs.\n\nExamples: `NW3`, `SW1A`, `EC1A`, `M1`, `OX1`"
                    },
                    "latitude": {
                        "title": "🗺 Latitude  (used when Search Mode = bycoordinates)",
                        "type": "number",
                        "description": "Latitude in decimal degrees. London centre ≈ `51.5074`."
                    },
                    "longitude": {
                        "title": "🗺 Longitude  (used when Search Mode = bycoordinates)",
                        "type": "number",
                        "description": "Longitude in decimal degrees. Negative = west of Greenwich. London centre ≈ `-0.1278`."
                    },
                    "zooplaUrl": {
                        "title": "🔗 Zoopla URL  (used when Search Mode = byurl)",
                        "type": "string",
                        "description": "Paste any search/filter URL from the Zoopla site.\n\nExamples:\n- `https://www.zoopla.co.uk/for-sale/property/london/?price_min=500000&beds_min=2`\n- `https://www.zoopla.co.uk/to-rent/property/manchester/?price_max=1500&furnished_state=furnished`"
                    },
                    "radius": {
                        "title": "📏 Search radius (miles)",
                        "minimum": 0,
                        "maximum": 40,
                        "type": "number",
                        "description": "Search radius around the location/postcode/coordinates, in miles. Allowed: 0, 0.25, 0.5, 1, 3, 5, 10, 20, 40. Default: 1.",
                        "default": 1
                    },
                    "propertyType": {
                        "title": "🏘 Property type",
                        "type": "string",
                        "description": "Comma-separated UK property types. Leave empty to include all.\n\nAllowed: `flat, house, bungalow, terraced, semi_detached, detached, land, park_home, farm`\n\nExamples: `flat`, `house,bungalow`, `terraced,semi_detached`"
                    },
                    "priceRange": {
                        "title": "💷 Price range (GBP)",
                        "type": "string",
                        "description": "Price range in GBP. Format: `min:N`, `max:N`, or `min:N,max:N`.\n\nFor sale: total price. For rent: monthly rent (pcm).\n\nExamples: `min:500000,max:1500000`, `max:2000`, `min:300000`"
                    },
                    "bedsRange": {
                        "title": "🛏 Bedrooms",
                        "type": "string",
                        "description": "Bedroom range. Studio = `min:0`. Format: `min:N`, `max:N`, or `min:N,max:N`.\n\nExamples: `min:2`, `min:3,max:3`, `min:2,max:5`"
                    },
                    "bathsRange": {
                        "title": "🛁 Bathrooms",
                        "type": "string",
                        "description": "Bathroom range. Format: `min:N`, `max:N`, or `min:N,max:N`."
                    },
                    "sizeSqftRange": {
                        "title": "📐 Floor area (sqft)",
                        "type": "string",
                        "description": "Floor-area range in square feet. Format: `min:N`, `max:N`, or `min:N,max:N`."
                    },
                    "tenure": {
                        "title": "📜 Tenure",
                        "enum": [
                            "",
                            "freehold",
                            "leasehold",
                            "share_of_freehold"
                        ],
                        "type": "string",
                        "description": "UK property tenure. Leave empty for any.\n\n• **freehold** — own the building and the land\n• **leasehold** — own the property for a fixed term\n• **share_of_freehold** — leasehold + share in the building's freehold company",
                        "default": ""
                    },
                    "newHomes": {
                        "title": "🏗 New homes filter",
                        "enum": [
                            "",
                            "false",
                            "only"
                        ],
                        "type": "string",
                        "description": "New-build filter.\n\n• **(any)** — Zoopla default (include new builds)\n• **false** — exclude new builds\n• **only** — only new builds",
                        "default": ""
                    },
                    "furnished": {
                        "title": "🛋 Furnished state (rent only)",
                        "enum": [
                            "",
                            "furnished",
                            "unfurnished",
                            "part_furnished"
                        ],
                        "type": "string",
                        "description": "Furnishing state — only used when listingType = rent.",
                        "default": ""
                    },
                    "keywords": {
                        "title": "🔑 Free-text keywords",
                        "type": "string",
                        "description": "Free-text amenity keywords matched against listing descriptions.\n\nExamples: `garden`, `parking`, `period features`, `garden parking`"
                    },
                    "sortOrder": {
                        "title": "🔃 Sort order",
                        "enum": [
                            "",
                            "Newest",
                            "Price_High_to_Low",
                            "Price_Low_to_High",
                            "Most_Reduced"
                        ],
                        "type": "string",
                        "description": "How results are sorted. Default: Newest.",
                        "default": ""
                    },
                    "chainFree": {
                        "title": "🔓 Chain-free only (sale)",
                        "type": "boolean",
                        "description": "Return only chain-free listings (no onward chain — common for new builds, executor sales, repossessions).",
                        "default": false
                    },
                    "includeSold": {
                        "title": "📌 Include sold-STC / under-offer (sale)",
                        "type": "boolean",
                        "description": "Also include sold-STC / under-offer listings alongside live ones.",
                        "default": false
                    },
                    "petsAllowed": {
                        "title": "🐾 Pets allowed only (rent)",
                        "type": "boolean",
                        "description": "Return only pet-friendly rentals.",
                        "default": false
                    },
                    "billsIncluded": {
                        "title": "💡 Bills included only (rent)",
                        "type": "boolean",
                        "description": "Return only rentals with bills included in rent.",
                        "default": false
                    },
                    "includeRented": {
                        "title": "🏠 Include let-agreed (rent)",
                        "type": "boolean",
                        "description": "Also include let-agreed / already-rented listings alongside live ones.",
                        "default": false
                    },
                    "maxResults": {
                        "title": "📊 Max results per query",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Hard cap on listings returned per query. Auto-paginates until the cap is reached or the search is fully drained. Default 25 = one API page. FREE tier is always capped at 25 listings per run.",
                        "default": 25
                    },
                    "includeEstimates": {
                        "title": "💷 Include valuation estimates (PAID)",
                        "type": "boolean",
                        "description": "When ON, fetches sale + rent valuation estimates for each listing (1 extra API call per listing). Adds an estimate-enriched charge per successful enrichment. Disabled on FREE tier.\n\nNote: works best when listings have a clear UK postcode in the address. Listings without a resolvable address are silently skipped (no charge).",
                        "default": false
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```