# Realtor.com Scraper (`h4sh/realtor-scraper`) Actor Scrape Realtor.com for property listings with prices, MLS data, agent info, school ratings, neighborhood data and 25+ fields. - **URL**: https://apify.com/h4sh/realtor-scraper.md - **Developed by:** [Dominique](https://apify.com/h4sh) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 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. 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 ## 🏠 Realtor.com Scraper **The most comprehensive Realtor.com data extraction tool on Apify** — scrape property listings with 25+ data fields including price history, school ratings, mortgage estimates, and agent info. Just $2 per 1,000 results. ### 🏆 Why This Actor? | Feature | This Actor | Competitor A | Competitor B | |---------|------------|-------------|---------------| | **Price** | **$2/1K results** | $5/1K results | $8/1K results | | **Data Fields** | **25+ fields** | 10-12 fields | 8-15 fields | | **Price History** | ✅ Full history | ❌ Not included | ✅ Limited | | **School Ratings** | ✅ With distance | ❌ Not included | ❌ Not included | | **Mortgage Estimates** | ✅ Monthly payment | ❌ Not included | ❌ Not included | | **Tax History** | ✅ Multi-year | ❌ Not included | ❌ Not included | | **Agent/Broker Info** | ✅ Name + phone | ⚠️ Name only | ❌ Not included | | **Anti-Bot Bypass** | ✅ Camoufox stealth | ⚠️ Basic | ⚠️ Frequent blocks | | **Search Modes** | 3 (location/zip/URL) | 1 (URL only) | 2 (location/URL) | | **Geo Coordinates** | ✅ Lat/Lon | ❌ | ⚠️ Sometimes | | **Photo URLs** | ✅ All photos (HD) | ⚠️ Primary only | ✅ All photos | | **Open Houses** | ✅ Dates & times | ❌ | ❌ | ### ✨ Key Features - 🏠 **25+ Data Fields** — Address, price, beds/baths, sqft, lot size, year built, MLS#, and much more - 💰 **Price History** — Complete price change timeline with dates, prices, and events - 🏫 **School Ratings** — Nearby schools with GreatSchools ratings, distance, and grade levels - 📊 **Mortgage Estimates** — Estimated monthly payment from Realtor.com's calculator - 🔍 **3 Search Modes** — Search by city/state, zip code, or paste direct URLs - 🛡️ **Kasada Anti-Bot Bypass** — Camoufox stealth browser with residential proxies - 📸 **HD Photo URLs** — All property photos in high resolution (1024×768) - 🏷️ **Smart Filters** — Filter by property type, price range, bedrooms, and listing status - ⚡ **Pagination** — Automatically crawls all search result pages - 📋 **Tax History** — Multi-year property tax and assessment records ### 📥 Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchLocation` | String | - | City and state (e.g., "San Francisco, CA") | | `zipCode` | String | - | US zip code (e.g., "90210") | | `startUrls` | Array | - | Direct Realtor.com search or property URLs | | `propertyType` | Select | `any` | Filter: single-family, condo, townhouse, land, etc. | | `listingStatus` | Select | `for-sale` | Filter: for-sale, for-rent, recently-sold, pending | | `minPrice` | Integer | - | Minimum listing price (USD) | | `maxPrice` | Integer | - | Maximum listing price (USD) | | `minBeds` | Integer | - | Minimum bedrooms | | `maxItems` | Integer | `100` | Maximum properties to scrape | | `scrapeDetails` | Boolean | `true` | Visit each property for full details | | `maxConcurrency` | Integer | `3` | Parallel page processing (1-5) | | `proxyConfiguration` | Object | Residential | Proxy settings (residential recommended) | #### Input Examples **Search by location:** ```json { "searchLocation": "San Francisco, CA", "propertyType": "single-family-home", "maxPrice": 1500000, "maxItems": 50 } ```` **Search by zip code:** ```json { "zipCode": "90210", "listingStatus": "for-sale", "minBeds": 3, "maxItems": 100 } ``` **Direct URLs:** ```json { "startUrls": [ { "url": "https://www.realtor.com/realestateandhomes-search/San-Francisco_CA" }, { "url": "https://www.realtor.com/realestateandhomes-detail/16-Sea-Cliff-Ave_San-Francisco_CA_94121_M21813-49460" } ], "maxItems": 200 } ``` ### 📤 Sample Output ```json { "url": "https://www.realtor.com/realestateandhomes-detail/16-Sea-Cliff-Ave_San-Francisco_CA_94121_M21813-49460", "address": "16 Sea Cliff Ave", "city": "San Francisco", "state": "CA", "zipCode": "94121", "price": 6800000, "pricePerSqft": 1580.23, "beds": 5, "baths": 4.5, "sqft": 4303, "lotSize": "0.18 acres", "propertyType": "single_family", "yearBuilt": 1925, "mlsNumber": "424067890", "listingStatus": "for_sale", "daysOnMarket": 45, "description": "Spectacular Sea Cliff residence with breathtaking panoramic views of the Golden Gate Bridge, Marin Headlands and the Pacific Ocean...", "agentName": "Jane Smith", "brokerName": "Compass Real Estate", "agentPhone": "(415) 555-0123", "openHouses": [ { "start": "2026-04-05T13:00:00", "end": "2026-04-05T16:00:00", "description": "Open House Saturday 1-4 PM" } ], "priceHistory": [ { "date": "2026-02-15", "price": 6800000, "event": "Listed", "source": "SFAR MLS" }, { "date": "2022-06-10", "price": 5950000, "event": "Sold", "source": "SFAR MLS" }, { "date": "2022-03-20", "price": 6200000, "event": "Listed", "source": "SFAR MLS" } ], "schools": [ { "name": "Sutro Elementary", "rating": 8, "distance": 0.3, "grades": "K-5", "type": "elementary", "fundingType": "public" }, { "name": "Roosevelt Middle", "rating": 7, "distance": 0.8, "grades": "6-8", "type": "middle", "fundingType": "public" }, { "name": "Washington High", "rating": 7, "distance": 1.2, "grades": "9-12", "type": "high", "fundingType": "public" } ], "neighborhood": { "name": "Sea Cliff", "noiseScore": 2, "floodRisk": 1 }, "mortgageEstimate": 38500, "photoUrls": [ "https://ap.rdcpix.com/abc123/od-w1024_h768.jpg", "https://ap.rdcpix.com/def456/od-w1024_h768.jpg" ], "photoCount": 42, "latitude": 37.7872, "longitude": -122.4893, "features": [ "Interior: Hardwood floors throughout", "Interior: Gourmet chef's kitchen", "Exterior: Ocean-view deck", "Exterior: Landscaped garden", "Parking: 2-car garage" ], "hoaFee": null, "taxHistory": [ { "year": 2025, "tax": 72000, "assessment": 5800000 }, { "year": 2024, "tax": 68000, "assessment": 5500000 } ], "garage": "2", "propertyId": "M21813-49460", "scrapedAt": "2026-03-30T23:00:00+00:00" } ``` ### 💡 Use Cases - 🏡 **Real Estate Investment Analysis** — Compare property prices, price per sqft, and price history across neighborhoods to identify undervalued properties - 📊 **Market Research** — Track listing inventory, days on market, and pricing trends by zip code or city - 🏫 **School District Analysis** — Find properties near top-rated schools for families or investors targeting family-friendly areas - 🤖 **Property Data Aggregation** — Feed listings into your own real estate platform, CRM, or analysis pipeline - 💵 **Mortgage & Tax Research** — Analyze mortgage estimates and tax history for investment ROI calculations - 📸 **Listing Photography** — Collect high-res property photos for market analysis or presentation decks - 🏘️ **Neighborhood Comparison** — Compare noise scores, flood risk, and amenities across different areas ### 💲 Pricing - **$2 per 1,000 results** — the most affordable Realtor.com scraper on Apify - Search results (basic data): ~$0.002 per property - Detail pages (full 25+ fields): ~$0.002 per property - Free tier available for testing ### 🔗 Related Actors Build your complete real estate data pipeline: - 🏠 [**Zillow Scraper**](https://apify.com/h4sh/zillow-scraper) — Scrape property data from Zillow.com - 🚗 [**Cars.com Scraper**](https://apify.com/h4sh/carscom-scraper) — Vehicle listings from Cars.com - 🚙 [**AutoTrader Scraper**](https://apify.com/h4sh/autotrader-scraper) — Vehicle listings from AutoTrader.com - 💊 [**GoodRx Drug Price Scraper**](https://apify.com/h4sh/goodrx-drug-price-scraper) — Prescription drug prices - 🛍️ [**Etsy Scraper**](https://apify.com/h4sh/etsy-scraper) — Products and shops from Etsy - 👗 [**Poshmark Scraper**](https://apify.com/h4sh/poshmark-scraper) — Fashion listings from Poshmark - 👔 [**Vinted Scraper**](https://apify.com/h4sh/vinted-scraper) — Secondhand clothing from Vinted - 🏥 [**ZocDoc Doctor Finder**](https://apify.com/h4sh/zocdoc-doctor-finder) — Doctor profiles and ratings - 🛡️ [**Anti-Bot Bypass Service**](https://apify.com/h4sh/anti-bot-bypass) — Universal anti-bot bypass tool ### ⚙️ Technical Details - **Runtime**: Python 3.12 on Apify platform - **Browser**: Camoufox stealth browser (Playwright-based Firefox with anti-fingerprinting) - **Anti-Bot**: Bypasses Kasada protection with residential proxies and human-like behavior - **Extraction**: Primary: `__NEXT_DATA__` JSON extraction | Fallback: HTML CSS selectors - **Rate Limiting**: Built-in delays, retry logic with exponential backoff - **Memory**: Recommended 4-8 GB for optimal performance ### 📝 Notes - Realtor.com uses Kasada anti-bot protection — residential proxies are **required** for reliable operation - Detail page scraping provides significantly more data (price history, schools, mortgage) but is slower - Set `scrapeDetails: false` for faster scraping with basic data only - The actor respects rate limits to avoid IP blocks — expect ~2-3 seconds per page - Maximum ~42 results per search page, pagination is automatic # Actor input Schema ## `searchLocation` (type: `string`): City and state to search (e.g., 'San Francisco, CA', 'Austin\_TX'). Leave blank if using URLs or zip codes. ## `zipCode` (type: `string`): US zip code to search (e.g., '90210', '10001'). Leave blank if using location or URLs. ## `startUrls` (type: `array`): List of Realtor.com search or property detail URLs. Overrides location/zip if provided. ## `propertyType` (type: `string`): Filter by property type. ## `listingStatus` (type: `string`): Filter by listing status. ## `minPrice` (type: `integer`): Minimum listing price filter (USD). ## `maxPrice` (type: `integer`): Maximum listing price filter (USD). ## `minBeds` (type: `integer`): Minimum number of bedrooms. ## `maxItems` (type: `integer`): Maximum number of properties to scrape. ## `scrapeDetails` (type: `boolean`): Visit each property page for full details (price history, schools, mortgage estimates). Slower but more data. ## `maxConcurrency` (type: `integer`): Maximum number of pages to process simultaneously. ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies recommended for Realtor.com. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.realtor.com/realestateandhomes-search/San-Francisco_CA" } ], "propertyType": "any", "listingStatus": "for-sale", "maxItems": 100, "scrapeDetails": true, "maxConcurrency": 3, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing scraped property data from Realtor.com. # 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 = { "startUrls": [ { "url": "https://www.realtor.com/realestateandhomes-search/San-Francisco_CA" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("h4sh/realtor-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 = { "startUrls": [{ "url": "https://www.realtor.com/realestateandhomes-search/San-Francisco_CA" }] } # Run the Actor and wait for it to finish run = client.actor("h4sh/realtor-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 '{ "startUrls": [ { "url": "https://www.realtor.com/realestateandhomes-search/San-Francisco_CA" } ] }' | apify call h4sh/realtor-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=h4sh/realtor-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Realtor.com Scraper", "description": "Scrape Realtor.com for property listings with prices, MLS data, agent info, school ratings, neighborhood data and 25+ fields.", "version": "0.1", "x-build-id": "fdBZmghGOq8hpHPfY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/h4sh~realtor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-h4sh-realtor-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/h4sh~realtor-scraper/runs": { "post": { "operationId": "runs-sync-h4sh-realtor-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/h4sh~realtor-scraper/run-sync": { "post": { "operationId": "run-sync-h4sh-realtor-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": { "searchLocation": { "title": "Search Location", "type": "string", "description": "City and state to search (e.g., 'San Francisco, CA', 'Austin_TX'). Leave blank if using URLs or zip codes." }, "zipCode": { "title": "Zip Code", "type": "string", "description": "US zip code to search (e.g., '90210', '10001'). Leave blank if using location or URLs." }, "startUrls": { "title": "Direct URLs", "type": "array", "description": "List of Realtor.com search or property detail URLs. Overrides location/zip if provided.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "propertyType": { "title": "Property Type", "enum": [ "any", "single-family-home", "condo", "townhouse", "multi-family-home", "land", "farm", "mobile-home", "co-op" ], "type": "string", "description": "Filter by property type.", "default": "any" }, "listingStatus": { "title": "Listing Status", "enum": [ "for-sale", "for-rent", "recently-sold", "pending" ], "type": "string", "description": "Filter by listing status.", "default": "for-sale" }, "minPrice": { "title": "Min Price", "type": "integer", "description": "Minimum listing price filter (USD)." }, "maxPrice": { "title": "Max Price", "type": "integer", "description": "Maximum listing price filter (USD)." }, "minBeds": { "title": "Min Beds", "type": "integer", "description": "Minimum number of bedrooms." }, "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of properties to scrape.", "default": 100 }, "scrapeDetails": { "title": "Scrape Property Details", "type": "boolean", "description": "Visit each property page for full details (price history, schools, mortgage estimates). Slower but more data.", "default": true }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Maximum number of pages to process simultaneously.", "default": 3 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies recommended for Realtor.com.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```