# OnTheMarket Scraper — UK Property Listings & Prices (`studio-amba/onthemarket-scraper`) Actor Scrape property listings from OnTheMarket.com, the UK's #3 real estate portal. Search for-sale or to-rent by location. Get prices, addresses, bedrooms, bathrooms, coordinates, images, and estate agent details. No login or cookies required. - **URL**: https://apify.com/studio-amba/onthemarket-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 result scrapeds 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 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## OnTheMarket Scraper Scrape **property listings** from [OnTheMarket.com](https://www.onthemarket.com) — the UK's third-largest property portal after Rightmove and Zoopla. Extract prices, addresses, bedrooms, bathrooms, coordinates, images, and estate agent details for both **for-sale** and **to-rent** properties. No login or cookies required. ### What does OnTheMarket Scraper do? This Actor extracts structured property data from OnTheMarket search results at scale. Search by any UK location (city, town, or postcode area) and listing type, and get clean JSON output with all the key fields you need for property analysis, market research, or lead generation. Run it on the Apify platform for scheduled scraping, API access, webhook integrations, and automatic proxy rotation. ### Why use OnTheMarket Scraper? - **Market research** — track asking prices across UK regions over time - **Lead generation** — find estate agents actively listing in your target areas, with phone numbers - **Investment analysis** — compare asking prices, bedroom counts, and locations - **Data journalism** — build datasets on housing affordability by area - **Mapping and geo analysis** — every listing includes latitude and longitude - **Portfolio monitoring** — track new listings matching your criteria ### How to use OnTheMarket Scraper 1. Click **Try for free** to open the Actor in Apify Console 2. Enter a **location** (e.g. "london", "manchester", "bristol", or a postcode area like "sw1") 3. Choose a **listing type** (For Sale or To Rent) 4. Set the **maximum number of results** you need 5. Click **Start** and wait for results 6. Download your data as JSON, CSV, Excel, or connect via API ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `location` | String | No | UK location to search (default: `"london"`). City, town, or postcode area. | | `listingType` | String | No | `for-sale` (default) or `to-rent` | | `startUrls` | Array | No | OnTheMarket search URLs to scrape directly (overrides `location`) | | `maxResults` | Integer | No | Maximum listings to return (default: 100) | | `proxyConfiguration` | Object | No | Proxy settings. Not required, but a UK proxy improves reliability on large runs. | #### Example input ```json { "location": "london", "listingType": "for-sale", "maxResults": 100 } ```` You can also pass search URLs directly: ```json { "startUrls": [ { "url": "https://www.onthemarket.com/for-sale/property/manchester/" } ], "maxResults": 200 } ``` ### Output Each result contains: | Field | Type | Example | |-------|------|---------| | `name` | String | `"3 bedroom semi-detached house for sale"` | | `price` | Number | `500000` (null for POA / Price on application) | | `priceQualifier` | String | `"Guide price"` (sale) or `"pcm"` (rent) | | `currency` | String | `"GBP"` | | `listingType` | String | `"sale"` or `"rent"` | | `propertyType` | String | `"semi-detached house"` | | `address` | String | `"Tweed Way, Romford, RM1"` | | `city` | String | `"Romford"` | | `postalCode` | String | `"RM1"` | | `bedrooms` | Integer | `3` | | `bathrooms` | Integer | `2` | | `latitude` | Number | `51.599255` | | `longitude` | Number | `0.178415` | | `features` | Array | `["Tenure: Freehold", "Nearest station 1.7mi."]` | | `agencyName` | String | `"Bairstow Eves - Elm Park"` | | `agencyPhone` | String | `"01708 243888"` | | `agencyUrl` | String | Agent branch page URL | | `imageUrl` | String | Primary listing image URL | | `imageUrls` | Array | All listing image URLs | | `url` | String | Full listing URL | | `scrapedAt` | String | ISO 8601 timestamp | ### Example output ```json { "name": "3 bedroom semi-detached house for sale", "price": 500000, "currency": "GBP", "listingType": "sale", "priceQualifier": "Guide price", "propertyType": "semi-detached house", "address": "Tweed Way, Romford, RM1", "city": "Romford", "postalCode": "RM1", "bedrooms": 3, "bathrooms": 2, "latitude": 51.599255, "longitude": 0.178415, "features": [ "Tenure: Freehold", "Nearest station 1.7mi.", "Nearest school 0.2mi." ], "agencyName": "Bairstow Eves - Elm Park", "agencyPhone": "01708 243888", "agencyUrl": "https://www.onthemarket.com/agents/branch/bairstow-eves-elm-park/", "imageUrl": "https://media.onthemarket.com/properties/19101482/1619750532/image-0-480x320.jpg", "imageUrls": [ "https://media.onthemarket.com/properties/19101482/1619750532/image-0-480x320.jpg", "https://media.onthemarket.com/properties/19101482/1619750532/image-1-480x320.jpg" ], "url": "https://www.onthemarket.com/details/19101482/", "scrapedAt": "2026-07-06T18:24:28.304Z" } ``` ### How to scrape OnTheMarket data OnTheMarket organises its listings by location and listing type. A search URL looks like `https://www.onthemarket.com/for-sale/property/london/` for sales and `https://www.onthemarket.com/to-rent/property/manchester/` for rentals. This Actor turns that into structured data in three steps: 1. **Pick a location** — pass a city, town, or postcode area (for example `london`, `manchester`, `bristol`, or `sw1`). The Actor builds the correct search URL for you, or you can pass full search URLs in `startUrls`. 2. **Choose for-sale or to-rent** — set `listingType`. Rental prices are returned as the monthly figure (pcm) with `priceQualifier` set to `"pcm"`. 3. **Set how many results you want** — the Actor paginates automatically (30 listings per page) until it reaches `maxResults` or runs out of listings. Each listing is returned as a flat JSON object with prices as numbers (so you can sort and filter directly), absolute image and listing URLs, and latitude/longitude for mapping. Prices marked POA (Price on application) are returned as `null` so they are easy to filter out. For repeat monitoring, schedule the Actor to run daily or weekly and connect the dataset to your own tools via the Apify API, webhooks, or an integration such as Google Sheets or Zapier. ### How many results can I get? OnTheMarket returns 30 listings per page and caps a single search at roughly 1,000 listings (around 34 pages). For larger datasets, split your run by narrower locations (individual towns or postcode areas) or by price band using `startUrls` with the site's own filters. Set `maxResults` to control cost and run time. ### Cost estimate This Actor talks to OnTheMarket's public JSON search API over plain HTTP — no browser, no proxy required — so it is fast and cheap to run. A typical run of 1,000 listings completes in about a minute of compute. Actual cost depends on your Apify plan and the pay-per-result pricing shown on the Actor's Store page. ### Is it legal to scrape OnTheMarket? This Actor collects only publicly available listing information — the same data any visitor sees on the site — and does not access private or personal data beyond the estate agent contact details the site publishes on each listing. As with any scraping, use the data responsibly and in line with OnTheMarket's terms and applicable law. If you plan to scrape at scale or reuse the data commercially, take your own legal advice. ### Limitations / known issues - **Single search cap** — OnTheMarket limits one search to roughly 1,000 listings. Split by location or filters for bigger datasets. - **New-build developments** — a small number of development cards list "prices from" or POA and may return a `null` price and fewer detail fields. - **Floor area** — OnTheMarket does not expose floor area on search results, so `surface` is not included. Detail pages carry more fields if you need them. - **Rental fees** — full tenancy fee breakdowns are not scraped; the monthly rent is returned as `price`. ### Related Scrapers Building a UK or European property dataset? Combine OnTheMarket with our other real-estate Actors: - **Rightmove Scraper** — the UK's #1 property portal - **Zoopla Scraper** — the UK's #2 property portal - **Funda Scraper** — the leading Dutch property portal - **Immoweb Scraper** — Belgium's largest property portal - **Immobiliare Scraper** — Italy's largest property portal - **Otodom Scraper** — Poland's largest property portal - **Hemnet Scraper** — Sweden's largest property portal Search "Studio AMBA" on the Apify Store to see all our property and e-commerce Actors. # Actor input Schema ## `location` (type: `string`): Search for properties by location, e.g. 'london', 'manchester', 'birmingham', 'bristol', or a postcode area like 'sw1'. Used to build the search URL. ## `listingType` (type: `string`): Type of listing to search for. ## `startUrls` (type: `array`): Optional. OnTheMarket search result URLs to scrape (e.g. https://www.onthemarket.com/for-sale/property/london/). Overrides Location if provided. ## `maxResults` (type: `integer`): Maximum number of listings to return. OnTheMarket returns 30 listings per page. ## `proxyConfiguration` (type: `object`): Proxy settings. OnTheMarket does not require a proxy, but a UK proxy improves reliability on large runs. ## Actor input object example ```json { "location": "london", "listingType": "for-sale", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } } ``` # Actor output Schema ## `dataset` (type: `string`): No description # 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 = { "location": "london", "listingType": "for-sale", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/onthemarket-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 = { "location": "london", "listingType": "for-sale", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "GB", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/onthemarket-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 '{ "location": "london", "listingType": "for-sale", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } }' | apify call studio-amba/onthemarket-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/onthemarket-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OnTheMarket Scraper — UK Property Listings & Prices", "description": "Scrape property listings from OnTheMarket.com, the UK's #3 real estate portal. Search for-sale or to-rent by location. Get prices, addresses, bedrooms, bathrooms, coordinates, images, and estate agent details. No login or cookies required.", "version": "0.1", "x-build-id": "6yVD8glfKkWv6MiKb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~onthemarket-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-onthemarket-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/studio-amba~onthemarket-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-onthemarket-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/studio-amba~onthemarket-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-onthemarket-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": { "location": { "title": "Location", "type": "string", "description": "Search for properties by location, e.g. 'london', 'manchester', 'birmingham', 'bristol', or a postcode area like 'sw1'. Used to build the search URL." }, "listingType": { "title": "Listing Type", "enum": [ "for-sale", "to-rent" ], "type": "string", "description": "Type of listing to search for.", "default": "for-sale" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional. OnTheMarket search result URLs to scrape (e.g. https://www.onthemarket.com/for-sale/property/london/). Overrides Location if provided.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum number of listings to return. OnTheMarket returns 30 listings per page.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. OnTheMarket does not require a proxy, but a UK proxy improves reliability on large runs." } } }, "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 } } } } } } } } } } ```