# Rightmove Property Scraper (`crawlergang/rightmove-scraper`) Actor Scrape Rightmove, UK's largest property portal. Search properties for sale, to rent, or fetch any listing page by URL. Returns price, bedrooms, bathrooms, address, agent, images, and more. - **URL**: https://apify.com/crawlergang/rightmove-scraper.md - **Developed by:** [Crawler Gang](https://apify.com/crawlergang) (community) - **Categories:** Real estate, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 11 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 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 Property Scraper Scrape property listings from **Rightmove** — the UK's largest property portal. Find properties for sale, to rent, or fetch any Rightmove search page by URL. ### What You Can Scrape - **Properties for sale** — any UK city, town, or region - **Rental properties** — flats, houses, rooms to rent across the UK - **Any Rightmove listing page** — paste a URL and extract all listings ### Output Fields Each record contains: | Field | Description | |---|---| | `listingId` | Rightmove property ID | | `url` | Full URL to the property listing | | `title` | Property summary / description snippet | | `address` | Display address (e.g. `"Cart Lane, London, E4"`) | | `price` | Price as integer (GBP or per-month for rentals) | | `priceText` | Formatted price string (e.g. `"£580,000"`) | | `currency` | Currency code (`"GBP"`) | | `priceFrequency` | Price period for rentals (e.g. `"monthly"`) | | `bedrooms` | Number of bedrooms | | `bathrooms` | Number of bathrooms | | `propertyType` | Property subtype (e.g. `"Apartment"`, `"Detached"`) | | `tenure` | Tenure (e.g. `"Leasehold"`, `"Share Of Freehold"`) | | `displaySize` | Floor area if available (e.g. `"786 sq. ft."`) | | `latitude` | Geographic latitude | | `longitude` | Geographic longitude | | `agentName` | Estate agent / branch trading name | | `branchName` | Branch display name | | `agentPhone` | Agent contact telephone | | `agentUrl` | Agent branch page URL | | `imageUrls` | Array of property image URLs (up to 15) | | `keyFeatures` | Bullet-point features from the listing | | `listedDate` | Date the listing first appeared on Rightmove | | `lastUpdatedDate` | Date of the most recent listing update | | `updateReason` | Why the listing was updated (e.g. `"price_reduced"`) | | `addedOrReduced` | Summary of when added or price reduced | | `transactionType` | `"buy"` or `"rent"` | | `isPremiumListing` | Whether this is a premium listing | | `countryCode` | Country code (`"GB"`) | | `scrapedAt` | ISO 8601 timestamp of when the record was scraped | ### Input | Parameter | Type | Description | |---|---|---| | `mode` | select | `forSale` (default), `toRent`, or `byUrl` | | `location` | string | UK city or region name (e.g. `London`, `Manchester`) | | `startUrls` | array | Rightmove search or listing URLs (mode=byUrl only) | | `propertyType` | select | Filter by property type (blank = any) | | `minPrice` | integer | Minimum price in GBP | | `maxPrice` | integer | Maximum price in GBP | | `minBedrooms` | integer | Minimum number of bedrooms | | `maxBedrooms` | integer | Maximum number of bedrooms | | `radius` | select | Search radius in miles (default: this area only) | | `sortBy` | select | Sort order: most recent, price high/low, etc. | | `includeSSTC` | boolean | Include Sold STC / Let Agreed properties | | `newHomesOnly` | boolean | New-build properties only | | `maxItems` | integer | Max records to return (default: 50) | ### Example Inputs **Properties for sale in Manchester:** ```json { "mode": "forSale", "location": "Manchester", "maxItems": 50 } ```` **Rentals in Leeds under £1,500/month:** ```json { "mode": "toRent", "location": "Leeds", "maxPrice": 1500, "maxItems": 30 } ``` **3+ bedroom detached houses in Bristol:** ```json { "mode": "forSale", "location": "Bristol", "propertyType": "detached", "minBedrooms": 3, "maxItems": 50 } ``` **Fetch a specific search URL:** ```json { "mode": "byUrl", "startUrls": ["https://www.rightmove.co.uk/property-for-sale/Birmingham.html?maxPrice=300000"], "maxItems": 100 } ``` ### Use Cases - **Property market research** — track pricing trends across UK cities - **Investment analysis** — compare yields in different postcodes - **Lead generation** — find recently listed or price-reduced properties - **Portfolio monitoring** — track specific area markets over time - **Data journalism** — housing affordability analysis ### Data Source This actor scrapes **Rightmove** (`rightmove.co.uk`), the UK's largest property portal with over 900,000 properties listed at any time. Data is publicly accessible — no account or API key required. ### FAQ **Which locations are supported?** Any UK city, town, or region that Rightmove recognises by name. Examples: `London`, `Manchester`, `Edinburgh`, `Cardiff`, `Belfast`, `Oxford`, `Cambridge`, `Yorkshire`. **How many properties can I scrape?** Rightmove paginates results in groups of 24. The actor will paginate through all pages up to your `maxItems` limit. **Does this scrape new-build developments?** Yes — use the `newHomesOnly` flag to restrict to new builds, or leave it off to include all properties. **Can I filter by postcode?** Use the `byUrl` mode with a Rightmove search URL that includes your postcode as the location. **What's the price format?** Prices are returned as integers (GBP) in the `price` field, and as formatted strings in `priceText`. For rentals, the frequency (monthly/weekly) is in `priceFrequency`. # Actor input Schema ## `mode` (type: `string`): Scraping mode: search properties for sale, to rent, or fetch a specific listing page URL. ## `location` (type: `string`): City, town, or region name (e.g. `London`, `Manchester`, `Leeds`). Used in modes `forSale` and `toRent`. ## `startUrls` (type: `array`): One or more Rightmove search or listing page URLs. Used in mode `byUrl`. ## `propertyType` (type: `string`): Restrict results to a specific property type. Leave blank for all types. ## `minPrice` (type: `integer`): Minimum property price in GBP. Leave blank for no minimum. ## `maxPrice` (type: `integer`): Maximum property price in GBP. Leave blank for no maximum. ## `minBedrooms` (type: `integer`): Minimum number of bedrooms. ## `maxBedrooms` (type: `integer`): Maximum number of bedrooms. Leave blank for no maximum. ## `radius` (type: `string`): Search radius around the location in miles. ## `sortBy` (type: `string`): Sort order for results. ## `includeSSTC` (type: `boolean`): Include properties that are Sold Subject To Contract (SSTC) or Let Agreed. ## `newHomesOnly` (type: `boolean`): Only return new-build / new-home properties. ## `maxItems` (type: `integer`): Maximum number of property records to return. ## Actor input object example ```json { "mode": "forSale", "location": "London", "startUrls": [], "propertyType": "", "minBedrooms": 0, "radius": "0.0", "sortBy": "2", "includeSSTC": false, "newHomesOnly": false, "maxItems": 50 } ``` # Actor output Schema ## `properties` (type: `string`): Dataset containing all scraped Rightmove 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "forSale", "location": "London", "startUrls": [], "propertyType": "", "minBedrooms": 0, "radius": "0.0", "sortBy": "2", "includeSSTC": false, "newHomesOnly": false, "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlergang/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "forSale", "location": "London", "startUrls": [], "propertyType": "", "minBedrooms": 0, "radius": "0.0", "sortBy": "2", "includeSSTC": False, "newHomesOnly": False, "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("crawlergang/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 '{ "mode": "forSale", "location": "London", "startUrls": [], "propertyType": "", "minBedrooms": 0, "radius": "0.0", "sortBy": "2", "includeSSTC": false, "newHomesOnly": false, "maxItems": 50 }' | apify call crawlergang/rightmove-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlergang/rightmove-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Rightmove Property Scraper", "description": "Scrape Rightmove, UK's largest property portal. Search properties for sale, to rent, or fetch any listing page by URL. Returns price, bedrooms, bathrooms, address, agent, images, and more.", "version": "1.0", "x-build-id": "WfIIzxxMMNlSELT3G" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlergang~rightmove-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlergang-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/crawlergang~rightmove-scraper/runs": { "post": { "operationId": "runs-sync-crawlergang-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/crawlergang~rightmove-scraper/run-sync": { "post": { "operationId": "run-sync-crawlergang-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "forSale", "toRent", "byUrl" ], "type": "string", "description": "Scraping mode: search properties for sale, to rent, or fetch a specific listing page URL.", "default": "forSale" }, "location": { "title": "Location", "type": "string", "description": "City, town, or region name (e.g. `London`, `Manchester`, `Leeds`). Used in modes `forSale` and `toRent`.", "default": "London" }, "startUrls": { "title": "Start URLs (mode=byUrl)", "type": "array", "description": "One or more Rightmove search or listing page URLs. Used in mode `byUrl`.", "default": [], "items": { "type": "string" } }, "propertyType": { "title": "Property type filter", "enum": [ "", "detached", "semi-detached", "terraced", "flat", "bungalow", "land", "park home" ], "type": "string", "description": "Restrict results to a specific property type. Leave blank for all types.", "default": "" }, "minPrice": { "title": "Min price (GBP)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Minimum property price in GBP. Leave blank for no minimum." }, "maxPrice": { "title": "Max price (GBP)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Maximum property price in GBP. Leave blank for no maximum." }, "minBedrooms": { "title": "Min bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Minimum number of bedrooms.", "default": 0 }, "maxBedrooms": { "title": "Max bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Maximum number of bedrooms. Leave blank for no maximum." }, "radius": { "title": "Search radius (miles)", "enum": [ "0.0", "0.25", "0.5", "1.0", "2.0", "3.0", "5.0", "10.0", "15.0", "20.0", "30.0", "40.0" ], "type": "string", "description": "Search radius around the location in miles.", "default": "0.0" }, "sortBy": { "title": "Sort by", "enum": [ "2", "1", "6", "10", "4" ], "type": "string", "description": "Sort order for results.", "default": "2" }, "includeSSTC": { "title": "Include Sold STC / Let Agreed", "type": "boolean", "description": "Include properties that are Sold Subject To Contract (SSTC) or Let Agreed.", "default": false }, "newHomesOnly": { "title": "New homes only", "type": "boolean", "description": "Only return new-build / new-home properties.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of property records to return.", "default": 50 } } }, "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 } } } } } } } } } } ```