Rightmove API endpoint
Lists estate-agent branches from Rightmove's estate-agents directory for a location, with branch display name, brand, address, telephones, sales/lettings flags, logo, and a link to the branch profile. Pagination follows Rightmove's current directory pages, whose result counts can vary.
/rightmove/agents| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
location | string | yes | — | Rightmove location identifier from autocomplete; the id part must be numeric, e.g. REGION^87490 |
page | integer | no | 1 | Rightmove directory page (1-indexed; result count can vary) |
| Field | Type | Description |
|---|---|---|
location | string | Echo of the input location |
page | integer | Current page number |
total | integer | Total number of agent branches for the location |
results[].id | string | Rightmove branch id, usable with /rightmove/agents/{id} |
results[].display_name | string | Branch display name |
results[].brand_name | string | Agent brand name |
results[].address | string | Branch address |
results[].description | string | Branch description |
results[].sales | boolean | Whether the branch offers sales services |
results[].lettings | boolean | Whether the branch offers lettings services |
results[].telephones | array | Published branch telephone numbers |
results[].telephones[].number | string | Public phone number |
results[].telephones[].direct_number | string | Direct line when published |
results[].telephones[].type | string | Number type (SALES, LETTING) |
results[].logo_url | string | Absolute branch logo URL |
results[].url | string | Direct link to the branch profile on Rightmove |
400 — Invalid or missing location parameter, or a location id that is not numeric503 — Upstream error (Rightmove unreachable or response format changed)500 — Internal server error/estate-agents/{location-id}.html)page field is the
upstream page number and the API returns all parsed entries from that page.sales and lettings flags| Field | Filled in, of 31 checked | Values in the sample |
|---|---|---|
| id | 31 | |
| display_name | 31 | |
| brand_name | 31 | |
| address | 31 | |
| description | 17 | median 772 characters |
| lettings | 18 | true in 18 of 18 |
| telephones | 28 | median 1 entry |
| logo_url | 31 | media.rightmove.co.uk |
| url | 31 | rightmove.co.uk |
| sales | 13 | true in 13 of 13 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| location | string | Yes | Rightmove location identifier from autocomplete (numeric location id required) | REGION^87490 | |
| page | integer | No | Result page (default 1) | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/rightmove/agents?location=REGION%5E87490&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"location": "REGION^87490",
"page": 1,
"total": 3614,
"results": [
{
"id": "181787",
"display_name": "1 Ability Estate Agents, London",
"brand_name": "1 Ability Estate Agents",
"address": "18 Pilgrimage Street,\nLondon Bridge,\nLondon,\nSE1 4LL",
"description": "1 Ability estate agents are an independent estate agency based in the heart of London Bridge SE1.",
"sales": false,
"lettings": true,
"telephones": [
{
"number": "020 3910 6304",
"direct_number": "020 3903 2323",
"type": "LETTING"
}
],
"logo_url": "https://media.rightmove.co.uk/partner-logo/19103090-LOGO-1765975389.png",
"url": "https://www.rightmove.co.uk/estate-agents/agent/1-Ability-Estate-Agents/London-181787.html"
}
]
}
}Request schema
No body schema
Response schema
Inline response schema
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | rightmove.AgentsResponse | No | ||||
| data.location | string | No | REGION^87490 | |||
| data.page | integer | No | 1 | |||
| data.results | array | No | ||||
| data.results[].address | string | No | 18 Pilgrimage Street, London Bridge, London, SE1 4LL | |||
| data.results[].brand_name | string | No | 1 Ability Estate Agents | |||
| data.results[].description | string | No | ||||
| data.results[].display_name | string | No | 1 Ability Estate Agents, London | |||
| data.results[].id | string | No | 181787 | |||
| data.results[].lettings | boolean | No | ||||
| data.results[].logo_url | string | No | https://media.rightmove.co.uk/partner-logo/19103090-LOGO-1765975389.png | |||
| data.results[].sales | boolean | No | ||||
| data.results[].telephones | array | No | ||||
| data.results[].telephones[].direct_number | string | No | 020 3903 2323 | |||
| data.results[].telephones[].number | string | No | 020 3910 6304 | |||
| data.results[].telephones[].type | string | No | LETTING | |||
| data.results[].url | string | No | https://www.rightmove.co.uk/estate-agents/agent/1-Ability-Estate-Agents/London-181787.html | |||
| data.total | integer | No | 3614 | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Invalid query parameter | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
| 503 | Upstream error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/rightmove/agents?location=REGION%5E87490&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"