API reference

Rightmove Property API

One listing's page: title, address, price and qualifier, tenure and charges, council tax, description and key features, the utilities and risks the agent declared, nearest stations, photos, floorplans, EPC, brochures and the agent branch.

Read as Markdown Use with an AI agent

Endpoint

GET/v1/rightmove/propertylive · proven3 credits

Try in Playground

Parameters

Query parameters

Name	Required	Description	Example
`id`	yes	The listing number (or pass url, the listing's page)	`90874980`
`url`	no	The listing's page URL instead of an id
`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

curl "https://www.monocrawl.com/v1/rightmove/property?id=90874980" \
  -H "x-api-key: mn_your_key_here"

TypeScript

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/rightmove/property?id=90874980",
  { 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

python

import os
import requests

res = requests.get(
    "https://www.monocrawl.com/v1/rightmove/property?id=90874980",
    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.

200 · application/json

{
  "success": true,
  "platform": "rightmove",
  "endpoint": "/v1/rightmove/property",
  "data": {
    "_warnings": [],
    "added_on": "example",
    "address": "example",
    "agent": {
      "address": "example",
      "branch": "example",
      "developer": false,
      "display_name": "example",
      "id": "example",
      "logo_url": "https://example.com/example",
      "name": "example",
      "phone": "example"
    },
    "available": false,
    "bathrooms": 0,
    "bedrooms": 0,
    "brochures": [
      {
        "caption": "example",
        "url": "https://example.com/example"
      }
    ],
    "channel": "example",
    "council_tax": "example",
    "description": "example",
    "epcs": [
      {
        "caption": "example",
        "url": "https://example.com/example"
      }
    ],
    "features": {
      "accessibility": "example",
      "broadband": "example",
      "electricity": "example",
      "garden": "example",
      "heating": "example",
      "parking": "example",
      "sewerage": "example",
      "water": "example"
    },
    "floorplans": [
      {
        "caption": "example",
        "thumbnail_url": "https://example.com/example",
        "url": "https://example.com/example"
      }
    ],
    "ground_rent": "example",
    "id": "example",
    "key_features": [],
    "latitude": 0,
    "lease_length": "example",
    "listing_update": "2026-09-01T12:00:00Z",
    "longitude": 0,
    "map_url": "https://example.com/example",
    "market_info_url": "https://example.com/example",
    "obligations": {
      "listed": "example",
      "privateAccess": "example",
      "publicAccess": "example",
      "restrictions": "example"
    },
    "photos": [
      {
        "caption": "example",
        "thumbnail_url": "https://example.com/example",
        "url": "https://example.com/example"
      }
    ],
    "pin": "example",
    "platform": "example",
    "postcode": "example",
    "price": 0,
    "price_label": "example",
    "property_category": "example",
    "property_type": "example",
    "risks": {
      "floodDefences": "example",
      "floodHistory": "example",
      "floodRisk": "example"
    },
    "school_checker_url": "https://example.com/example",
    "service_charge": "example",
    "size": "example",
    "size_secondary": "example",
    "sold_prices_url": "https://example.com/example",
    "stamp_duty": {
      "country": "example",
      "price": 0
    },
    "stations": [
      {
        "distance_miles": 0,
        "name": "example",
        "type": "example"
      }
    ],
    "street_view_url": "https://example.com/example",
    "tags": [],
    "tenure": "example",
    "title": "example",
    "transaction": "example",
    "type": "example",
    "url": "https://example.com/example",
    "virtual_tours": []
  },
  "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
`_warnings`	`array \| null`	Source array was empty in the reviewed captures; item fields remain unspecified.
`added_on`	`string \| null`	Optional added on supplied by this operation. Null means unknown.
`address`	`string \| null`	Optional address supplied by this operation. Null means unknown.
`agent`	`object \| null`	Optional agent supplied by this operation. Null means unknown.
`agent.address`	`string \| null`	Optional address supplied by this operation. Null means unknown.
`agent.branch`	`string \| null`	Optional branch supplied by this operation. Null means unknown.
`agent.developer`	`boolean \| null`	Optional developer supplied by this operation. Null means unknown.
`agent.display_name`	`string \| null`	Optional display name supplied by this operation. Null means unknown.
`agent.id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`agent.logo_url`	`string \| null`	Optional logo url supplied by this operation. Null means unknown.
`agent.name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`agent.phone`	`string \| null`	Optional phone supplied by this operation. Null means unknown.
`available`	`boolean \| null`	Optional available supplied by this operation. Null means unknown.
`bathrooms`	`number \| null`	Optional bathrooms supplied by this operation. Null means unknown.
`bedrooms`	`number \| null`	Optional bedrooms supplied by this operation. Null means unknown.
`brochures`	`array \| null`	Optional brochures supplied by this operation. Null means unknown.
`brochures[].caption`	`string \| null`	Optional caption supplied by this operation. Null means unknown.
`brochures[].url`	`string \| null`	Original source URL when supplied.
`channel`	`string \| null`	Optional channel supplied by this operation. Null means unknown.
`council_tax`	`string \| null`	Optional council tax supplied by this operation. Null means unknown.
`description`	`string \| null`	Source description; null or absent means not supplied.
`epcs`	`array \| null`	Optional epcs supplied by this operation. Null means unknown.
`epcs[].caption`	`string \| null`	Optional caption supplied by this operation. Null means unknown.
`epcs[].url`	`string \| null`	Original source URL when supplied.
`features`	`object \| null`	Optional features supplied by this operation. Null means unknown.
`features.accessibility`	`string \| null`	Optional accessibility supplied by this operation. Null means unknown.
`features.broadband`	`string \| null`	Optional broadband supplied by this operation. Null means unknown.
`features.electricity`	`string \| null`	Optional electricity supplied by this operation. Null means unknown.
`features.garden`	`string \| null`	Optional garden supplied by this operation. Null means unknown.
`features.heating`	`string \| null`	Optional heating supplied by this operation. Null means unknown.
`features.parking`	`string \| null`	Optional parking supplied by this operation. Null means unknown.
`features.sewerage`	`string \| null`	Optional sewerage supplied by this operation. Null means unknown.
`features.water`	`string \| null`	Optional water supplied by this operation. Null means unknown.
`floorplans`	`array \| null`	Optional floorplans supplied by this operation. Null means unknown.
`floorplans[].caption`	`string \| null`	Optional caption supplied by this operation. Null means unknown.
`floorplans[].thumbnail_url`	`string \| null`	Optional thumbnail url supplied by this operation. Null means unknown.
`floorplans[].url`	`string \| null`	Original source URL when supplied.
`ground_rent`	`string \| null`	Optional ground rent supplied by this operation. Null means unknown.
`id`	`string \| null`	Source identifier. Preserve the supplied type and exact value.
`key_features`	`array \| null`	Source array was empty in the reviewed captures; item fields remain unspecified.
`latitude`	`number \| null`	Optional latitude supplied by this operation. Null means unknown.
`lease_length`	`string \| null`	Optional lease length supplied by this operation. Null means unknown.
`listing_update`	`string \| null`	Optional listing update supplied by this operation. Null means unknown.
`longitude`	`number \| null`	Optional longitude supplied by this operation. Null means unknown.
`map_url`	`string \| null`	Optional map url supplied by this operation. Null means unknown.
`market_info_url`	`string \| null`	Optional market info url supplied by this operation. Null means unknown.
`obligations`	`object \| null`	Optional obligations supplied by this operation. Null means unknown.
`obligations.listed`	`string \| null`	Optional listed supplied by this operation. Null means unknown.
`obligations.privateAccess`	`string \| null`	Optional privateAccess supplied by this operation. Null means unknown.
`obligations.publicAccess`	`string \| null`	Optional publicAccess supplied by this operation. Null means unknown.
`obligations.restrictions`	`string \| null`	Optional restrictions supplied by this operation. Null means unknown.
`photos`	`array \| null`	Optional photos supplied by this operation. Null means unknown.
`photos[].caption`	`string \| null`	Optional caption supplied by this operation. Null means unknown.
`photos[].thumbnail_url`	`string \| null`	Optional thumbnail url supplied by this operation. Null means unknown.
`photos[].url`	`string \| null`	Original source URL when supplied.
`pin`	`string \| null`	Optional pin supplied by this operation. Null means unknown.
`platform`	`string \| null`	Optional platform supplied by this operation. Null means unknown.
`postcode`	`string \| null`	Optional postcode supplied by this operation. Null means unknown.
`price`	`number \| null`	Source price. Currency, taxes and availability depend on the listing.
`price_label`	`string \| null`	Optional price label supplied by this operation. Null means unknown.
`property_category`	`string \| null`	Optional property category supplied by this operation. Null means unknown.
`property_type`	`string \| null`	Optional property type supplied by this operation. Null means unknown.
`risks`	`object \| null`	Optional risks supplied by this operation. Null means unknown.
`risks.floodDefences`	`string \| null`	Optional floodDefences supplied by this operation. Null means unknown.
`risks.floodHistory`	`string \| null`	Optional floodHistory supplied by this operation. Null means unknown.
`risks.floodRisk`	`string \| null`	Optional floodRisk supplied by this operation. Null means unknown.
`school_checker_url`	`string \| null`	Optional school checker url supplied by this operation. Null means unknown.
`service_charge`	`string \| null`	Optional service charge supplied by this operation. Null means unknown.
`size`	`string \| null`	Optional size supplied by this operation. Null means unknown.
`size_secondary`	`string \| null`	Optional size secondary supplied by this operation. Null means unknown.
`sold_prices_url`	`string \| null`	Optional sold prices url supplied by this operation. Null means unknown.
`stamp_duty`	`object \| null`	Optional stamp duty supplied by this operation. Null means unknown.
`stamp_duty.country`	`string \| null`	Optional country supplied by this operation. Null means unknown.
`stamp_duty.price`	`number \| null`	Source price. Currency, taxes and availability depend on the listing.
`stations`	`array \| null`	Optional stations supplied by this operation. Null means unknown.
`stations[].distance_miles`	`number \| null`	Optional distance miles supplied by this operation. Null means unknown.
`stations[].name`	`string \| null`	Optional name supplied by this operation. Null means unknown.
`stations[].type`	`string \| null`	Optional type supplied by this operation. Null means unknown.
`street_view_url`	`string \| null`	Optional street view url supplied by this operation. Null means unknown.
`tags`	`array \| null`	Source array was empty in the reviewed captures; item fields remain unspecified.
`tenure`	`string \| null`	Optional tenure supplied by this operation. Null means unknown.
`title`	`string \| null`	Source title when supplied.
`transaction`	`string \| null`	Optional transaction supplied by this operation. Null means unknown.
`type`	`string \| null`	Optional type supplied by this operation. Null means unknown.
`url`	`string \| null`	Original source URL when supplied.
`virtual_tours`	`array \| null`	Source array was empty in the reviewed captures; item fields remain unspecified.

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

Rightmove Property API

Query parameters

Make the request

Response fields and example

More Rightmove reference

First call in under a minute