# Rightmove Scraper (`one-api/rightmove-scraper`) Actor

Scrape Rightmove.co.uk UK property data — listings, full property details, branches (estate agents), Land Registry sold-price history, postcode to address lookup, and search-box autocomplete. Search by location, postcode, lat/lng radius, or paste-a-URL.

- **URL**: https://apify.com/one-api/rightmove-scraper.md
- **Developed by:** [ONE API](https://apify.com/one-api) (community)
- **Categories:** Real estate, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 listing returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Rightmove Scraper

Scrape **Rightmove.co.uk** (the UK's #1 property portal) — full property details, search listings, branch / estate-agent details, Land Registry sold-price history, postcode → address lookup, and search-box autocomplete — all from one Actor. Backed by [realtyapi.io](https://realtyapi.io)'s real-time Rightmove API.

⭐️ Found this useful? Please leave 5 stars! Issues / requests: 📬 **oneapi.project@gmail.com**

---

### What you can do

| Section | What it does | Input format |
|---|---|---|
| 🏠 **Property Details** | Full details for a specific listing | Rightmove `property_id` digits, listing URL, or full UK address — auto-detected per row |
| 🔎 **Search Listings** | Paginated search with full filter set | location string, UK postcode (`SW1A 1AA` or outcode `SW1A`), `lat,lng,radius_mi`, or Rightmove search URL |
| 🔍 **Autocomplete** | Search-box typeahead suggestions (regions, outcodes, stations) — each result has a `locationIdentifier` you can feed into a search URL | partial query string |
| 💰 **Sold Prices** | Land Registry sold-price history with full transaction history per address | location, postcode, or outcode |
| 🏢 **Branch / Estate Agent Details** | Full branch profile (name, address, telephone, opening hours, logo, sale/rent counts) | numeric `branchId` from any search/details row |
| 📮 **Postcode → Address** | Resolve a UK postcode to its list of full addresses (with internal ids) | full UK postcode |

You can fill any combination of sections in a single run — leave the others empty.

---

### Output

Each listing / property / branch / autocomplete suggestion / sold-price record / address is pushed as **one dataset row**, flattened to friendly columns plus a `Raw` column with the original JSON.

Key columns:

| Mode | Input Given | Property ID | Price | Beds | Address | Postcode | Branch Name | Listing URL | Raw |
|---|---|---|---|---|---|---|---|---|---|
| `search/bylocation` | London (p1) | 148711631 | £60,000,000 | 5 | One Hyde Park, Knightsbridge, London, SW1X | SW1X 7LJ | Global 1 | https://www.rightmove.co.uk/properties/148711631 | `{...}` |
| `details/byid` | 148711631 | 148711631 | £60,000,000 | 5 | One Hyde Park, Knightsbridge, London, SW1X | SW1X 7LJ | Global 1 | https://www.rightmove.co.uk/properties/148711631 | `{...}` |
| `sold-prices` | London (p1) | … | £90,000,000 | – | Flat 1.01, The Knightsbridge Apartments, Knightsbridge, London SW7 1RH | – | – | https://www.rightmove.co.uk/house-prices/details/… | `{...}` |

Plus: `Price Raw` (numeric), `Price Qualifier`, `Monthly Rent` (RENT channel), `Property Type` / `Sub Type`, `Latitude`, `Longitude`, `Size`, `First Visible Date`, `Photos` (cover URL), `Photo Count`, `Floorplan Count`, `Key Features`, `Full Description`, all `Branch *` fields, `Location Identifier` (autocomplete), `Date Sold` / `Tenure` (sold-prices).

For nested / large fields (full photo arrays, transaction history, agent opening hours, etc.) the complete upstream JSON is in the `Raw` column.

---

### Sample input

```json
{
    "property_inputs": [
        "148711631",
        "https://www.rightmove.co.uk/properties/148711631",
        "One Hyde Park, Knightsbridge, London, SW1X 7LA"
    ],
    "search_inputs": ["London", "SW1A 1AA"],
    "searchType": "BUY",
    "propertyType": "flat",
    "priceRange": "min:500000,max:1500000",
    "bedroomsRange": "min:2",
    "sortOrder": "newest",
    "pages": 2,
    "resultCount": 25,

    "autocomplete_inputs": ["Clapham Junction", "Manchester"],
    "sold_price_inputs": ["London"],
    "soldPriceType": "flat",
    "soldIn": 3,

    "branch_inputs": ["1941"],
    "postcode_inputs": ["SW1A 1AA"]
}
````

***

### Search filters (apply to all `search_inputs`)

- **searchType** — `BUY` (default) | `RENT`
- **propertyType** — comma list of `house, detached, semi_detached, terraced, flat, bungalow, commercial, land, park_home, student_halls, other`
- **priceRange** — `min:500000` | `max:1500000` | `min:500000,max:1500000` (RENT = £/month)
- **bedroomsRange / bathroomsRange** — `min:2` | `max:4` | `min:2,max:4`
- **radius** — miles around the resolved location centre (0–40)
- **sortOrder** — `highest_price`, `lowest_price`, `newest`, `oldest`, `distance`
- **pages** — how many pages to fetch (1–50). Each page = `resultCount` listings.
- **resultCount** — 1–40 per page (Rightmove server cap), default 25
- **mustHave / dontShow** — comma list of `garden, parking, new_home, retirement, house_share, shared_ownership, auction, student`
- **furnishType** — RENT only — `furnished, part_furnished, unfurnished`
- **letType** — RENT only — `long_term, short_term, student`
- **keywords** — free-text description search (e.g. `loft conversion,balcony`)
- **daysSinceAdded** — 1 / 3 / 7 / 14
- **includeUnavailable** — toggle: include sold / let-agreed listings

Filters apply to **every** `search_inputs` row in the run.

### Sold-price filters

- **soldPriceType** — `detached, semi_detached, terraced, flat, other`
- **soldTenure** — `FREEHOLD, LEASEHOLD`
- **soldIn** — last N years (1, 3, 5, …)

***

### Pricing

**Pay per result** — you only pay for dataset items the Actor pushes. Failed inputs return a row with `Status: ERROR: …` and are billed the same as a successful row.

To cap spend, set **Max paid dataset items** on the run page.

***

### Tips

- **Need just one property?** Use the `property_inputs` section — auto-detects `property_id`, listing URL, or full UK address.
- **Pull all listings in a city?** Use `search_inputs: ["London"]` and crank `pages` (each page up to 40 results — Rightmove server cap).
- **Use a lat/lng circle?** Format: `51.5074,-0.1278,3` (last value is radius in miles).
- **Replicate a Rightmove search URL?** Drop the URL straight into `search_inputs` — all filter params embedded in the URL are honoured.
- **Looking up an estate agent?** Take any `branch.id` from a search/details row and feed it into `branch_inputs`.
- **Cleaning a CRM postcode list?** Use `postcode_inputs` to expand each postcode into its full list of UK addresses.
- **Researching market history?** Use `sold_price_inputs` for Land Registry data — includes full transaction history per address in the `Raw` column.

# Actor input Schema

## `property_inputs` (type: `array`):

Auto-detects each entry: digits → property\_id, http(s) URL → listing URL, anything else → address. Each row = 1 property detail call.

## `search_inputs` (type: `array`):

Auto-detects each entry. Examples:
• `London` (location)
• `SW1A 1AA` or `SW1A` (UK postcode / outcode)
• `51.5074,-0.1278,3` (lat,lng,radius\_miles)
• `https://www.rightmove.co.uk/property-for-sale/find.html?locationIdentifier=REGION%5E87490` (search URL)

Filters below apply to every search. Each LISTING is pushed as one dataset item.

## `searchType` (type: `string`):

BUY (default) or RENT. RENT returns lettings with `monthlyRent` populated; price ranges are interpreted as £/month.

## `propertyType` (type: `string`):

Comma-separated. Leave empty for all. Allowed: house, detached, semi\_detached, terraced, flat, bungalow, commercial, land, park\_home, student\_halls, other. Example: `detached,flat`.

## `priceRange` (type: `string`):

`min:500000`, `max:1500000`, or `min:500000,max:1500000`. For RENT channel, values are £/month.

## `bedroomsRange` (type: `string`):

Examples: `min:2`, `max:4`, `min:2,max:4`.

## `bathroomsRange` (type: `string`):

Examples: `min:1`, `max:3`, `min:1,max:3`.

## `radius` (type: `string`):

Radius in miles around the resolved location centre (0-40). Default empty = region only. Used by bylocation / byzip searches.

## `sortOrder` (type: `string`):

How to sort search results.

## `pages` (type: `integer`):

1-based. Each page = up to `Result Count` listings.

## `resultCount` (type: `integer`):

Min 1, Max 40 (Rightmove server cap). Default 25.

## `mustHave` (type: `string`):

Comma-separated characteristics listings must have. Accepted: garden, parking, new\_home, retirement, house\_share, shared\_ownership, auction, student. Example: `garden,parking`.

## `dontShow` (type: `string`):

Comma-separated characteristics to exclude. Same vocabulary as Must Have. Example: `retirement,shared_ownership`.

## `furnishType` (type: `string`):

Comma-separated. Accepted: furnished, part\_furnished, unfurnished.

## `letType` (type: `string`):

Letting term.

## `keywords` (type: `string`):

Free-text keyword search over the listing description. Comma-separate multiple. Examples: `garden`, `loft conversion,balcony`, `period property`.

## `daysSinceAdded` (type: `string`):

Restrict to listings added in the last N days. Common values: 1, 3, 7, 14.

## `includeUnavailable` (type: `boolean`):

Include sold / let-agreed / unavailable listings.

## `autocomplete_inputs` (type: `array`):

Rightmove search-box typeahead. Returns region / outcode / station suggestions for each query, each with a `locationIdentifier` ready to feed into a search URL.

## `sold_price_inputs` (type: `array`):

UK sold-price history via Land Registry. Examples: `London`, `SW1A`, `Manchester`. Filters below (sold-price filters section) apply to all queries.

## `soldPriceType` (type: `string`):

Filter sold-price results to a single property type.

## `soldTenure` (type: `string`):

Freehold or Leasehold sales.

## `soldIn` (type: `integer`):

Last N years to include (1, 3, 5).

## `branch_inputs` (type: `array`):

Rightmove branch (estate agent) numeric id. Source from `branch.id` on any /search or /details result. Returns branch name, address, telephone, opening hours, logo URLs, lettings/sale counts.

## `postcode_inputs` (type: `array`):

Returns the list of full UK addresses (with internal `id`) for each postcode. Useful for address-level resolution before a /details/\* call.

## Actor input object example

```json
{
  "property_inputs": [
    "148711631",
    "https://www.rightmove.co.uk/properties/148711631",
    "One Hyde Park, Knightsbridge, London, SW1X 7LA"
  ],
  "search_inputs": [
    "London",
    "SW1A 1AA"
  ],
  "searchType": "BUY",
  "propertyType": "",
  "priceRange": "",
  "bedroomsRange": "",
  "bathroomsRange": "",
  "radius": "",
  "sortOrder": "newest",
  "pages": 1,
  "resultCount": 25,
  "mustHave": "",
  "dontShow": "",
  "furnishType": "",
  "letType": "",
  "keywords": "",
  "daysSinceAdded": "",
  "includeUnavailable": false,
  "soldPriceType": "",
  "soldTenure": "",
  "soldIn": 0,
  "branch_inputs": [
    "1941"
  ],
  "postcode_inputs": [
    "SW1A 1AA"
  ]
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "property_inputs": [
        "148711631",
        "https://www.rightmove.co.uk/properties/148711631",
        "One Hyde Park, Knightsbridge, London, SW1X 7LA"
    ],
    "search_inputs": [
        "London",
        "SW1A 1AA"
    ],
    "branch_inputs": [
        "1941"
    ],
    "postcode_inputs": [
        "SW1A 1AA"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("one-api/rightmove-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "property_inputs": [
        "148711631",
        "https://www.rightmove.co.uk/properties/148711631",
        "One Hyde Park, Knightsbridge, London, SW1X 7LA",
    ],
    "search_inputs": [
        "London",
        "SW1A 1AA",
    ],
    "branch_inputs": ["1941"],
    "postcode_inputs": ["SW1A 1AA"],
}

# Run the Actor and wait for it to finish
run = client.actor("one-api/rightmove-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "property_inputs": [
    "148711631",
    "https://www.rightmove.co.uk/properties/148711631",
    "One Hyde Park, Knightsbridge, London, SW1X 7LA"
  ],
  "search_inputs": [
    "London",
    "SW1A 1AA"
  ],
  "branch_inputs": [
    "1941"
  ],
  "postcode_inputs": [
    "SW1A 1AA"
  ]
}' |
apify call one-api/rightmove-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=one-api/rightmove-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Rightmove Scraper",
        "description": "Scrape Rightmove.co.uk UK property data — listings, full property details, branches (estate agents), Land Registry sold-price history, postcode to address lookup, and search-box autocomplete. Search by location, postcode, lat/lng radius, or paste-a-URL.",
        "version": "1.0",
        "x-build-id": "23HuhXL0qaVfRykAh"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/one-api~rightmove-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-one-api-rightmove-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/one-api~rightmove-scraper/runs": {
            "post": {
                "operationId": "runs-sync-one-api-rightmove-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/one-api~rightmove-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-one-api-rightmove-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "property_inputs": {
                        "title": "Property ID, Rightmove URL, or full Address (one per line)",
                        "type": "array",
                        "description": "Auto-detects each entry: digits → property_id, http(s) URL → listing URL, anything else → address. Each row = 1 property detail call.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "search_inputs": {
                        "title": "Location, postcode, lat/lng radius, or Rightmove search URL (one per line)",
                        "type": "array",
                        "description": "Auto-detects each entry. Examples:\n• `London` (location)\n• `SW1A 1AA` or `SW1A` (UK postcode / outcode)\n• `51.5074,-0.1278,3` (lat,lng,radius_miles)\n• `https://www.rightmove.co.uk/property-for-sale/find.html?locationIdentifier=REGION%5E87490` (search URL)\n\nFilters below apply to every search. Each LISTING is pushed as one dataset item.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "searchType": {
                        "title": "Search Type",
                        "enum": [
                            "BUY",
                            "RENT"
                        ],
                        "type": "string",
                        "description": "BUY (default) or RENT. RENT returns lettings with `monthlyRent` populated; price ranges are interpreted as £/month.",
                        "default": "BUY"
                    },
                    "propertyType": {
                        "title": "Property Type",
                        "type": "string",
                        "description": "Comma-separated. Leave empty for all. Allowed: house, detached, semi_detached, terraced, flat, bungalow, commercial, land, park_home, student_halls, other. Example: `detached,flat`.",
                        "default": ""
                    },
                    "priceRange": {
                        "title": "Price Range (£)",
                        "type": "string",
                        "description": "`min:500000`, `max:1500000`, or `min:500000,max:1500000`. For RENT channel, values are £/month.",
                        "default": ""
                    },
                    "bedroomsRange": {
                        "title": "Bedrooms Range",
                        "type": "string",
                        "description": "Examples: `min:2`, `max:4`, `min:2,max:4`.",
                        "default": ""
                    },
                    "bathroomsRange": {
                        "title": "Bathrooms Range",
                        "type": "string",
                        "description": "Examples: `min:1`, `max:3`, `min:1,max:3`.",
                        "default": ""
                    },
                    "radius": {
                        "title": "Search Radius (miles)",
                        "type": "string",
                        "description": "Radius in miles around the resolved location centre (0-40). Default empty = region only. Used by bylocation / byzip searches.",
                        "default": ""
                    },
                    "sortOrder": {
                        "title": "Sort Order",
                        "enum": [
                            "highest_price",
                            "lowest_price",
                            "newest",
                            "oldest",
                            "distance"
                        ],
                        "type": "string",
                        "description": "How to sort search results.",
                        "default": "newest"
                    },
                    "pages": {
                        "title": "Pages to fetch per query",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "1-based. Each page = up to `Result Count` listings.",
                        "default": 1
                    },
                    "resultCount": {
                        "title": "Results per page",
                        "minimum": 1,
                        "maximum": 40,
                        "type": "integer",
                        "description": "Min 1, Max 40 (Rightmove server cap). Default 25.",
                        "default": 25
                    },
                    "mustHave": {
                        "title": "Must Have",
                        "type": "string",
                        "description": "Comma-separated characteristics listings must have. Accepted: garden, parking, new_home, retirement, house_share, shared_ownership, auction, student. Example: `garden,parking`.",
                        "default": ""
                    },
                    "dontShow": {
                        "title": "Don't Show",
                        "type": "string",
                        "description": "Comma-separated characteristics to exclude. Same vocabulary as Must Have. Example: `retirement,shared_ownership`.",
                        "default": ""
                    },
                    "furnishType": {
                        "title": "Furnish Type (RENT only)",
                        "type": "string",
                        "description": "Comma-separated. Accepted: furnished, part_furnished, unfurnished.",
                        "default": ""
                    },
                    "letType": {
                        "title": "Let Type (RENT only)",
                        "enum": [
                            "",
                            "long_term",
                            "short_term",
                            "student"
                        ],
                        "type": "string",
                        "description": "Letting term.",
                        "default": ""
                    },
                    "keywords": {
                        "title": "Keywords",
                        "type": "string",
                        "description": "Free-text keyword search over the listing description. Comma-separate multiple. Examples: `garden`, `loft conversion,balcony`, `period property`.",
                        "default": ""
                    },
                    "daysSinceAdded": {
                        "title": "Days Since Added",
                        "enum": [
                            "",
                            "1",
                            "3",
                            "7",
                            "14"
                        ],
                        "type": "string",
                        "description": "Restrict to listings added in the last N days. Common values: 1, 3, 7, 14.",
                        "default": ""
                    },
                    "includeUnavailable": {
                        "title": "Include Unavailable",
                        "type": "boolean",
                        "description": "Include sold / let-agreed / unavailable listings.",
                        "default": false
                    },
                    "autocomplete_inputs": {
                        "title": "Autocomplete query (one per line)",
                        "type": "array",
                        "description": "Rightmove search-box typeahead. Returns region / outcode / station suggestions for each query, each with a `locationIdentifier` ready to feed into a search URL.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "sold_price_inputs": {
                        "title": "Sold-price query — location, postcode, or outcode (one per line)",
                        "type": "array",
                        "description": "UK sold-price history via Land Registry. Examples: `London`, `SW1A`, `Manchester`. Filters below (sold-price filters section) apply to all queries.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "soldPriceType": {
                        "title": "Sold Property Type",
                        "enum": [
                            "",
                            "detached",
                            "semi_detached",
                            "terraced",
                            "flat",
                            "other"
                        ],
                        "type": "string",
                        "description": "Filter sold-price results to a single property type.",
                        "default": ""
                    },
                    "soldTenure": {
                        "title": "Sold Tenure",
                        "enum": [
                            "",
                            "FREEHOLD",
                            "LEASEHOLD"
                        ],
                        "type": "string",
                        "description": "Freehold or Leasehold sales.",
                        "default": ""
                    },
                    "soldIn": {
                        "title": "Sold In (last N years)",
                        "minimum": 0,
                        "maximum": 50,
                        "type": "integer",
                        "description": "Last N years to include (1, 3, 5).",
                        "default": 0
                    },
                    "branch_inputs": {
                        "title": "Branch ID (one per line)",
                        "type": "array",
                        "description": "Rightmove branch (estate agent) numeric id. Source from `branch.id` on any /search or /details result. Returns branch name, address, telephone, opening hours, logo URLs, lettings/sale counts.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "postcode_inputs": {
                        "title": "UK Postcode (one per line)",
                        "type": "array",
                        "description": "Returns the list of full UK addresses (with internal `id`) for each postcode. Useful for address-level resolution before a /details/* call.",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
