See which UK listings are new and which were reduced, per row
The Rightmove API returns UK real-estate data as clean JSON.
6 active endpoints, on 0, 1, 2 and 3 credit tiers.
- POST/rightmove/v1/location_search
- POST/rightmove/v1/search
- POST/rightmove/v1/property_detail
- POST/rightmove/v1/agent
- POST/rightmove/v1/similar
- POST/rightmove/v1/sold_prices
What Rightmove endpoints does ReefAPI ship?
6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Rightmove API
3 of 6 endpoints, ready to run
The UK listing grid. Every row carries listing_update_reason — new or price_reduced — with the date it changed and the date it first appeared.
{ "ok": true, "meta": { "api": "rightmove", "endpoint": "search", "mode": "live", "latency_ms": 2230.2, "record_count": 25, "cache_hit": false, "completeness_pct": 98.55 }, "data": { "items": [ { "property_id": 92510352, "url": "https://www.rightmove.co.uk/properties/92510352", "channel": "rent", "transaction_type": "rent", "price_amount": 2550, "price_currency": "GBP", "price_frequency": "monthly", "price_display": "£2,550 pcm", "price_qualifier": "", "bedrooms": 2, "bathrooms": 2, "property_sub_type": "Flat", "property_type_full": "2 bedroom flat", "display_address": "The Well House", "latitude": 51.360698, "longitude": -0.189378, "summary": "The Well House, Sutton’s premier build-to-rent destination\nExperience modern living with professional on-site management, exceptional amenities, and a truly hassle-free rental experience. Modern built-to-rent TWO BEDROOM apartment is available to rent at The Well House. Situated in the heart o...", "tenure": null, "num_images": 26, "num_floorplans": 1, "num_virtual_tours": 0, "images": [ "https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/264c93066/92510352/264c9306605f268827f129cbed251e72_max_476x317.jpeg", "https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/61aaa119c/92510352/61aaa119ccc3a7ae6ef085d4160382ff_max_476x317.jpeg", "https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/41b769a25/92510352/41b769a25462137a1379f8054bbcbb1f_max_476x317.jpeg" ], "first_visible_date": "2026-08-28T14:04:35Z", "added_or_reduced": "Added today", "listing_update_reason": "new", "listing_update_date": "2026-08-28T14:10:25Z", "fees_apply": true, "fees_apply_text": null, "display_size": "743 sq. ft.", "distance": null, "static_map_url": "https://media.rightmove.co.uk:443/map/_generate?width=214&height=161&zoomLevel=14&latitude=51.360698&longitude=-0.189378&signature=Ggrrg9vs02gcKOzCsmr64mCK1kE=", "is_development": true, "is_commercial": false, "is_student": false, "is_auction": false, "agent": { "branch_id": 202517, "branch_display_name": "Greystar, The Well House, Sutton", "brand_trading_name": "Greystar", "branch_landing_page_url": "https://www.rightmove.co.uk/estate-agents/agent/Greystar/The-Well-House-Sutton-202517.html", "logo_url": "https://media.rightmove.co.uk:443/partner-logo/21913769-PRODUCTS_LOGO-1766060394.jpeg" } }, { "property_id": 92529471, "url": "https://www.rightmove.co.uk/properties/92529471", "channel": "rent", "transaction_type": "rent", "price_amount": 2700, "price_currency": "GBP", "price_frequency": "monthly", "price_display": "£2,700 pcm", "price_qualifier": "", "bedrooms": 1, "bathrooms": 1, "property_sub_type": "Apartment", "property_type_full": "1 bedroom apartment", "display_address": "Bayswater Mansions, Westbourne Grove, London, W2", "latitude": 51.515592, "longitude": -0.189384, "summary": "Nestled on a quiet street off Westbourne Grove, this charming one bedroom third floor flat is a breath of fresh air to community of Bayswater. Located in the heart of Queensway, the property is a short distance to the green open spaces of Hyde Park & trendy Notting Hill. ", "tenure": null, "num_images": 10, "num_floorplans": 1, "num_virtual_tours": 1, "images": [ "https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/503f595fc/92529471/503f595fc8e4ca1150c1738a86b2787d_max_476x317.jpeg", "https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/6cf003148/92529471/6cf003148b33adaf56cbd893d67b92eb_max_476x317.jpeg", "https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/6bf8c0caa/92529471/6bf8c0caa6961fec79ba12c6bf906833_max_476x317.jpeg" ], "first_visible_date": "2026-08-28T18:21:49Z", "added_or_reduced": "Added today", "listing_update_reason": "new", "listing_update_date": "2026-08-28T18:27:04Z", "fees_apply": true, "fees_apply_text": null, "display_size": "506 sq. ft.", "distance": null, "static_map_url": null, "is_development": false, "is_commercial": false, "is_student": false, "is_auction": false, "agent": { "branch_id": 82269, "branch_display_name": "London Executive, London", "brand_trading_name": "London Executive", "branch_landing_page_url": "https://www.rightmove.co.uk/estate-agents/agent/London-Executive/London-82269.html", "logo_url": "https://media.rightmove.co.uk:443/partner-logo/28918785-PRODUCTS_LOGO-1766068057.png" } }, { "property_id": 92529459, "url": "https://www.rightmove.co.uk/properties/92529459", "channel": "rent", "transaction_type": "rent", "price_amount": 2800, "price_currency": "GBP", "price_frequency": "monthly", "price_display": "£2,800 pcm", "price_qualifier": "", "bedrooms": 2, "bathrooms": 2, "property_sub_type": "Apartment", "property_type_full": "2 bedroom apartment", "display_address": "Bayham Street, London, NW1", "latitude": 51.539421, "longitude": -0.141525, "summary": "A beautifully appointed two-bedroom penthouse-style maisonette situated in the heart of Camden Town. Arranged over two floors, this exceptional home features a spacious open-plan kitchen, living and dining area with dual-aspect and a private balcony, creating a bright and contemporary living spac...", "tenure": null, "num_images": 14, "num_floorplans": 1, "num_virtual_tours": 0, "images": [ "https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/197231f3b/92529459/197231f3b316e8c412b8b55eb47af1ca_max_476x317.jpeg", "https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/964793d35/92529459/964793d35bf2318008ae50de55b2a1bd_max_476x317.jpeg", "https://media.rightmove.co.uk:443/dir/crop/10:9-16:9/property-photo/90523ef31/92529459/90523ef31353c696285e28782cce2185_max_476x317.jpeg" ], "first_visible_date": "2026-08-28T18:20:28Z", "added_or_reduced": "Added today", "listing_update_reason": "new", "listing_update_date": "2026-08-28T18:26:12Z", "fees_apply": true, "fees_apply_text": null, "display_size": "712 sq. ft.", "distance": null, "static_map_url": null, "is_development": false, "is_commercial": false, "is_student": false, "is_auction": false, "agent": { "branch_id": 265268, "branch_display_name": "Mortimer Surveyors, London", "brand_trading_name": "Mortimer Surveyors", "branch_landing_page_url": "https://www.rightmove.co.uk/estate-agents/agent/Mortimer-Surveyors/London-265268.html", "logo_url": "https://media.rightmove.co.uk:443/partner-logo/30724361-PRODUCTS_LOGO-1766067394.png" } } ], "count": 25, "pages_fetched": 1, "channel": "rent", "location_identifier": "REGION^87490", "result_count": 1457, "result_count_display": "1,457", "pages_total": 42, "duplicates_skipped": 0, "filters_applied": { "maxDaysSinceAdded": "1" }, "sort": null, "stop_reason": "max_pages", "result_cap_hit": false, "result_cap_note": null } }
How the Rightmove API works
Rightmove is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 184 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
A daily digest of what is new and what was cut
Rightmove labels the reason a listing moved, which means you do not have to diff yesterday's snapshot to know a price was reduced. One call gives you both events, already separated.
{"location": "London", "channel": "buy", "added_within_days": 1, "sort": "newest", "max_pages": 3}2 flat credits per call. Split on listing_update_reason: our 25-row sample came back 14 new and 11 price_reduced, with listing_update_date on each.
{"location": "SW9"}2 credits. For the reduced ones, the same street's transaction history tells you what that stock has actually achieved — our SW9 sample carried 91 transactions across 25 addresses, back to 1995.
Four credits for a daily new-and-reduced digest with a sold-price backdrop. location_search is free, so resolving place names costs nothing.
curl -X POST https://api.reefapi.com/rightmove/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"location":"London"}'{
"ok": true,
"data": { … },
"meta": {
"api": "rightmove",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}Rightmove locationIdentifier prefixes and the real price vocabulary
Two things trip up every Rightmove integration: the locationIdentifier format, which is a prefix plus a caret plus an id, and the price vocabulary, which is not one field but three that disagree with each other. Every value below was measured on 2026-08-27 from live location_search and search calls covering 75 London sale rows, 75 Manchester rental rows and 85 London commercial rows.
| Token or value | Where it appears | Measured 2026-08-27 |
|---|---|---|
| REGION^87490 | location_identifier | "London". Manchester is REGION^904 and Central London is REGION^92824 |
| OUTCODE^2522 | location_identifier | "SW9". Postcode outcodes get their own numeric id |
| POSTCODE^1327582 | location_identifier | "E14 5AB". A full postcode resolves to exactly one match |
| STATION^2156 | location_identifier | "Clapham Junction Station" |
| STREET^Po8SVH56WnaE_XwZ9vjFYIG4IU7qSz_I | location_identifier | "Shakespeare Road, Lambeth, London, SW9". Street ids are opaque 32-character tokens, not digits |
| "" (empty string) | price_qualifier | the default case: 47 of 75 London sale rows and 74 of 75 Manchester rental rows |
| "Guide Price" | price_qualifier | 26 of 75 London sale rows and 8 of 58 London commercial rows |
| "Offers in Excess of" | price_qualifier | 20 of 58 London commercial rows and 1 of 75 London sale rows |
| "Offers in Region of" | price_qualifier | 5 of 58 London commercial rows and 1 of 75 London sale rows |
| "Fixed Price" and "From" | price_qualifier | 1 Manchester rental and 1 London commercial row respectively |
| "POA" | price_display, never price_qualifier | 11 of 85 London commercial rows; price_amount on those rows was 1 on one listing and 65,000,000 on another |
| price_frequency | rent rows versus sale rows | "monthly" on 74 of 75 Manchester rentals and "weekly" on 1; "not specified" on sale and commercial rows |
price_qualifier is an empty string when absent rather than null, so test for falsiness rather than for null. The spec also accepts BRANCH^<id> as a location_identifier to list one agent's stock; that path was not exercised in this pass and is listed here as unverified.
Six channels, a change reason on every row, and the paging that does not move
Measured on 2026-08-28 on London and Manchester across the buy and rent channels, and on the SW9 sold-price archive. Three of these lines go against us.
The United Kingdom. buy, rent, new_homes, commercial_sale, commercial_rent and student are separate channels rather than filters — a student search is not a subset of rent. include_sstc pulls in Sold STC and Under Offer stock on the buy channel, which is off by default.
This is what this engine has that the others do not. listing_update_reason is a two-value enum — new or price_reduced — filled on 25 of 25 rows in every sweep we ran, on both channels. Alongside it: listing_update_date as an ISO instant, first_visible_date as the date it first appeared on the portal, and added_or_reduced as the human string ("Reduced on 26/12/2025"). A London buy sweep split 18 new / 7 reduced; a London rent sweep 17 / 8; a Manchester rent sweep the same shape.
Worth knowing before you trust it as a new-listing filter. London reported 58,309 for-sale listings; added_within_days 1 reported 745. But the rows that came back included first_visible_date values from 2025-09-18 and 2026-08-12, and 11 of 25 were tagged price_reduced. Rightmove's "added" window means added or reduced. If you want arrivals only, filter on listing_update_reason after the fact.
The deepest history in this batch. One SW9 address returned six transactions: 549,000 in May 2026, 438,888 in 2013, 325,000 in 2010, 312,500 in 2007, 119,000 in 1998 and 76,500 in 1996 — each with tenure and a new-build flag. Across 25 addresses that was 91 transactions, the oldest from 1995, up to nine on a single property, with latest_price and latest_date pre-extracted.
Against us, and definitive: pages 1, 2 and 40 returned the identical 25 uuids, and pagination.current stayed 1 in all three responses while the same block reported last 40 and total 7,204. You can read the first 25 addresses of an outcode and no more. Narrow the location — a full postcode rather than an outcode — until we fix it.
Against us. latitude and longitude were null on 25 of 25 sold rows, though they are present on 25 of 25 listing rows. If you are plotting sold history you will need to geocode the address string yourself.
price_frequency came back monthly on 25 of 25 rent rows, with price_amount as a plain integer, price_currency GBP and price_display in the UK's own convention ("£1,100 pcm"). price_qualifier carries "Guide Price", "Offers Over" and the rest where the agent set one — 9 of 25 on a buy sweep.
location_search is free and returns REGION^87490, OUTCODE^2522, BRANCH^45021 and so on, each with a display name — a London query returned regions for Central, North, South, Wimbledon, Bromley, Beckenham and Zone 3 as separate identifiers. Passing the identifier instead of the text is what stops "London" quietly meaning something else next month.
A London buy search reported 58,309 results and pages_total 42 in the same response. At 24 a page that is about 1,008 listings you can actually reach, and the payload carries a result_cap_hit flag and a note explaining it. Slice by outcode or price band to get past it; the response tells you when you have hit the wall rather than silently truncating.
Tenure with years_remaining_on_lease, living_costs with the annual service charge, annual ground rent and council tax band, sizings in square metres, square feet, hectares and acres, nearest_stations with typed lines and decimal-mile distances, the EPC graph image, brochure links and a street-view anchor. Against us: the features block (electricity, water, heating, parking, garden, flood risk) came back with every array empty on the property we opened, and broadband returns a disclaimer and a checker link rather than a speed.
location_search is free. search, similar and sold_prices are 2 flat credits, property_detail 3, agent 1. Nothing is billed per row, so a 24-row page and a merged five-page sweep cost the same 2 credits per call.
What people build with Rightmove
The jobs this data is most often used for.
endpoints
credits per call
Property portals call location_search then search to list Rightmove properties.
Investors use sold_prices to value an area from real transactions.
Agent tools use agent and similar to benchmark listings.
What Rightmove data costs
The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 184 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/rightmove/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"location":"London"}'import requests
r = requests.post(
"https://api.reefapi.com/rightmove/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"location": "London"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Rightmove.
Get a free key →What does a Rightmove locationIdentifier look like and how do I get one?▾
It is a type prefix, a caret and an id: REGION^87490 for London, OUTCODE^2522 for SW9, POSTCODE^1327582 for E14 5AB and STATION^2156 for Clapham Junction Station. STREET is the odd one out because its id is an opaque token rather than a number, as in STREET^Po8SVH56WnaE_XwZ9vjFYIG4IU7qSz_I for Shakespeare Road in Lambeth. Resolve one with location_search, or skip the step and pass free text as location: the search response echoes meta.location_identifier "REGION^87490" and meta.resolved_from "London" so you can see what it picked.
What are the real Rightmove price qualifier strings?▾
Measured across 218 live listings on 2026-08-27, the vocabulary that actually appeared was an empty string (the common case), "Guide Price", "Offers in Excess of", "Offers in Region of", "Fixed Price" and "From". The mix varies sharply by channel: 26 of 75 London sale listings carried "Guide Price", while "Offers in Excess of" appeared on 20 of 58 London commercial listings and only once in the residential sample. Note that "POA" is not a price_qualifier value at all, despite what most people expect. It lives in price_display.
How should I handle POA listings?▾
Detect them on price_display and then ignore price_amount, because price_amount is not a real asking price on those rows. Measured on 2026-08-27, 11 of 85 London commercial listings had price_display "POA": an office at Alfa Laval Tower came back with price_amount 1, a land listing at One Page Street with 65,000,000 and an industrial unit with 10,500,000. Those are placeholders of wildly different scale, so any average or price filter that includes them is wrong. Gate on price_display == "POA" and treat the price as unknown.
What is the difference between count, result_count and pages_total?▾
count is what you received, result_count is the true market total, and pages_total is what Rightmove will actually let you page through. A Manchester furnished rental search with max_pages 3 returned count 75 (three merged pages of about 24), result_count 3,342 with result_count_display "3,342", pages_total 42, duplicates_skipped 0 and stop_reason "max_pages". Note that 42 pages of 24 is roughly 1,000, which is Rightmove's result ceiling, not the 3,342 total. To reach deeper inventory you narrow the search with a smaller radius or a tighter price band rather than paging harder, and result_cap_hit tells you when you have hit the wall.
Is a Rightmove property_id always 8 or 9 digits?▾
No, and this one bites. Residential rows returned ids like 92186892 and 148711631, but commercial rows returned 15-digit ids: 760770556763601, 733927782766401 and 758381082588465. Store property_id as a string. A 32-bit integer column overflows on commercial stock, and while JavaScript's Number handles 15 digits, you lose nothing by keeping them as text since that is what property_detail accepts anyway.
How do sale rows and rent rows differ in the response?▾
Beyond the price itself, three fields diverge. Rental rows carry price_frequency "monthly" (74 of 75 measured, with one "weekly") and a price_display formatted as "£1,850 pcm", tenure null, and fees_apply true with a fees_apply_text running to several kilobytes of the agent's tenancy fee schedule. Sale rows carry price_frequency "not specified", a real tenure value such as SHARE_OF_FREEHOLD or LEASEHOLD, and no fee text. The channel enum is buy, rent, new_homes, commercial_sale, commercial_rent and student, with aliases like for_sale, to_rent, lettings and new_build accepted. Unlike most parameters here, an unknown channel is rejected outright with the valid list rather than ignored.
What does property_detail add over a search row?▾
A lot, though some of it is null more often than you would hope. Measured for property 148711631: living_costs with council_tax_band "H", sizings expressed in four units at once (0.21 ac, 836 sqm, 0.08 ha, 9,000 sqft), nearest_stations with types such as LONDON_UNDERGROUND and a distance in miles (Knightsbridge at 0.049), epc_graphs image URLs, floorplans, price_per_sqft, price_qualifier_message, tenure LEASEHOLD, street_view coordinates and agent{branch_id 271223, company_name REGENTS ESTATE HOLDINGS LTD}. On that same leasehold flat, years_remaining_on_lease, annual_service_charge and annual_ground_rent were all null: the fields exist, but agents frequently do not publish them, so treat them as optional rather than guaranteed.
Can I pull every listing from one estate agent?▾
Yes, through the agent action, which takes branch_id or branch_url and returns the branch profile plus that branch's live stock with max_pages paging. The branch id is discoverable from any listing: property_detail returned agent.branch_id 271223 with branch_display_name "Global 1, London" and company_name "REGENTS ESTATE HOLDINGS LTD", and search rows carry an agent block too. This is the usual route for agent-monitoring and competitor-stock tools, since it gives you one company's inventory without running a location search per area.
What is the Rightmove API?▾
Rightmove API is a ReefAPI endpoint group for uk property listings for sale and to rent. It returns live JSON through POST requests under /rightmove/v1.
Is the Rightmove API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Rightmove calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Rightmove login or account?▾
No login to Rightmove is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Rightmove data?▾
The page example is captured from a live location_search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Rightmove API use?▾
Rightmove actions currently cost 1-3 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Rightmove from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call rightmove actions with the same key, credit pool and JSON envelope used by normal REST requests.
11 Real Estate APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Rightmove, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 183 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-08-28.