Rightmove API endpoint
Returns one estate-agent branch profile from Rightmove, including address, telephones, service flags, industry affiliations, and the branch's own sales and lettings listing previews. The slug segments in Rightmove agent URLs are cosmetic; the branch resolves by numeric id alone.
/rightmove/agents/{id}| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Rightmove agent branch id, e.g. 181787 (from /rightmove/agents results) |
| Field | Type | Description |
|---|---|---|
id | string | Branch id |
display_name | string | Branch display name |
branch_name | string | Branch name (usually the area) |
brand_name | string | Agent brand/trading name |
address | string | Branch address |
postcode | string | Branch postcode |
main_telephone | string | Main published telephone |
sales_telephone | string | Sales telephone when published |
lettings_telephone | string | Lettings telephone when published |
logo_url | string | Absolute branch logo URL |
description | string | Branch description |
company_id | string | Rightmove company id |
company_name | string | Company name |
sales | boolean | Branch offers sales services |
lettings | boolean | Branch offers lettings services |
commercial | boolean | Branch handles commercial property |
build_to_rent | boolean | Branch handles build-to-rent |
overseas | boolean | Branch handles overseas property |
development | boolean | Branch handles developments |
latitude/longitude | number | Branch coordinates when published |
industry_affiliations | array | Professional body affiliations (id, name, image_url) |
sales_properties | object | Branch's own for-sale listing preview (total, properties[]) |
lettings_properties | object | Branch's own to-let listing preview (total, properties[]) |
properties[].price | integer | Price in whole GBP units following the listing's own frequency |
properties[].price_text | string | Formatted price string |
properties[].price_frequency | string | Price frequency (weekly, monthly); empty for one-off sale prices |
properties[].status | string | Listing status as published by Rightmove, e.g. available |
properties[].channel | string | Rightmove channel, e.g. RES_BUY, RES_LET |
properties[].url | string | Direct link to the property on Rightmove |
properties[].image | string | Main property image URL |
400 — Invalid or missing branch id (must be numeric)503 — Upstream error (Rightmove unreachable, unknown branch, or response format changed)500 — Internal server error/estate-agents/agent/.../{id}.html)/rightmove/search with a BRANCH^{id} location identifier| Field | Filled in, of 8 checked | Values in the sample |
|---|---|---|
| id | 8 | |
| bedrooms | 8 | 1 to 3, median 2 |
| bathrooms | 7 | 1 to 2, median 1 |
| address | 8 | |
| property_type | 8 | |
| status | 8 | |
| price | 8 | 300 to 1,000, median 611 |
| price_text | 8 | |
| price_frequency | 8 | |
| channel | 8 | |
| url | 8 | rightmove.co.uk |
| image | 8 | media.rightmove.co.uk |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Rightmove agent branch id | 12070 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/rightmove/agents/12070" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "12070",
"display_name": "1st Avenue, London",
"branch_name": "London",
"brand_name": "1st Avenue",
"address": "Commercial Unit 6, 128 Metcalfe Court, West Parkside, London, SE10 0EL",
"postcode": "SE10 0EL",
"main_telephone": "020 8293 8600",
"sales_telephone": "020 8293 8600",
"lettings_telephone": "020 3909 6734",
"logo_url": "https://media.rightmove.co.uk/partner-logo/69255-LOGO-1765971619.jpeg",
"description": "1st avenue estate agents are a professional services company with offices in London and Singapore.",
"company_id": "4294",
"company_name": "1st Avenue",
"sales": true,
"lettings": true,
"commercial": false,
"build_to_rent": false,
"overseas": false,
"development": false,
"latitude": 51.49489968415025,
"longitude": 0.013320762291581531,
"industry_affiliations": [
{
"id": 19,
"name": "Property Redress Scheme",
"image_url": "https://media.rightmove.co.uk/partner/industry-affiliation/property-redress-scheme.png"
}
],
"sales_properties": {
"total": 37,
"properties": [
{
"id": "92527095",
"bedrooms": 2,
"bathrooms": 2,
"address": "West Parkside, London, SE10",
"property_type": "Flat",
"status": "available",
"price": 575000,
"price_text": "£575,000",
"channel": "RES_BUY",
"url": "https://www.rightmove.co.uk/properties/92527095#/?channel=RES_BUY",
"image": "https://media.rightmove.co.uk/property-photo/.../92527095.jpeg"
}
]
},
"lettings_properties": {
"total": 42,
"properties": [
{
"id": "90665028",
"bedrooms": 2,
"bathrooms": 2,
"address": "Farnsworth Court, West Parkside, London, SE10",
"property_type": "Flat",
"status": "available",
"price": 634,
"price_text": "£634 pw",
"price_frequency": "weekly",
"channel": "RES_LET",
"url": "https://www.rightmove.co.uk/properties/90665028#/?channel=RES_LET",
"image": "https://media.rightmove.co.uk/property-photo/.../90665028.jpeg"
}
]
}
}
}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.AgentBranchResponse | No | ||||
| data.address | string | No | 18 Pilgrimage Street, London Bridge, London, SE1 4LL | |||
| data.branch_name | string | No | London | |||
| data.brand_name | string | No | 1 Ability Estate Agents | |||
| data.build_to_rent | boolean | No | ||||
| data.commercial | boolean | No | ||||
| data.company_id | string | No | 4294 | |||
| data.company_name | string | No | 1st Avenue | |||
| data.description | string | No | ||||
| data.development | boolean | No | ||||
| data.display_name | string | No | 1 Ability Estate Agents, London | |||
| data.id | string | No | 181787 | |||
| data.industry_affiliations | array | No | ||||
| data.industry_affiliations[].id | integer | No | 19 | |||
| data.industry_affiliations[].image_url | string | No | ||||
| data.industry_affiliations[].name | string | No | Property Redress Scheme | |||
| data.latitude | number | No | ||||
| data.lettings | boolean | No | ||||
| data.lettings_properties | rightmove.AgentPropertyList | No | ||||
| data.lettings_properties.properties | array | No | ||||
| data.lettings_properties.properties[].address | string | No | West Parkside, London, SE10 | |||
| data.lettings_properties.properties[].bathrooms | integer | No | 2 | |||
| data.lettings_properties.properties[].bedrooms | integer | No | 2 | |||
| data.lettings_properties.properties[].channel | string | No | RES_LET | |||
| data.lettings_properties.properties[].id | string | No | 92527095 | |||
| data.lettings_properties.properties[].image | string | No | ||||
| data.lettings_properties.properties[].price | integer | No | 634 | |||
| data.lettings_properties.properties[].price_frequency | string | No | weekly | |||
| data.lettings_properties.properties[].price_text | string | No | £634 pw | |||
| data.lettings_properties.properties[].property_type | string | No | Flat | |||
| data.lettings_properties.properties[].status | string | No | available | |||
| data.lettings_properties.properties[].url | string | No | https://www.rightmove.co.uk/properties/92537946#/?channel=RES_LET | |||
| data.lettings_properties.total | integer | No | 37 | |||
| data.lettings_telephone | string | No | 020 3910 6304 | |||
| data.logo_url | string | No | ||||
| data.longitude | number | No | ||||
| data.main_telephone | string | No | 020 8293 8600 | |||
| data.overseas | boolean | No | ||||
| data.postcode | string | No | SE1 4LL | |||
| data.sales | boolean | No | ||||
| data.sales_properties | rightmove.AgentPropertyList | No | ||||
| data.sales_properties.properties | array | No | ||||
| data.sales_properties.properties[].address | string | No | West Parkside, London, SE10 | |||
| data.sales_properties.properties[].bathrooms | integer | No | 2 | |||
| data.sales_properties.properties[].bedrooms | integer | No | 2 | |||
| data.sales_properties.properties[].channel | string | No | RES_LET | |||
| data.sales_properties.properties[].id | string | No | 92527095 | |||
| data.sales_properties.properties[].image | string | No | ||||
| data.sales_properties.properties[].price | integer | No | 634 | |||
| data.sales_properties.properties[].price_frequency | string | No | weekly | |||
| data.sales_properties.properties[].price_text | string | No | £634 pw | |||
| data.sales_properties.properties[].property_type | string | No | Flat | |||
| data.sales_properties.properties[].status | string | No | available | |||
| data.sales_properties.properties[].url | string | No | https://www.rightmove.co.uk/properties/92537946#/?channel=RES_LET | |||
| data.sales_properties.total | integer | No | 37 | |||
| data.sales_telephone | string | No | 020 3909 6734 | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Invalid branch id | #/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/12070" \
-H "x-api-key: $CRAWLORA_API_KEY"