# OnTheMarket Scraper (`parseforge/onthemarket-scraper`) Actor Scrape property listings from OnTheMarket.com across the UK. Search for-sale or to-rent properties by location, price, bedrooms, and property type. Extract prices, addresses, agent contacts, coordinates, images, EPC ratings, broadband speeds, nearby stations, and schools per listing. - **URL**: https://apify.com/parseforge/onthemarket-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Real estate, Lead generation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $10.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## 🏠 OnTheMarket Property Scraper Collect UK residential property listings from OnTheMarket.com without coding. This scraper captures exclusive sales and rental properties with full price data, photos, floor plans, and agent contact details. Whether you're a property analyst searching for OnTheMarket data extraction, a developer needing a UK property scraper with no setup required, or a market researcher downloading property listings in bulk, this tool extracts everything in minutes and exports to CSV, Excel, or JSON. > **The OnTheMarket Property Scraper collects UK residential property listings with up to 24 data fields per property, including exclusive listings not found on Rightmove or Zoopla, plus geographic coordinates and verified agent contact details.** ### ✨ What Does It Do - 🖼️ **Property Images** - Download cover images and full galleries to build visual catalogs or power real estate marketing campaigns - 💰 **Price Data** - Collect asking prices, price qualifiers, and values for accurate market analysis and trend forecasting - 🛏️ **Bedrooms & Bathrooms** - Get room counts to segment properties by size for investment analysis or buyer matching - 📍 **Location Coordinates** - Retrieve latitude and longitude for each property to map listings, calculate distance to amenities, or build geographic analysis - 📝 **Property Details** - Collect descriptions, tenure type, council tax bands, and 100+ features (garden, garage, pool) for comprehensive profiles - 👤 **Agent Information** - Gather agent names, phone numbers, and branch IDs to build agent databases or enable outreach for inquiries ### 🔧 Input - **Start URL** - Paste a direct OnTheMarket search URL to scrape results from that specific search. If provided, all filters below are ignored. - **Max Items** - Set how many properties to collect. Free users are limited to 10 items. Paid users can collect up to 1,000,000. - **Search Type** - Choose between "For Sale" or "To Rent" properties. - **Location** - Enter a UK location slug (e.g. 'london', 'manchester', 'bristol', 'edinburgh'). Use the location name as it appears in OnTheMarket URLs. - **Min Price (£)** - Set a minimum property price in British pounds to filter results. - **Max Price (£)** - Set a maximum property price in British pounds to filter results. - **Min Bedrooms** - Filter to properties with at least this many bedrooms - **Max Bedrooms** - Filter to properties with no more than this many bedrooms - **Property Type** - Filter by type: Detached, Semi-detached, Terraced, Flat/Apartment, Bungalow, Land, Commercial, or Other. - **Search Radius (miles)** - Set the search radius in miles around your chosen location. - **Include Property Details** - Enable this to get detailed property information including full descriptions, all floor plan URLs, tenure information, and complete feature lists. Returns much richer data. - **Max Concurrency** - Control how many properties to process in parallel. Lower this if you experience rate limiting. Example input configuration: ```json { "location": "london", "searchType": "for-sale", "maxItems": 10, "minPrice": 500000, "maxPrice": 1500000, "minBedrooms": 2, "propertyType": "detached", "includeDetails": false } ```` ### 📊 Output Each property includes up to 24 data fields. Download as JSON, CSV, or Excel. | 🖼️ Cover Image | 🏠 Property ID | 📝 Property Title | |---|---|---| | 📍 Full Address | 💰 Price (formatted) | 🔢 Price (raw number) | | 🏷️ Price Qualifier | 🛏️ Bedrooms | 🚿 Bathrooms | | 🏘️ Property Type | 📋 Search Type | 📖 Summary | | 🔑 Features List | 🧭 Latitude | 🧭 Longitude | | 👤 Agent Name | 📞 Agent Phone | 🏢 Agent Branch ID | | 📜 Tenure | 🏛️ Council Tax Band | 📐 Floor Plan URL | | 🖼️ All Image URLs | ⏱️ Days Since Listed | 🔗 Property Detail URL | | ✅ Scraped Timestamp | ### 💎 Why Choose the OnTheMarket Scraper? | Feature | Our Actor | |---|---| | Collects UK residential property listings | ✔️ | | Extracts price, bedrooms, bathrooms | ✔️ | | Captures agent contact information | ✔️ | | Gets full property descriptions | ✔️ | | Downloads images and floor plans | ✔️ | | Provides geographic coordinates | ✔️ | | Filters by price range | ✔️ | | Filters by property type (detached, flat, etc.) | ✔️ | | Exports to CSV, Excel, JSON | ✔️ | | Supports up to 1,000,000 items (paid users) | ✔️ | ### 📋 How to Use No technical skills required. Follow these simple steps: 1. **Sign Up**: [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) 2. **Find the Tool**: Search for "OnTheMarket Property Scraper" in the Apify Store and set up your input 3. **Run It**: Click "Start" and watch your results appear That's it. No coding, no setup, no complicated configuration. Now you can export your data in CSV, Excel, or JSON formats. ### 🎯 Business Use Cases - 📊 **Property Analysts** - Monitor price trends across London by collecting weekly listings to build a database of asking prices for market forecasting - 💼 **Real Estate Agents** - Collect competitor listings in your area to review price, identify gaps, and spot overpriced properties to win more listings - 🔬 **Property Investors** - Collect high-bedroom rental properties across Manchester to analyze yield potential and identify investment hotspots ### ❓ FAQ **🔍 How does this scraper work?** It extracts property data from OnTheMarket.com listings in real time, collecting all available information without requiring any special browser tools or complex setup. **📊 How accurate is the data?** Data is extracted directly from OnTheMarket.com listings as they appear on the site. Accuracy depends on what agents have entered. Enable "Include Property Details" for richer, more complete data. **📅 Can I schedule this to run automatically?** Yes. Use Make, Zapier, or GitHub Actions to trigger runs on a schedule. You can collect property listings daily, weekly, or monthly to monitor market changes over time. **⚖️ Is scraping OnTheMarket.com legal?** OnTheMarket.com contains publicly listed property data. It's your responsibility to ensure your use complies with their Terms of Service and local data laws. Always review their website terms before scraping at scale. **🛡️ Will OnTheMarket.com block me?** This scraper uses residential proxies by default to avoid IP blocking. If you experience rate limits, lower the "Max Concurrency" setting to reduce parallel requests. **⚡ How long does a run take?** A typical 10-property run takes 30 seconds to 2 minutes. Enabling "Include Property Details" adds 5-30 seconds per property. Larger batches scale linearly (e.g. 100 properties with details may take 10-20 minutes). **⚠️ Are there any limits?** Free users can collect up to 100 results per run. Paid users can collect up to 1,000,000 results per run. ### 🔗 Integrate OnTheMarket Property Scraper with any app - [Make](https://docs.apify.com/platform/integrations/make) - Automate workflows - [Zapier](https://docs.apify.com/platform/integrations/zapier) - Connect 5000+ apps - [GitHub](https://docs.apify.com/platform/integrations/github) - Version control integration - [Slack](https://docs.apify.com/platform/integrations/slack) - Get notifications - [Airbyte](https://docs.apify.com/platform/integrations/airbyte) - Data pipelines - [Google Drive](https://docs.apify.com/platform/integrations/drive) - Export to spreadsheets ### 💡 More ParseForge Actors - [HOA Documents Scraper](https://apify.com/parseforge/hoa-documents-scraper) - Extract HOA document data and meeting records - [Revival Animal Health Scraper](https://apify.com/parseforge/revival-animal-health-scraper) - Collect veterinary product listings and prices - [The Restaurant Warehouse Equipment Scraper](https://apify.com/parseforge/the-restaurant-warehouse-equipment-scraper) - Scrape catering equipment inventory and specifications - [Gamenation Scraper](https://apify.com/parseforge/gamenation-scraper) - Extract gaming product data and reviews - [Fisher Scientific Product Scraper](https://apify.com/parseforge/fisher-scientific-scraper) - Collect scientific equipment and supply information Browse our complete collection of [data extraction tools](https://apify.com/parseforge) for more. ### 🚀 Ready to Start? [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) and collect your first 100 results for free. No coding, no setup. ### 🆘 Need Help? - Check the FAQ section above for common questions - Visit the [Apify support page](https://docs.apify.com) for documentation and tutorials - Contact us to request a new scraper, propose a custom project, or report an issue at [Tally contact form](https://tally.so/r/BzdKgA) ### ⚠️ Disclaimer > This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by OnTheMarket.com or any of its subsidiaries. All trademarks mentioned are the property of their respective owners. # Actor input Schema ## `startUrl` (type: `string`): Direct OnTheMarket search URL to scrape (e.g. https://www.onthemarket.com/for-sale/property/london/). If provided, the filters below are ignored. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000. ## `searchType` (type: `string`): Whether to search for properties for sale or to rent. ## `location` (type: `string`): Location to search in (e.g. 'london', 'manchester', 'bristol'). Use the slug as it appears in OnTheMarket URLs. ## `minPrice` (type: `integer`): Minimum property price in GBP. ## `maxPrice` (type: `integer`): Maximum property price in GBP. ## `minBedrooms` (type: `integer`): Minimum number of bedrooms. ## `maxBedrooms` (type: `integer`): Maximum number of bedrooms. ## `propertyType` (type: `string`): Filter by property type. ## `radius` (type: `number`): Search radius in miles around the location. ## `includeDetails` (type: `boolean`): Fetch full property details (description, floor plans, key info, all images). Slower but returns much richer data. ## `maxConcurrency` (type: `integer`): Maximum number of parallel requests. Lower this if you get rate-limited. ## Actor input object example ```json { "maxItems": 10, "searchType": "for-sale", "location": "london", "propertyType": "", "includeDetails": false, "maxConcurrency": 5 } ``` # Actor output Schema ## `results` (type: `string`): Dataset with all scraped items # 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 = { "maxItems": 10, "location": "london", "includeDetails": false }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/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 = { "maxItems": 10, "location": "london", "includeDetails": False, } # Run the Actor and wait for it to finish run = client.actor("parseforge/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 '{ "maxItems": 10, "location": "london", "includeDetails": false }' | apify call parseforge/onthemarket-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/onthemarket-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OnTheMarket Scraper", "description": "Scrape property listings from OnTheMarket.com across the UK. Search for-sale or to-rent properties by location, price, bedrooms, and property type. Extract prices, addresses, agent contacts, coordinates, images, EPC ratings, broadband speeds, nearby stations, and schools per listing.", "version": "1.0", "x-build-id": "cGxDzFU7gIuQc0a0r" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~onthemarket-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~onthemarket-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~onthemarket-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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": { "startUrl": { "title": "Start URL", "type": "string", "description": "Direct OnTheMarket search URL to scrape (e.g. https://www.onthemarket.com/for-sale/property/london/). If provided, the filters below are ignored." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000." }, "searchType": { "title": "Search Type", "enum": [ "for-sale", "to-rent" ], "type": "string", "description": "Whether to search for properties for sale or to rent.", "default": "for-sale" }, "location": { "title": "Location", "type": "string", "description": "Location to search in (e.g. 'london', 'manchester', 'bristol'). Use the slug as it appears in OnTheMarket URLs." }, "minPrice": { "title": "Min Price (£)", "minimum": 0, "type": "integer", "description": "Minimum property price in GBP." }, "maxPrice": { "title": "Max Price (£)", "minimum": 0, "type": "integer", "description": "Maximum property price in GBP." }, "minBedrooms": { "title": "Min Bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of bedrooms." }, "maxBedrooms": { "title": "Max Bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum number of bedrooms." }, "propertyType": { "title": "Property Type", "enum": [ "", "detached", "semi-detached", "terraced", "flat", "bungalow", "land", "commercial", "other" ], "type": "string", "description": "Filter by property type.", "default": "" }, "radius": { "title": "Search Radius (miles)", "minimum": 0, "maximum": 40, "type": "number", "description": "Search radius in miles around the location." }, "includeDetails": { "title": "Include Property Details", "type": "boolean", "description": "Fetch full property details (description, floor plans, key info, all images). Slower but returns much richer data.", "default": false }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of parallel requests. Lower this if you get rate-limited.", "default": 5 } } }, "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 } } } } } } } } } } ```