docs / rightmove

Rightmove

UK property listings for sale and to rent.

base /rightmove/v16 endpoints

post/rightmove/v1/location_searchfree

resolve a text location to a Rightmove locationIdentifier (LOS typeahead)

Parameter	Required
query	required

Try in playground →

post/rightmove/v1/search2 credits

search listings; channel = buy|rent|commercial_sale|commercial_rent|student (default buy)

Parameter	Required
location	optional
location_identifier	optional
channel	optional
for_rent	optional
max_pages	optional
fetch_all	optional
index	optional
filters	optional

Try in playground →

post/rightmove/v1/property_detail3 credits

full property: description, EPC, nearest stations, sizings, floorplans, agent

Parameter	Required
property_id	required

Try in playground →

post/rightmove/v1/agent1 credit

estate-agent branch profile (+ that branch's live listings via BRANCH^id)

Parameter	Required
branch_url	optional
branch_id	optional
max_pages	optional

Try in playground →

post/rightmove/v1/similar2 credits

listings similar to a property (same area + price/bedroom band)

Parameter	Required
property_id	required

Try in playground →

post/rightmove/v1/sold_prices2 credits

sold/transaction history: by location (search) or per-property (detail_url|uuid). Land-Registry sold data with full per-address transaction history.

Parameter	Required
location	optional
detail_url	optional
uuid	optional
page	optional

Try in playground →

Example request · location_search

curl -X POST https://api.reefapi.com/rightmove/v1/location_search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"London"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}