# Rightmove API (`truefetch/rightmove-api`) Actor

Search Rightmove sale and rental listings across the United Kingdom. Collect 40 normalized property fields covering prices, addresses, bedrooms, bathrooms, area, images, agent data, and source URLs.

- **URL**: https://apify.com/truefetch/rightmove-api.md
- **Developed by:** [TrueFetch](https://apify.com/truefetch) (community)
- **Categories:** Real estate, Lead generation, Agents
- **Stats:** 5 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $11.25 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

> **Affiliate disclosure:** Apify links in this README may include referral parameters. If you sign up through one of them, TrueFetch may receive a commission at no extra cost to you.

Rightmove Real Estate Listings converts one authorised United Kingdom sale or rental search into a bounded, source-attributed property dataset.

- Resolve a UK city, town, postcode, or area to a Rightmove region before collecting listing details.
- Choose sale or rent and a documented residential, flat, commercial, or new-home search path.
- Store up to 40 normalised fields covering identifiers, prices, rooms, area, location, images, features, agents, source URLs, and processing time.
- Public Store proof is an old deployment snapshot: 7 total users, 2 monthly active users, 1 bookmark, and no published ratings observed on July 21, 2026; the current repository remains authoritative for behaviour.

[Run Rightmove Real Estate Listings on Apify](https://console.apify.com/actors/jZ5lxtklcGzLkeOBT/input?utm_source=truefetch\&utm_medium=readme\&utm_campaign=rightmove-real-estate-listings) with a single permitted result before increasing scope.

### What does Rightmove Real Estate Listings do?

Rightmove Real Estate Listings is a dedicated Apify Actor for collecting listing-shaped records from Rightmove search flows in the United Kingdom. The current public contract requires `country`, `location`, and `max_results`; `listing_type` and `property_type` are optional. If transaction type is omitted, the runtime uses `for_sale`. Leaving property type empty avoids a narrower source path.

The Actor first resolves a location into Rightmove's internal region or postcode identifier. It then follows the matching residential, commercial, rental, or new-home search route, obtains candidate property links, fetches available details, normalises accepted records, and writes them to the default dataset. The 40-field schema is consistent across runs, but populated values depend on each advertiser's content.

TrueFetch is not Rightmove Group Limited and is not endorsed by Rightmove. This software does not create data rights. Rightmove's current Terms of Use prohibit scraping, bots, crawlers, and other automated collection, and require prior written consent from its Legal team for non-human extraction. Commercial research beyond the limited use described in those terms also requires consent. Do not run this Actor without the precise permission needed for access, storage, and downstream use.

### How do I run Rightmove Real Estate Listings?

Start with a simple place name or postcode that Rightmove can resolve. The shared scenario throughout this README checks one commercial property offered to let in Birmingham. It uses a separate runtime path from residential rentals, making it useful for confirming that the chosen filter reaches the intended source department.

```json
{
  "country": "United Kingdom",
  "location": "Birmingham",
  "max_results": 1,
  "listing_type": "for_rent",
  "property_type": "commercial"
}
```

Run the Actor once and inspect its terminal status, logs, and default dataset. Confirm that the item represents commercial space to let rather than a residential result, examine the location and price units, and compare the record with its `source_url` only when your permission permits that access.

The requested maximum is a ceiling, not a guaranteed count. Region resolution can fail for ambiguous text, the source may have no matching stock, listings can be removed while a run is active, and detail pages may omit enough information that a candidate is not saved. Increase volume only after reviewing authorisation, output quality, geography, and event charges from the one-result run.

### What data does Rightmove Real Estate Listings return?

Every saved item uses the same public dataset schema. This illustrative commercial-rental record is not a real or current advertisement:

```json
{
  "platform": "Rightmove",
  "title": "Example office to let in Birmingham",
  "listing_id": "example-listing-id",
  "listing_type": "for_rent",
  "property_type": "Commercial",
  "price": {
    "display": "£2,500 pcm",
    "value": 2500,
    "currency": "GBP",
    "period": "month"
  },
  "area": {
    "value": 1200,
    "unit": "sqft"
  },
  "location": "Birmingham",
  "address": {
    "city": "Birmingham",
    "country": "United Kingdom"
  },
  "cover_image": "https://example.com/property.jpg",
  "contact": {
    "name": "Example commercial agent"
  },
  "source_url": "https://www.rightmove.co.uk/properties/example",
  "processed_at": "2026-07-21T12:00:00Z"
}
```

The 40 possible fields cover identity and provenance (`platform`, `title`, `description`, `listing_id`, `mls_id`, `source_url`, `official_url`), classification (`listing_type`, `availability`, `market_type`, `property_type`, `subtype`, `category`, `business_type`), prices and physical facts (`price`, `rooms`, `area`, `land`, `building`, `dates`, `posted_time`, `fees`), place (`location`, `address`, `geo`, `country`, `nearby`), media and attributes (`cover_image`, `image_urls`, `media`, `open_houses`, `features`, `amenities`, `details`), contacts and policies (`contact`, `reviews`, `policies`, `units`), and collection metadata (`processor`, `processed_at`).

Do not require every field to be populated. Advertisers may withhold a full address or floor area, commercial pricing can use non-residential conventions, and descriptions or measurements can be inaccurate. Validate nested types, retain the source reference, and distinguish `processed_at` from any source-provided listing date.

### What inputs can I configure?

| Input | Required | Current accepted behaviour |
| --- | --- | --- |
| `country` | Yes | `United Kingdom` only; it selects the Rightmove route. |
| `location` | Yes | A Rightmove-recognised city, town, postcode, or area. |
| `max_results` | Yes | Integer from 1 to 10,000; saved output can be lower. |
| `listing_type` | No | `for_sale` or `for_rent`; omission uses `for_sale`. |
| `property_type` | No | `residential`, `apartment`, `condo`, `commercial`, or `new_development`. |

`apartment` and `condo` both set Rightmove's `flat` property filter. `commercial` selects commercial property for sale or to let according to `listing_type`. `new_development` selects new homes for sale and is not supported with `for_rent`; the runtime's route checks reject that invalid combination. `residential` and an empty property type use the general residential path, which can include houses even though `house` is not a separate public enum.

There is no public `posted_since`, price, bedroom, bathroom, radius, furnished, keyword, or station input. Source website controls that are absent from this schema are not supported Actor filters. Sending an undocumented key must not be treated as evidence that it changed the request.

### What platforms and markets does Rightmove Real Estate Listings cover?

This Actor covers one platform, Rightmove, and the United Kingdom market. It supports active sale and rental listing searches across general residential inventory, flats, commercial properties, and sale-only new developments. It does not claim sold house prices, valuation estimates, overseas listings, ownership data, planning records, mortgage products, agent directories, historical snapshots, or complete UK market coverage.

Location resolution relies on identifiers found through Rightmove's public location pages. A town such as Birmingham or a valid postcode is preferable to an ambiguous neighbourhood phrase. The source controls area names, boundaries, listing visibility, and advertiser content, so country coverage does not mean uniform results across England, Scotland, Wales, and Northern Ireland.

### Why use Rightmove Real Estate Listings?

For an expressly authorised workflow, the Actor provides a repeatable boundary around a UK listing source. A property team can review a narrowly scoped source feed, an advertiser can quality-check records it is entitled to use, and a developer can transform permitted listings into a common shape without writing a separate parser for each page variation.

Normalisation is not verification. Property information on Rightmove is supplied by members such as estate agents, letting agents, landlords, commercial agents, and developers. Rightmove's own terms say it does not verify that information. Asking prices, floor areas, availability, tenure, and descriptions must be confirmed with the advertiser and appropriate professional advisers.

Keep the workflow proportionate: collect the minimum authorised fields, preserve required attribution, restrict access, use short retention where possible, and avoid republishing images or descriptions unless the relevant rights are explicit. The Actor is not an estate agent, surveyor, conveyancer, valuer, lender, or investment adviser.

### Who is Rightmove Real Estate Listings for?

It may suit organisations that have written Rightmove consent and any advertiser permissions required for their purpose: authorised agencies, property managers, licensed data customers, researchers, portfolio teams, and developers building a controlled internal integration. The same Actor input can be used through Console, API, schedules, webhooks, clients, or MCP.

It is not for anonymous scraping, unapproved market research, database construction, bulk republication, direct asset embedding, unsolicited contact campaigns, or commercial exploitation without consent. Rightmove's allowance for a business user to manually search commercial listings does not by itself authorise automated collection. If your permission does not explicitly cover automation, do not run the Actor.

### How can I use Rightmove Real Estate Listings through the API or MCP?

The API identifier is `truefetch~rightmove-real-estate-listings`. Submit the five-field input to an Apify run endpoint and read the default dataset after confirming that the run completed. The synchronous dataset-items endpoint is suitable for the one-result Birmingham test; asynchronous runs offer better monitoring for larger permitted limits. See the [official Apify API page](https://apify.com/truefetch/rightmove-real-estate-listings/api) for current examples.

Register the current Actor ID in an MCP client when an approved agent workflow needs it:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors&actors=jZ5lxtklcGzLkeOBT"
    }
  }
}
```

The [Actor MCP setup page](https://apify.com/truefetch/rightmove-real-estate-listings/api/mcp) shows the latest connection flow. Store tokens as secrets, restrict tool access, set cost limits, and ensure an agent cannot expand locations, volumes, or purposes beyond the documented consent.

### How much does Rightmove Real Estate Listings cost?

Pricing is pay per event. A start event costs **$0.01000**. Each result pushed to the default dataset costs **$0.01250** on FREE, **$0.01208** on BRONZE, **$0.01167** on SILVER, and **$0.01125** on GOLD, PLATINUM, or DIAMOND. The one-result Birmingham scenario therefore has a maximum Actor-event charge of **$0.02250 on FREE**, before separate Apify plan or infrastructure usage.

The start event can be charged even if region resolution or inventory produces no saved records. Result events correspond to items actually pushed, not `max_results`. Verify the current Pricing tab before production because public event rates can change.

### How does Rightmove Real Estate Listings compare with alternatives?

Choose this Actor when Rightmove is the authorised UK source and the five-input interface covers the requirement. Zoopla Real Estate Listings is a separate United Kingdom portal integration and additionally exposes a supported recency filter. Global Real Estate Listings is designed for approved multi-platform or multi-country routing. Domain targets Australia, while Zillow, Realtor, and Redfin focus on North American markets.

Direct permission, an advertiser-owned feed, or a licensed data product may be safer when completeness, redistribution, stable schemas, or service commitments matter. Rightmove's platform terms expressly regulate automated access and research. Do not substitute an Actor for a source agreement when production depends on durable rights.

### What are the limits and troubleshooting steps?

Rightmove can change region lookup pages, identifiers, paths, markup, embedded data, or access controls without notice. Listings can disappear, pagination can yield fewer candidates, detail fetches can fail, and fields can be absent. Output may change between runs. The Actor provides no guarantee of completeness, accuracy, freshness, availability, or a minimum result count.

Before investigating code, confirm permission. The current terms at `https://www.rightmove.co.uk/c/terms-of-use/` prohibit automated collection and require prior written consent for non-human extraction. They also restrict research for commercial gain, reproduction, storage, linking, and direct asset access. Actor payment does not override those terms, advertiser rights, privacy law, intellectual-property law, or other applicable UK requirements.

For an authorised technical issue, retry the shared one-result commercial input; remove `property_type`; verify the location or postcode; inspect logs and dataset count; and compare any source record. Report the run ID, sanitised input, UTC timestamp, expected behaviour, actual behaviour, and exact error. Never disclose tokens, credentials, consent documents, or unnecessary personal data in a public issue.

### Frequently asked questions

#### Can it search houses even though `house` is not an enum?

Yes. Leave `property_type` empty or use `residential` for the general residential path, which can include houses.

#### Are apartment and condo different filters?

No. Both map to Rightmove's flat filter in the current runtime.

#### Can `new_development` be used for rentals?

No. It is accepted only with `for_sale`.

#### Does the Actor support a posted-date filter?

No. `posted_since` is not part of this Actor's public schema.

#### Does paying for the Actor grant automated-access rights?

No. Source consent and Actor event charges are separate matters.

### Related TrueFetch Actors

- [Global Real Estate Listings](https://apify.com/truefetch/global-real-estate-listings) — approved multi-source and multi-country searches.
- [Zoopla Real Estate Listings](https://apify.com/truefetch/zoopla-real-estate-listings) — another United Kingdom sale and rental source.
- [Domain Real Estate Listings](https://apify.com/truefetch/domain-real-estate-listings) — Australian sale and rental listings.
- [Redfin Real Estate Listings](https://apify.com/truefetch/redfin-real-estate-listings) — North American for-sale searches.

Choose the Actor whose authorised source, market, transaction type, and filter contract match the task.

### Support and last updated

Use the [Actor Issues tab](https://apify.com/truefetch/rightmove-real-estate-listings/issues) for reproducible technical defects and include a run ID with sanitised evidence. Keep credentials, personal information, and private permission documents out of public reports.

Documentation last verified **July 21, 2026** against the current repository's Actor metadata, input schema, dataset and storage schemas, pricing events, and read-only Rightmove execution path. The Store figures above are explicitly an older deployment snapshot and are not used to infer current repository support.

[Open Rightmove Real Estate Listings and run the one-result check](https://console.apify.com/actors/jZ5lxtklcGzLkeOBT/input?utm_source=truefetch\&utm_medium=readme\&utm_campaign=rightmove-real-estate-listings-support).

# Actor input Schema

## `country` (type: `string`):

Country where Rightmove listings will be searched

## `location` (type: `string`):

City, town, postcode, or area supported by Rightmove

## `max_results` (type: `integer`):

Maximum number of Rightmove property listings to return

## `listing_type` (type: `string`):

Choose the transaction status to search

## `property_type` (type: `string`):

Optional property or asset type filter. Leave empty to include all supported property types

## Actor input object example

```json
{
  "country": "United Kingdom",
  "location": "London",
  "max_results": 10
}
```

# Actor output Schema

## `results` (type: `string`):

Overview table for the default dataset of normalized property listings.

# 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 = {
    "country": "United Kingdom",
    "location": "London",
    "max_results": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("truefetch/rightmove-api").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 = {
    "country": "United Kingdom",
    "location": "London",
    "max_results": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("truefetch/rightmove-api").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 '{
  "country": "United Kingdom",
  "location": "London",
  "max_results": 10
}' |
apify call truefetch/rightmove-api --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/jZ5lxtklcGzLkeOBT/builds/QbCwereB0OvIbXkJz/openapi.json