Zoopla API
Zoopla street estimates
Every address along one street with the portal's sale estimate, its attributes and its recorded sales, plus the street's market line (average price paid, properties sold).
Endpoint
/v1/zoopla/estimateslive · proven3 creditsParameters
Query parameters
| Name | Required | Description | Example |
|---|---|---|---|
path | yes | A street path from zoopla/streets or zoopla/area | london/oxford-road-se19 |
page | no | Page number | 1 |
limit | no | Addresses per page, 1 to 50 | 12 |
dry_run | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. | 1 |
Examples
Make the request
curl "https://www.monocrawl.com/v1/zoopla/estimates?path=london%2Foxford-road-se19" \ -H "x-api-key: mn_your_key_here"
TypeScript
const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
"https://www.monocrawl.com/v1/zoopla/estimates?path=london%2Foxford-road-se19",
{ headers: { "x-api-key": key } },
);
const body = await res.json();
if (!body.success) {
// one error shape for every endpoint — see /docs/errors
throw new Error(`${body.error.type}: ${body.error.message}`);
}
console.log(body.data, "credits left:", body.credits_remaining);Python
import os
import requests
res = requests.get(
"https://www.monocrawl.com/v1/zoopla/estimates?path=london%2Foxford-road-se19",
headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
timeout=60,
)
body = res.json()
if not body["success"]:
# one error shape for every endpoint — see /docs/errors
raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")
print(body["data"], "credits left:", body["credits_remaining"])Response
Response fields and example
This example is illustrative, not a captured live response. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.
{
"success": true,
"platform": "zoopla",
"endpoint": "/v1/zoopla/estimates",
"data": {
"count": 0,
"cursor": null,
"has_more": false,
"items": [
{
"address": "example",
"attributes": {
"bathrooms": 0,
"bedrooms": 0,
"living_rooms": 0,
"property_type": "example",
"tenure": "example"
},
"historic_listings": [
{}
],
"last_sale": {
"date": "2026-09-01T12:00:00Z",
"price": 0
},
"latitude": 0,
"longitude": 0,
"platform": "example",
"sale_estimate": {
"confidence": "example",
"value": 0
},
"sales": [
{}
],
"type": "example",
"uprn": "example"
}
],
"page": 0,
"street": {
"kind": "example",
"name": "example",
"path": "example",
"short_name": "example"
},
"total": 0
},
"credits_used": 3,
"credits_remaining": 99,
"request_id": "req_…",
"cached": false
}The example is illustrative and shows a documented subset of data. The fields below are optional across supported sources; nullable fields can also be absent. Preserve unknown values and accept additional fields.
Schema basis: observed response shapes, not an exhaustive field specification. See schema coverage and validation limits.
Download the data JSON Schema. Validate response.data, not the whole envelope. A valid shape does not establish that every field or source record was returned.
| Field inside data | Type | Meaning |
|---|---|---|
count | number | null | Number of records in this response, not lifetime or total matches. |
cursor | string | null | Opaque next-page token; pass it back unchanged. Null does not prove complete history. |
has_more | boolean | null | Source continuation indicator; null means unknown. |
items | array | null | Returned records. Source coverage and completeness vary. |
items[].address | string | null | Optional address supplied by this operation. Null means unknown. |
items[].attributes | object | null | Optional attributes supplied by this operation. Null means unknown. |
items[].attributes.bathrooms | number | null | Optional bathrooms supplied by this operation. Null means unknown. |
items[].attributes.bedrooms | number | null | Optional bedrooms supplied by this operation. Null means unknown. |
items[].attributes.living_rooms | number | null | Optional living rooms supplied by this operation. Null means unknown. |
items[].attributes.property_type | string | null | Optional property type supplied by this operation. Null means unknown. |
items[].attributes.tenure | string | null | Optional tenure supplied by this operation. Null means unknown. |
items[].historic_listings | array | null | Optional historic listings supplied by this operation. Null means unknown. |
items[].last_sale | object | null | Optional last sale supplied by this operation. Null means unknown. |
items[].last_sale.date | string | null | Optional date supplied by this operation. Null means unknown. |
items[].last_sale.price | number | null | Source price. Currency, taxes and availability depend on the listing. |
items[].latitude | number | null | Optional latitude supplied by this operation. Null means unknown. |
items[].longitude | number | null | Optional longitude supplied by this operation. Null means unknown. |
items[].platform | string | null | Optional platform supplied by this operation. Null means unknown. |
items[].sale_estimate | object | null | Optional sale estimate supplied by this operation. Null means unknown. |
items[].sale_estimate.confidence | string | null | Optional confidence supplied by this operation. Null means unknown. |
items[].sale_estimate.value | number | null | Optional value supplied by this operation. Null means unknown. |
items[].sales | array | null | Optional sales supplied by this operation. Null means unknown. |
items[].type | string | null | Optional type supplied by this operation. Null means unknown. |
items[].uprn | string | null | Optional uprn supplied by this operation. Null means unknown. |
page | number | null | Optional page supplied by this operation. Null means unknown. |
street | object | null | Optional street supplied by this operation. Null means unknown. |
street.kind | string | null | Optional kind supplied by this operation. Null means unknown. |
street.name | string | null | Optional name supplied by this operation. Null means unknown. |
street.path | string | null | Optional path supplied by this operation. Null means unknown. |
street.short_name | string | null | Optional short name supplied by this operation. Null means unknown. |
total | number | null | Source-reported total; null is unknown. |
Optional fields reviewed from preserved successful responses. Additive fields and source variations remain allowed; validate the fields your workflow requires.
The example is invented and illustrates types only; zero and empty values are not claims about a real result.
Failures use the typed error envelope. A confirmed uncharged or refunded failure reports zero; a pending reconciliation can report an unknown charge. Read credits_used and error.details.billing_status, and keep request_id for recovery. Response contract · Error reference