Piloterr

Rightmove Search

GET
/v2/rightmove/search

Search Rightmove by a UK place name or a search URL. Each card has a numeric price, a price label rebuilt from that number, the address, the agent, and a property URL.

Credit cost: 2 credits per call

Autorización

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parámetros de consulta

query*string

UK place name or a Rightmove search URL.

Example (place):

Bristol

Example (search URL):

https://www.rightmove.co.uk/property-for-sale/Bristol.html

Allowed: any UK place Rightmove can slug, or a property-for-sale / property-to-rent / student search URL.

Default: none. Required.

JSON: a place opens property-for-sale. Cards then have channel BUY and transaction_type buy. A property-to-rent URL sets channel RENT, transaction_type rent, and price_frequency to pcm or pw when the card shows a rent period. results[].url is the link for /v2/rightmove/property. A /properties/{id} URL returns 400.

page?number

Results page, from 1.

Example:

2

Default: omitted. The URL is fetched as written and pagination.page comes from that page.

JSON: 1 sends index=0. 2 sends index=24 (24 results per page). pagination.page becomes that number. pagination.next is the next Rightmove URL, or null on the last page. Overrides index already on the URL.

return_page_source?boolean

Optional. Default false.

false returns the parsed JSON described below. true returns {"result": ""} and omits results, pagination, and listing fields.

Default"false"

Cuerpo de la respuesta

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/rightmove/search?query=string'
Example Response
{  "results": [    {      "id": 94960389,      "url": "https://www.rightmove.co.uk/properties/94960389",      "agent": {        "url": "https://www.rightmove.co.uk/estate-agents/agent/Kinleigh-Folkard-and-Hayward---Sales/Bayswater-55390.html",        "name": "Kinleigh Folkard & Hayward - Sales, Bayswater",        "phone": "020 3835 4072"      },      "image": "https://media.rightmove.co.uk/dir/crop/10:9-16:9/property-photo/2451b1f09/94960389/2451b1f09818a2091af4d44c668814d9_max_476x317.jpeg",      "price": 550000,      "tenure": "SHARE_OF_FREEHOLD",      "address": "Talbot Road, Notting Hill, London, W2",      "channel": "BUY",      "summary": "Talbot Road is one of the most desirable streets in the area, positioned between the vibrant neighbourhoods of Notting Hill and Bayswater. Residents enjoy immediate access to an outstanding selection of independent cafés, restaurants, boutiques, and local amenities, while the world-renowne...",      "bedrooms": 1,      "currency": "GBP",      "featured": false,      "latitude": 51.517913,      "bathrooms": 1,      "longitude": -0.193037,      "floor_area": "389 sq. ft.",      "image_count": 8,      "key_features": [        "One bedroom apartment",        "Private balcony",        "Excellent transport links",        "Chain free"      ],      "price_display": "£550,000",      "property_type": "Flat",      "listing_update": "Added today",      "price_frequency": null,      "price_qualifier": null,      "transaction_type": "buy"    }  ],  "pagination": {    "next": "https://www.rightmove.co.uk/property-for-sale/London-87490.html?index=24",    "page": 1,    "per_page": 24,    "total_pages": 42,    "total_results": 59708  }}