# Redfin Scraper (`h4sh/redfin-scraper`) Actor Scrape Redfin for property listings with prices, Redfin Estimates, walk/transit/bike scores, price history, tax data, photos and 30+ data fields. API-first with anti-bot bypass. - **URL**: https://apify.com/h4sh/redfin-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 Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Redfin Scraper 🏠 **The most powerful Redfin scraper on Apify** — extract 30+ data fields including prices, Redfin Estimates, walk/transit/bike scores, price history, tax records, agent info, and photos from any Redfin listing. ### 🏆 Why This Actor? | Feature | This Actor | Competitors | |---------|-----------|-------------| | **Data Fields** | 30+ fields | 10-15 fields | | **Redfin Estimate** | ✅ AVM valuation | ❌ Not available | | **Walk/Transit/Bike Scores** | ✅ All three scores | ❌ Not available | | **Price History** | ✅ Full history | ❌ Not available | | **Tax History** | ✅ Full records | ❌ Not available | | **Photo URLs** | ✅ All listing photos | ❌ 1 thumbnail | | **Input Modes** | Search URL + location text | URL only | | **Architecture** | API-first (fast) + browser fallback | Browser only (slow) | | **Anti-Bot Bypass** | ✅ Camoufox stealth browser | Basic requests | | **Price per 1K** | **$2.00** | $3.00-5.00 | ### ✨ Key Features - 🏠 **30+ Data Fields** — Address, price, Redfin Estimate, beds, baths, sqft, lot size, year built, property type, and more - 📊 **Redfin Estimate (AVM)** — Proprietary automated valuation model data - 🚶 **Walk/Transit/Bike Scores** — Neighborhood walkability, transit access, and bike-friendliness scores - 💰 **Price & Tax History** — Full price change history and property tax records - 📸 **Photo URLs** — Extract all listing photo URLs per property - 👤 **Agent & Broker Info** — Listing agent name and brokerage - 🔍 **Flexible Input** — Search by Redfin URL or location name (city, ZIP, address) - ⚡ **API-First Architecture** — Uses Redfin's Stingray API for speed, with Camoufox browser fallback - 🛡️ **Anti-Bot Bypass** — Handles Cloudflare WAF and rate limiting with smart retries - 🎯 **Advanced Filters** — Property type, price range, bedrooms, bathrooms, square footage ### 📥 Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchUrls` | Array | — | Redfin search URLs (go to redfin.com, search, paste URL) | | `location` | String | — | Search by location name (city, ZIP, address, neighborhood) | | `propertyType` | String | `all` | Filter: all, house, condo, townhouse, multi-family, land, other | | `listingStatus` | String | `active` | Filter: active, active_pending, pending, sold | | `minPrice` | Integer | — | Minimum listing price in USD | | `maxPrice` | Integer | — | Maximum listing price in USD | | `minBeds` | Integer | — | Minimum bedrooms | | `maxBeds` | Integer | — | Maximum bedrooms | | `minBaths` | Integer | — | Minimum bathrooms | | `maxBaths` | Integer | — | Maximum bathrooms | | `minSqft` | Integer | — | Minimum square footage | | `maxSqft` | Integer | — | Maximum square footage | | `maxResults` | Integer | `100` | Maximum listings to scrape | | `includeDetails` | Boolean | `true` | Fetch full details (Redfin Estimate, scores, history) | | `proxy` | Object | Residential | Proxy settings (residential recommended) | #### Input Examples **Search by URL** (recommended): ```json { "searchUrls": [ "https://www.redfin.com/city/29439/WA/Seattle" ], "maxResults": 50, "includeDetails": true } ```` **Search by location**: ```json { "location": "San Francisco, CA", "propertyType": "house", "minPrice": 500000, "maxPrice": 1500000, "minBeds": 3, "maxResults": 100 } ``` **With filters in URL**: ```json { "searchUrls": [ "https://www.redfin.com/city/29439/WA/Seattle/filter/min-price=500k,max-price=1M,min-beds=3" ], "maxResults": 200, "includeDetails": true } ``` **Fast mode (search results only)**: ```json { "location": "Austin, TX", "maxResults": 500, "includeDetails": false } ``` ### 📤 Sample Output ```json { "propertyId": 12345678, "listingId": 87654321, "address": "123 Main St", "city": "Seattle", "state": "WA", "zipCode": "98101", "price": 750000, "beds": 3, "baths": 2.5, "sqft": 1850, "lotSize": 5000, "yearBuilt": 2005, "propertyType": "Single Family Residential", "listingStatus": "Active", "daysOnMarket": 12, "pricePerSqft": 405, "hoaMonthly": null, "mlsNumber": "2145678", "latitude": 47.6062, "longitude": -122.3321, "redfinEstimate": 765000, "walkScore": 85, "transitScore": 72, "bikeScore": 68, "description": "Beautiful 3-bedroom home in the heart of Seattle...", "photos": [ "https://ssl.cdn-redfin.com/photo/1/bigphoto/123/456.jpg", "https://ssl.cdn-redfin.com/photo/1/bigphoto/123/457.jpg" ], "priceHistory": [ {"date": "2024-03-15", "event": "Listed", "price": 750000}, {"date": "2024-02-01", "event": "Sold", "price": 720000} ], "taxHistory": [ {"year": 2023, "taxAmount": 8500, "assessedValue": 695000} ], "listingAgent": "Jane Smith", "listingBrokerage": "Redfin Corp", "url": "https://www.redfin.com/WA/Seattle/123-Main-St-98101/home/12345678", "scrapedAt": "2026-04-11T17:00:00Z" } ``` ### 💰 Pricing | Plan | Cost | Details | |------|------|---------| | **Pay Per Result** | $2.00 / 1,000 results | Only pay for data you get | | **Actor Start** | $0.005 per run | One-time charge per execution | | **Platform Costs** | Usage-based | Apify compute & proxy costs | ### 🔧 Technical Details #### Architecture This actor uses a **3-tier approach** for maximum reliability: 1. **Stingray JSON API** (primary) — Fastest, lightweight HTTP requests to Redfin's internal API 2. **Stingray CSV API** (fallback) — Bulk download endpoint for when JSON API is rate-limited 3. **Camoufox Browser** (last resort) — Stealth browser rendering when API endpoints are blocked #### Anti-Bot Handling - Cloudflare WAF bypass via Camoufox stealth browser - Smart rate limiting with `Retry-After` header respect - Exponential backoff with jitter (max 3 retries) - 2-4 second random delays between requests - Residential proxy rotation #### Proxy Requirements Residential proxies are **strongly recommended** for best results. Datacenter proxies may work for small batches but will be blocked quickly. ### 📋 Output Fields Reference | Field | Type | Description | |-------|------|-------------| | `propertyId` | Integer | Redfin property ID | | `listingId` | Integer | Redfin listing ID | | `address` | String | Street address | | `city` | String | City name | | `state` | String | State code | | `zipCode` | String | ZIP code | | `price` | Number | Listing/sale price | | `beds` | Number | Bedrooms | | `baths` | Number | Bathrooms | | `sqft` | Number | Interior square footage | | `lotSize` | Number | Lot size in sq ft | | `yearBuilt` | Number | Year constructed | | `propertyType` | String | Property type | | `listingStatus` | String | Active/Pending/Sold | | `daysOnMarket` | Number | Days on market | | `pricePerSqft` | Number | Price per square foot | | `hoaMonthly` | Number | Monthly HOA fee | | `mlsNumber` | String | MLS listing number | | `latitude` | Number | Property latitude | | `longitude` | Number | Property longitude | | `redfinEstimate` | Number | Redfin Estimate (AVM) | | `walkScore` | Number | Walk Score (0-100) | | `transitScore` | Number | Transit Score (0-100) | | `bikeScore` | Number | Bike Score (0-100) | | `description` | String | Property description | | `photos` | Array | Photo URLs | | `priceHistory` | Array | Price change history | | `taxHistory` | Array | Tax assessment history | | `listingAgent` | String | Listing agent name | | `listingBrokerage` | String | Brokerage name | | `url` | String | Redfin listing URL | | `scrapedAt` | String | ISO timestamp | ### 🤔 FAQ **Q: How many results can I scrape?** A: Up to 10,000 per run. For larger datasets, run multiple times with different locations. **Q: Do I need residential proxies?** A: Strongly recommended. The actor works best with Apify's residential proxy group. **Q: How fast is it?** A: In API mode (default), ~50-100 listings per minute. With detail enrichment enabled, ~10-20 per minute due to rate limiting. **Q: What's the difference between includeDetails true/false?** A: With `includeDetails: false`, you get basic search data (address, price, beds, baths, sqft). With `true`, you get 30+ fields including Redfin Estimate, walk scores, price/tax history, and photos. **Q: Can I scrape sold properties?** A: Yes! Set `listingStatus` to `sold` or use a Redfin URL with sold filters. ### 📝 Changelog - **v0.1** — Initial release with API-first architecture, 30+ data fields, and Camoufox browser fallback # Actor input Schema ## `searchUrls` (type: `array`): Redfin search URLs to scrape. Go to redfin.com, search for properties with your desired filters, and paste the URL(s) here. ## `location` (type: `string`): Search by location name (city, ZIP code, address, or neighborhood). Used only if Search URLs is empty. ## `propertyType` (type: `string`): Filter by property type. ## `listingStatus` (type: `string`): Filter by listing status. ## `minPrice` (type: `integer`): Minimum listing price in USD. ## `maxPrice` (type: `integer`): Maximum listing price in USD. ## `minBeds` (type: `integer`): Minimum number of bedrooms. ## `maxBeds` (type: `integer`): Maximum number of bedrooms. ## `minBaths` (type: `integer`): Minimum number of bathrooms. ## `maxBaths` (type: `integer`): Maximum number of bathrooms. ## `minSqft` (type: `integer`): Minimum interior square footage. ## `maxSqft` (type: `integer`): Maximum interior square footage. ## `maxResults` (type: `integer`): Maximum number of property listings to scrape. ## `includeDetails` (type: `boolean`): Fetch full property details (Redfin Estimate, walk scores, price history, tax data, photos). Slower but provides 30+ data fields per listing. ## `proxy` (type: `object`): Proxy settings. Residential proxies recommended for best results. ## Actor input object example ```json { "searchUrls": [ "https://www.redfin.com/city/29439/WA/Seattle/filter/min-price=500k,max-price=1M" ], "location": "Seattle, WA", "propertyType": "all", "listingStatus": "active", "maxResults": 100, "includeDetails": true, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `defaultDataset` (type: `string`): Property listings scraped from Redfin.com with prices, details, Redfin Estimates, walk scores, and market data. # 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 = { "searchUrls": [ "https://www.redfin.com/city/29439/WA/Seattle" ], "location": "", "maxResults": 100, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("h4sh/redfin-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 = { "searchUrls": ["https://www.redfin.com/city/29439/WA/Seattle"], "location": "", "maxResults": 100, "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("h4sh/redfin-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 '{ "searchUrls": [ "https://www.redfin.com/city/29439/WA/Seattle" ], "location": "", "maxResults": 100, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call h4sh/redfin-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=h4sh/redfin-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Redfin Scraper", "description": "Scrape Redfin for property listings with prices, Redfin Estimates, walk/transit/bike scores, price history, tax data, photos and 30+ data fields. API-first with anti-bot bypass.", "version": "0.1", "x-build-id": "Jfhc6BEz8VNIrP3MU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/h4sh~redfin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-h4sh-redfin-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~redfin-scraper/runs": { "post": { "operationId": "runs-sync-h4sh-redfin-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~redfin-scraper/run-sync": { "post": { "operationId": "run-sync-h4sh-redfin-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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Redfin search URLs to scrape. Go to redfin.com, search for properties with your desired filters, and paste the URL(s) here.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Search by location name (city, ZIP code, address, or neighborhood). Used only if Search URLs is empty." }, "propertyType": { "title": "Property Type", "enum": [ "all", "house", "condo", "townhouse", "multi-family", "land", "other" ], "type": "string", "description": "Filter by property type.", "default": "all" }, "listingStatus": { "title": "Listing Status", "enum": [ "active", "active_pending", "pending", "sold" ], "type": "string", "description": "Filter by listing status.", "default": "active" }, "minPrice": { "title": "Min Price ($)", "type": "integer", "description": "Minimum listing price in USD." }, "maxPrice": { "title": "Max Price ($)", "type": "integer", "description": "Maximum listing price in USD." }, "minBeds": { "title": "Min Bedrooms", "type": "integer", "description": "Minimum number of bedrooms." }, "maxBeds": { "title": "Max Bedrooms", "type": "integer", "description": "Maximum number of bedrooms." }, "minBaths": { "title": "Min Bathrooms", "type": "integer", "description": "Minimum number of bathrooms." }, "maxBaths": { "title": "Max Bathrooms", "type": "integer", "description": "Maximum number of bathrooms." }, "minSqft": { "title": "Min Square Feet", "type": "integer", "description": "Minimum interior square footage." }, "maxSqft": { "title": "Max Square Feet", "type": "integer", "description": "Maximum interior square footage." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of property listings to scrape.", "default": 100 }, "includeDetails": { "title": "Include Property Details", "type": "boolean", "description": "Fetch full property details (Redfin Estimate, walk scores, price history, tax data, photos). Slower but provides 30+ data fields per listing.", "default": true }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies recommended for best results." } } }, "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 } } } } } } } } } } ```