Skip to main content
POST
/
api
/
rightmove
/
properties
/
search
/rightmove/properties/search
curl --request POST \
  --url https://api.anysite.io/api/rightmove/properties/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "location_id": "<string>",
  "count": 2,
  "timeout": 300,
  "radius": 1,
  "min_price": 1,
  "max_price": 1,
  "min_bedrooms": 1,
  "max_bedrooms": 1,
  "sort": "most_recent"
}
'
[
  {
    "id": "<string>",
    "@type": "@rightmove_search_property",
    "url": "<string>",
    "display_address": "<string>",
    "summary": "<string>",
    "property_sub_type": "<string>",
    "property_type_description": "<string>",
    "transaction_type": "<string>",
    "channel": "<string>",
    "bedroom_count": 123,
    "bathroom_count": 123,
    "price": 123,
    "display_price": "<string>",
    "price_qualifier": "<string>",
    "price_frequency": "<string>",
    "latitude": 123,
    "longitude": 123,
    "image": "<string>",
    "images": [],
    "image_count": 123,
    "floorplan_count": 123,
    "tenure_type": "<string>",
    "added_or_reduced": "<string>",
    "listing_update_reason": "<string>",
    "listing_update_date": "<string>",
    "first_visible_date": "<string>",
    "let_available_date": "<string>",
    "is_premium": true,
    "is_featured": true,
    "branch_id": 123,
    "branch_display_name": "<string>",
    "branch_phone": "<string>",
    "branch_image": "<string>"
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
location_id
string
required

Rightmove location identifier from the locations/search endpoint (e.g. REGION^87490, OUTCODE^2522, POSTCODE^123, BRANCH^226316).

Minimum string length: 3
Examples:

"REGION^87490"

"OUTCODE^2522"

​
transaction_type
enum<string>
required

Whether to search properties for sale or to rent.

Available options:
sale,
rent
​
count
integer
required

Max number of results to return

Required range: x >= 1
​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
radius
number | null

Search radius in miles around the location.

Required range: x >= 0
​
min_price
integer | null

Minimum price (GBP). For rentals this is per month.

Required range: x >= 0
​
max_price
integer | null

Maximum price (GBP). For rentals this is per month.

Required range: x >= 0
​
min_bedrooms
integer | null

Minimum number of bedrooms.

Required range: x >= 0
​
max_bedrooms
integer | null

Maximum number of bedrooms.

Required range: x >= 0
​
property_type
enum<string> | null

Restrict results to a property type.

Available options:
any,
houses,
flats,
bungalows,
land,
commercial,
other,
detached,
semi-detached,
terraced,
park-home
​
sort
enum<string>
default:most_recent

Result ordering.

Available options:
most_recent,
price_high,
price_low,
oldest

Response

Successful Response

​
id
string
required
​
@type
string
default:@rightmove_search_property
​
url
string | null
​
display_address
string | null
​
summary
string | null
​
property_sub_type
string | null
​
property_type_description
string | null
​
transaction_type
string | null
​
channel
string | null
​
bedroom_count
integer | null
​
bathroom_count
integer | null
​
price
integer | null
​
display_price
string | null
​
price_qualifier
string | null
​
price_frequency
string | null
​
latitude
number | null
​
longitude
number | null
​
image
string | null
​
images
string[]
​
image_count
integer | null
​
floorplan_count
integer | null
​
tenure_type
string | null
​
added_or_reduced
string | null
​
listing_update_reason
string | null
​
listing_update_date
string | null
​
first_visible_date
string | null
​
let_available_date
string | null
​
is_premium
boolean | null
​
is_featured
boolean | null
​
branch_id
integer | null
​
branch_display_name
string | null
​
branch_phone
string | null
​
branch_image
string | null