Rightmove

Search Rightmove properties

Searches Rightmove listings for a required location id, for sale (default) or to_let, 1-indexed by page. Filter by price, bedrooms, bathrooms, property_type, radius, must_have, dont_show and tenure_types; sort defaults to newest_listed. Returns total and results with price, address, beds, baths, size and tenure.

get/rightmove/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/rightmove/search
  • Auth: API key in header x-api-key

Query parameters

locationstring required

Rightmove location identifier from autocomplete

pageinteger

Result page (default 1)

status'for_sale' | 'to_let'

Listing status (default for_sale)

min_priceinteger

Minimum price in whole GBP units, not pence

max_priceinteger

Maximum price in whole GBP units, not pence

min_bedroomsinteger

Minimum bedrooms

max_bedroomsinteger

Maximum bedrooms

min_bathroomsnumber

Minimum bathrooms

max_bathroomsnumber

Maximum bathrooms

property_type'detached' | 'semi-detached' | 'terraced' | 'flat' | 'bungalow' | 'land' | 'park-home' | 'private-halls'

Property type filter. Accepts one or more comma-separated values. private-halls (Student Halls) mainly returns results for status=to_let.

radius0 | 0.25 | 0.5 | 1 | 3 | 5 | 10 | 15 | 20 | 30 | 40

Search radius in miles around location, default 0 (this area only)

must_have'garden' | 'parking' | 'retirement' | 'newHome' | 'sharedOwnership' | 'auction'

Require listings to have these attributes. Accepts one or more comma-separated values.

dont_show'newHome' | 'retirement' | 'sharedOwnership' | 'auction'

Exclude listings with these attributes. Accepts one or more comma-separated values.

tenure_types'FREEHOLD' | 'LEASEHOLD' | 'SHARE_OF_FREEHOLD'

Tenure filter. Accepts one or more comma-separated values.

sort'lowest_price' | 'highest_price' | 'newest_listed' | 'oldest_listed'

Result sort order, default newest_listed

Headers

x-api-keystring required

API key required

Response

Property search results

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "location": "REGION^87490",
    "page": 1,
    "results": [
      {
        "added_or_reduced": "Price reduced",
        "address": "123 Example Street, London",
        "bathrooms": 2,
        "bedrooms": 3,
        "currency": "GBP",
        "days_on_market": 14,
        "development": true,
        "id": "12345678",
        "image": "https://media.rightmove.co.uk/property-photo/.../12345678.jpg",
        "price": 500000,
        "price_frequency": "monthly",
        "price_text": "£500,000",
        "property_type": "Semi-detached",
        "receptions": 2,
        "size": "538 sq. ft.",
        "status": "For Sale",
        "tenure": "LEASEHOLD",
        "title": "3 bedroom semi-detached house for sale",
        "url": "https://www.rightmove.co.uk/properties/12345678"
      }
    ],
    "total": 1245
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.