# Redfin Real Estate Scraper (`alwaysprimedev/redfin-scraper`) Actor Scrape Redfin listings (for-sale, sold, active) by city, ZIP, county, or neighborhood URL. Returns structured JSON with price, beds, baths, sqft, address, photos, listing agent, open-house info, MLS ID, and more. - **URL**: https://apify.com/alwaysprimedev/redfin-scraper.md - **Developed by:** [Always Prime](https://apify.com/alwaysprimedev) (community) - **Categories:** Automation, Lead generation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.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 ## 🏠 Redfin Real Estate Scraper ⚡️ **Structured Redfin data in seconds.** Paste a city, ZIP, county, or neighborhood URL — get every active, pending, sold, or coming-soon listing in clean JSON / CSV / Excel. ![Apify](https://img.shields.io/badge/run%20on-Apify-00C2FF?logo=apify) ![Python](https://img.shields.io/badge/python-3.11-blue) ![Output](https://img.shields.io/badge/output-JSON%20%7C%20CSV%20%7C%20XLSX-green) --- ### 🚀 Why this scraper - 🔥 **Fast** — one search returns up to 350 listings per region (≈1 second / region) - 🎯 **Complete** — 40+ fields per listing including photos, agent, open-house, MLS # - 📦 **Drop-in formats** — JSON, CSV, and Excel exports, ready for spreadsheets, BI tools, or your data warehouse - 🤖 **Set & forget** — schedule daily runs with the built-in incremental mode - 💰 **Best-in-class economics** — pay only for what you get (per-result pricing) --- ### ⚡️ Quick start 1. Click **Try for free** 2. Paste a Redfin region URL (e.g. `https://www.redfin.com/city/16163/WA/Seattle`) — or several 3. Pick your filters (price range, bedrooms, property types) — or leave defaults 4. Hit **Start** ▶︎ — your dataset is ready in seconds. Download in JSON, CSV, or Excel > 💡 **Tip:** the URL is the only required input. Open Redfin in your browser, narrow down to the area you want, and copy the URL from the address bar. --- ### 📥 Input | Field | Type | Default | Description | |---|---|---|---| | `startUrls` | URL list | — (required) | Redfin region URLs. Supported: `/city/...`, `/zipcode/...`, `/county/...`, `/neighborhood/...` | | `searchType` | `for-sale` / `sold` / `active` | `for-sale` | Which listing states to include | | `maxItems` | integer | `50` | Hard cap. `0` = unlimited (up to ~2700 / region) | | `maxItemsPerRegion` | integer | `0` | Per-region cap when scraping many regions | | `minPrice`, `maxPrice` | integer | — | Price filter, USD | | `minBeds`, `maxBeds` | integer | — | Bedroom filter | | `propertyTypes` | multi-select | all | House / Condo / Townhouse / Multi-family / Land / Co-op / Mobile / Other | | `scrapeDetails` | boolean | `false` | Adds Redfin Estimate and zoned schools per listing (2 extra calls each) | | `since` | datetime | — | Incremental mode — skip listings older than this | | `concurrency` | integer | `5` | Parallel calls during detail enrichment | --- ### 📤 Output Every record is flat and ready for analysis. Example for one Seattle home: ```json { "url": "https://www.redfin.com/WA/Seattle/6716-37th-Ave-SW-98126/home/469984", "propertyId": 469984, "listingId": 215355410, "mlsId": "2524252", "mlsStatus": "Active", "price": 1650000, "pricePerSqFt": 445, "hoaMonthly": null, "beds": 5, "baths": 3.0, "fullBaths": 3, "sqFt": 3710, "lotSize": 7568, "yearBuilt": 1929, "stories": 2.0, "propertyType": 6, "streetLine": "6716 37th Ave SW", "unit": null, "city": "Seattle", "state": "WA", "zip": "98126", "latitude": 47.5424364, "longitude": -122.3788176, "location": "Gatewood", "listingRemarks": "Perched on Gatewood Hill with sweeping Sound, mountain, and city views...", "numPictures": 40, "photos": [ "https://ssl.cdn-redfin.com/photo/1/bigphoto/469/1231469_2.jpg", "https://ssl.cdn-redfin.com/photo/1/bigphoto/469/1231469_3.jpg" ], "scanUrl": "https://my.matterport.com/show/?m=qJzGTLtetBc", "listingAgent": { "name": "Julie Granahan", "license": 9842 }, "listingBroker": "Redfin", "openHouseStart": "2026-05-15T23:00:00+00:00", "openHouseEnd": "2026-05-16T01:00:00+00:00", "openHouseEventName": "Open House - 4:00 - 6:00 PM", "daysOnRedfin": 1, "isNewConstruction": false, "isHot": false, "has3DTour": true, "hasVirtualTour": true, "listingTags": ["VAULTED CEILINGS", "GATEWOOD HILL", "SUNSET VIEWS"], "keyFacts": ["Craft studio", "Private laundry", "Soaking tub"], "sashes": ["NEW 1 HR AGO", "OPEN SUN, 4PM"], "scrapedAt": "2026-05-15T14:41:59+00:00" } ```` When `scrapeDetails = true`, each record additionally includes `redfinEstimate` and `schools[]`. *** ### 💼 Who uses this | Use case | Why this scraper | |---|---| | 🏘️ **Real estate investors** | Comp pulls, deal screening, lead lists keyed by ZIP or neighborhood | | 🤝 **Agents & brokers** | Track competitors' listings, monitor new-on-market in your farm area | | 🏗️ **PropTech / iBuyers** | Build internal MLS-like feeds for valuation, recommendation engines | | 📊 **Analysts & researchers** | Housing-market datasets — pricing trends, days-on-market, inventory | | 🤖 **ML / data science teams** | Training data with rich descriptions, photos, and labeled outcomes | | 📈 **Hedge funds / REITs** | Regional inventory and price signals for real-estate-linked strategies | *** ### 🛠 Tips & tricks - **Many regions** → put them all in `startUrls` and set a `maxItemsPerRegion` so one big region doesn't eat your budget - **Daily refresh** → set `since` to yesterday's timestamp; only newer listings count against your bill - **Get the Redfin Estimate** → toggle on `scrapeDetails` (note: adds 2 API calls per listing) - **CSV in Excel** → use the Excel link directly from the run page — no copy-paste needed - **Schedule it** → Apify schedules let you re-run this nightly and webhook the results *** ### ❓ FAQ **Does it cover the whole US?** Yes — any Redfin URL in the US. **Sold listings?** Yes — set `searchType` to `sold`. Includes price, sold date, and the listing snapshot. **How fresh is the data?** Live, from Redfin's own data layer. Same data their map view shows. **What's the per-region cap?** Redfin returns up to ~2,700 listings per region. For larger pulls, split by ZIP / neighborhood / price range. **Rentals?** Coming in v2. **Can I get tax / sales history?** Not in this scraper — only listing-level data. Schools and Redfin Estimate are available via `scrapeDetails`. *** ### 📝 License & terms Use the scraped data in accordance with Redfin's [Terms of Use](https://www.redfin.com/about/terms-of-use). For high-volume / commercial deployments, evaluate licensing options through Redfin's data partnerships. # Actor input Schema ## `startUrls` (type: `array`): Paste one or more Redfin region URLs. Supported shapes: /city/{id}/{ST}/{slug}, /zipcode/{zip}, /county/{id}/{ST}/{slug}, /neighborhood/{id}/{ST}/{city}/{slug}. ## `searchType` (type: `string`): Which listing states to include. 'for-sale' covers active, coming-soon, contingent, and pending. 'sold' returns recently closed sales. 'active' is active-only. ## `maxItems` (type: `integer`): Hard cap on number of listings to return. Set 0 for unlimited (up to ~2700 per region, Redfin-imposed). ## `maxItemsPerRegion` (type: `integer`): Per-region cap when scraping multiple regions. 0 means no per-region cap (global maxItems still applies). ## `minPrice` (type: `integer`): Lower price bound. Leave empty to disable. ## `maxPrice` (type: `integer`): Upper price bound. Leave empty to disable. ## `minBeds` (type: `integer`): Lowest acceptable bedroom count. Leave empty to disable. ## `maxBeds` (type: `integer`): Highest acceptable bedroom count. Leave empty to disable. ## `propertyTypes` (type: `array`): Restrict to certain property types. Leave empty to include all. ## `scrapeDetails` (type: `boolean`): Fetch the Redfin Estimate (AVM) and zoned schools for each listing. Adds two API calls per listing — slower and slightly more expensive. ## `since` (type: `string`): ISO timestamp. When set, listings with soldDate older than this are skipped, useful for daily refresh runs. ## `concurrency` (type: `integer`): Parallel API requests during detail enrichment. Higher values are faster but risk rate-limiting. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.redfin.com/city/16163/WA/Seattle" } ], "searchType": "for-sale", "maxItems": 50, "propertyTypes": [], "scrapeDetails": false, "concurrency": 5 } ``` # Actor output Schema ## `listings` (type: `string`): No description ## `listingsCsv` (type: `string`): No description ## `listingsXlsx` (type: `string`): No description ## `consoleView` (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 = { "startUrls": [ { "url": "https://www.redfin.com/city/16163/WA/Seattle" } ], "maxItems": 50, "maxItemsPerRegion": 0, "minPrice": 0, "maxPrice": 0, "minBeds": 0, "maxBeds": 0, "propertyTypes": [], "since": "", "concurrency": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("alwaysprimedev/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 = { "startUrls": [{ "url": "https://www.redfin.com/city/16163/WA/Seattle" }], "maxItems": 50, "maxItemsPerRegion": 0, "minPrice": 0, "maxPrice": 0, "minBeds": 0, "maxBeds": 0, "propertyTypes": [], "since": "", "concurrency": 5, } # Run the Actor and wait for it to finish run = client.actor("alwaysprimedev/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 '{ "startUrls": [ { "url": "https://www.redfin.com/city/16163/WA/Seattle" } ], "maxItems": 50, "maxItemsPerRegion": 0, "minPrice": 0, "maxPrice": 0, "minBeds": 0, "maxBeds": 0, "propertyTypes": [], "since": "", "concurrency": 5 }' | apify call alwaysprimedev/redfin-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=alwaysprimedev/redfin-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Redfin Real Estate Scraper", "description": "Scrape Redfin listings (for-sale, sold, active) by city, ZIP, county, or neighborhood URL. Returns structured JSON with price, beds, baths, sqft, address, photos, listing agent, open-house info, MLS ID, and more.", "version": "0.1", "x-build-id": "Zb08w8FxdpG6Dbl6p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alwaysprimedev~redfin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alwaysprimedev-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/alwaysprimedev~redfin-scraper/runs": { "post": { "operationId": "runs-sync-alwaysprimedev-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/alwaysprimedev~redfin-scraper/run-sync": { "post": { "operationId": "run-sync-alwaysprimedev-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Redfin region URLs", "type": "array", "description": "Paste one or more Redfin region URLs. Supported shapes: /city/{id}/{ST}/{slug}, /zipcode/{zip}, /county/{id}/{ST}/{slug}, /neighborhood/{id}/{ST}/{city}/{slug}.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchType": { "title": "Listing type", "enum": [ "for-sale", "sold", "active" ], "type": "string", "description": "Which listing states to include. 'for-sale' covers active, coming-soon, contingent, and pending. 'sold' returns recently closed sales. 'active' is active-only.", "default": "for-sale" }, "maxItems": { "title": "Maximum results", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Hard cap on number of listings to return. Set 0 for unlimited (up to ~2700 per region, Redfin-imposed)." }, "maxItemsPerRegion": { "title": "Maximum results per region", "minimum": 0, "type": "integer", "description": "Per-region cap when scraping multiple regions. 0 means no per-region cap (global maxItems still applies)." }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Lower price bound. Leave empty to disable." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Upper price bound. Leave empty to disable." }, "minBeds": { "title": "Minimum bedrooms", "minimum": 0, "type": "integer", "description": "Lowest acceptable bedroom count. Leave empty to disable." }, "maxBeds": { "title": "Maximum bedrooms", "minimum": 0, "type": "integer", "description": "Highest acceptable bedroom count. Leave empty to disable." }, "propertyTypes": { "title": "Property types", "uniqueItems": true, "type": "array", "description": "Restrict to certain property types. Leave empty to include all.", "items": { "type": "string", "enum": [ "House", "Condo", "Townhouse", "Multi-family", "Land", "Other", "Co-op", "Mobile" ] } }, "scrapeDetails": { "title": "Enrich with Redfin Estimate and schools", "type": "boolean", "description": "Fetch the Redfin Estimate (AVM) and zoned schools for each listing. Adds two API calls per listing — slower and slightly more expensive.", "default": false }, "since": { "title": "Incremental: only listings updated/sold after", "type": "string", "description": "ISO timestamp. When set, listings with soldDate older than this are skipped, useful for daily refresh runs." }, "concurrency": { "title": "Concurrent requests", "minimum": 1, "maximum": 25, "type": "integer", "description": "Parallel API requests during detail enrichment. Higher values are faster but risk rate-limiting." } } }, "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 } } } } } } } } } } ```