# Rightmove Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/rightmove/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/rightmove-search |

## Description

Search Rightmove UK property listings by postcode or city and get price, bedrooms, tenure, agent, and coordinates as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/rightmove/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search semi-detached houses for sale in London SW19

```json
{
  "page": 1,
  "results": [
    {
      "id": "148239475",
      "lat": 51.4215,
      "lon": -0.2063,
      "url": "https://www.rightmove.co.uk/properties/148239475",
      "price": "£425,000",
      "title": "3 bedroom semi-detached house for sale",
      "images": [
        "https://media.rightmove.co.uk/dir/crop/10:9-16:9/148k/148239475/148239475_1_IMG_00_0000.jpeg"
      ],
      "tenure": "Freehold",
      "address": "Acacia Avenue, Wimbledon, London SW19",
      "added_on": "2026-04-25T09:00:00Z",
      "bedrooms": 3,
      "postcode": "SW19 3HJ",
      "bathrooms": 2,
      "size_sqft": 1250,
      "agent_name": "Savills - Wimbledon",
      "agent_phone": "020 8946 5454",
      "price_value": 425000,
      "property_type": "Semi-Detached",
      "price_qualifier": "Guide Price",
      "transaction_type": "sale"
    },
    {
      "id": "149017832",
      "lat": 51.4432,
      "lon": -0.1527,
      "url": "https://www.rightmove.co.uk/properties/149017832",
      "price": "£310,000",
      "title": "2 bedroom flat for sale",
      "images": [
        "https://media.rightmove.co.uk/dir/crop/10:9-16:9/149k/149017832/149017832_1_IMG_00_0000.jpeg"
      ],
      "tenure": "Leasehold",
      "address": "Balham High Road, Balham, London SW12",
      "added_on": "2026-04-24T11:30:00Z",
      "bedrooms": 2,
      "postcode": "SW12 9AD",
      "bathrooms": 1,
      "size_sqft": 760,
      "agent_name": "Foxtons - Balham",
      "agent_phone": "020 8772 8000",
      "price_value": 310000,
      "property_type": "Flat",
      "price_qualifier": "Fixed Price",
      "transaction_type": "sale"
    }
  ],
  "total_pages": 214,
  "total_results": 5124,
  "results_per_page": 24
}
```

### Search properties to rent by postcode SW1A

```json
{
  "page": 1,
  "results": [
    {
      "id": "147821093",
      "lat": 51.4975,
      "lon": -0.1356,
      "url": "https://www.rightmove.co.uk/properties/147821093",
      "price": "£2,250 pcm",
      "title": "1 bedroom flat to rent",
      "images": [
        "https://media.rightmove.co.uk/dir/crop/10:9-16:9/147k/147821093/147821093_1_IMG_00_0000.jpeg"
      ],
      "tenure": "Leasehold",
      "address": "Victoria Street, Westminster, London SW1",
      "added_on": "2026-04-26T08:00:00Z",
      "bedrooms": 1,
      "postcode": "SW1E 5ND",
      "bathrooms": 1,
      "size_sqft": 580,
      "agent_name": "Knight Frank - Westminster",
      "agent_phone": "020 7629 8171",
      "price_value": 2250,
      "property_type": "Flat",
      "price_qualifier": "",
      "transaction_type": "rent"
    }
  ],
  "total_pages": 13,
  "total_results": 312,
  "results_per_page": 24
}
```

## Documentation

## Overview
Rightmove is the UK's largest property portal. Piloterr handles its traffic monitoring and returns structured search results as clean JSON with a single GET request.

## Quickstart
```
GET https://api.piloterr.com/v2/rightmove/search?query=London&type=sale
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | UK postcode, city, town, or station |
| `type` | string | no | `sale` or `rent` (default: `sale`) |
| `property_type` | string | no | Filter: `detached`, `semi-detached`, `flat`, etc. |
| `min_price` | integer | no | Minimum price in GBP |
| `max_price` | integer | no | Maximum price in GBP |
| `min_bedrooms` | integer | no | Minimum bedrooms |
| `radius` | number | no | Search radius in miles |
| `page` | integer | no | Page number |

## Main use cases
- Track property price trends by postcode district
- Monitor new listings for buyer alert applications
- Aggregate listing volume and price data for investment funds
- Extract agent data at scale for estate agency CRM enrichment
- Build postcode-level property heatmaps

Get access at https://www.piloterr.com/pricing