# Redfin Scraper - Listings, Sold Comps, Estimates & Leads (`scrapesage/redfin-scraper`) Actor Scrape Redfin for-sale & sold homes for any US city, ZIP, neighborhood or county: price, beds/baths/sqft, lot, year, HOA, Redfin Estimate, rent estimate, price history, schools, climate risk, photos & listing agent/broker. New-listing & price-drop monitoring. No login, key or browser. - **URL**: https://apify.com/scrapesage/redfin-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 property 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 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 — Listings, Sold Comps, Estimates, Price History & Agent Leads Extract **complete Redfin real-estate data** for any US city, ZIP, neighborhood or county — the fields most scrapers leave empty: **the Redfin Estimate, rent estimate, full price/sale history, assigned schools with ratings, climate-risk factors, tax & public records, building permits, every photo, and the listing agent & brokerage**. Pull live **for-sale** listings or recent **sold comps**, and monitor a market for **new listings and price drops**. No login, no API key, no browser — fast JSON extraction straight from Redfin's public map/search data path. ### Why this Redfin scraper? Most Redfin scrapers return the listing grid and stop. This actor opens each home's full record and ships the **richest dataset in the category**: | Data | Typical scrapers | This actor | |---|---|---| | Price, beds, baths, sqft, lot, year, HOA, $/sqft | ✅ | ✅ | | MLS #, status, source, days on market | partial | ✅ | | **Redfin Estimate** (home value AVM) | ❌ | ✅ | | **Rent estimate** (monthly, low/high) | ❌ | ✅ | | **Full price & sale history** (with sources) | ❌ | ✅ | | **Assigned schools** + GreatSchools & parent ratings | ❌ | ✅ | | **Climate risk** (flood / fire / heat / wind) | ❌ | ✅ | | **Tax & public records** (assessed values, taxes, APN) | ❌ | ✅ | | **Building permits** | ❌ | ✅ | | **Listing agent + phone + brokerage** | ❌ | ✅ | | All photos, full description, features/amenities | partial | ✅ | | Sold comps (CMA) by recency window | partial | ✅ | | New-listing & price-drop monitoring | ❌ | ✅ | ### Use cases - **Real-estate investing & analysis** — pull active listings *and* recent sold comps (CMA) for a ZIP, compare list price to the **Redfin Estimate** and **rent estimate**, screen by $/sqft, cap-rate inputs, lot size and year built. - **Lead generation** — every active listing carries the **listing agent, phone and brokerage**. Build agent/brokerage prospect lists by market, price band, and volume. - **Market & pricing intelligence** — track median price, days-on-market, price cuts and sell-through for any city, neighborhood or ZIP over time. - **New-listing & price-drop alerts** — run in monitoring mode on a schedule to capture only homes that are new or whose price/status changed since the last run. - **Proptech & valuation models** — feed clean, structured listings, sale history, tax records and climate risk into your own models, dashboards or CRM. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **Redfin Scraper**, paste a Redfin city/ZIP/neighborhood/county URL (or just a list of ZIP codes), pick **For sale** or **Sold**, and click **Start**. 3. Watch results stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "listingType": "for_sale", "searchUrls": ["https://www.redfin.com/city/11203/CA/Los-Angeles"], "zipCodes": ["90210", "78701"], "minPrice": 500000, "maxPrice": 2000000, "minBeds": 3, "propertyTypes": ["house", "condo"], "includePropertyDetails": true, "maxResults": 200 } ```` - **listingType** — `for_sale` (active, coming-soon & pending) or `sold` (recent comparable sales). - **searchUrls** — Redfin **city / ZIP / neighborhood / county** page URLs. Browse Redfin, apply filters, copy the URL from your address bar — every home in that region is scraped. - **zipCodes** — shortcut: a list of 5-digit US ZIP codes, each resolved to its Redfin region. - **propertyUrls** — individual Redfin home URLs to scrape just those homes' full detail. - **minPrice / maxPrice / minBeds / maxBeds / minBaths / propertyTypes** — listing filters. - **soldWithinDays** *(sold only)* — 7 / 30 / 90 / 180 / 365 / 1095 days of comps. - **sort** — recommended, newest, most-recently-sold, price, sqft, lot size, $/sqft. - **includePropertyDetails** *(default true)* — open each home for the Redfin Estimate, rent estimate, price history, schools, climate risk, tax/public records, permits, photos and listing agent/brokerage (one extra page fetch per home). - **maxResults / maxResultsPerSearch** — global and per-region caps. - **monitorMode** *(default false)* — emit ONLY new or changed (price/status) listings vs. the previous run; pairs with [Schedules](https://docs.apify.com/platform/schedules). ### Output One record per property: ```json { "propertyId": 6824442, "url": "https://www.redfin.com/CA/Beverly-Hills/324-N-Palm-Dr-90210/unit-204/home/6824442", "fullAddress": "324 N Palm Dr #204, Beverly Hills, CA 90210", "price": 1395000, "beds": 3, "baths": 2, "sqFt": 1766, "pricePerSqFt": 790, "lotSizeSqFt": null, "yearBuilt": 1980, "hoaMonthly": 850, "propertyType": "Condo/Co-op", "mlsStatus": "Active", "mlsNumber": "26848017", "listingSource": "TheMLS", "saleType": "For sale", "daysOnMarket": 1, "city": "Beverly Hills", "state": "CA", "zip": "90210", "latitude": 34.0731, "longitude": -118.4004, "redfinEstimate": 1384281, "rentEstimate": 7168, "rentEstimateLow": 6900, "rentEstimateHigh": 7500, "listingAgentName": "Dustin Nicholas", "listingAgentPhone": "310-770-1847", "listingBrokerName": "Nicholas Property Group", "priceHistory": [ { "date": "2026-06-15T07:00:00.000Z", "event": "Listed", "price": 1395000, "source": "TheMLS" } ], "schools": [ { "name": "Beverly Vista", "type": "Public", "grades": "K-8", "rating": 8, "parentRating": 4, "distanceMiles": 0.6 } ], "climateRisk": { "floodFactor": 1, "fireFactor": 1, "heatFactor": 6, "windFactor": null }, "publicRecords": { "yearBuilt": 1980, "totalSqFt": 1766, "apn": "4342003095", "propertyTaxes": 14817.27, "rollYear": 2025 }, "photoCount": 35, "primaryPhoto": "https://ssl.cdn-redfin.com/photo/...", "scrapedAt": "2026-06-15T12:00:00.000Z" } ``` In monitoring mode each record also carries `changeType` (`new` / `price_drop` / `price_increase` / `status_change`) and `previousPrice`. Every record also includes `listingSource` (the MLS name, e.g. *Unlock MLS*) and `dataSourceId` — populated in **both** grid-only and full-detail runs. ### Pricing — pay per result, no start or subscription fee You pay only for the depth you use: | Event | Charged | Price | |---|---|---| | **Property scraped** | Every listing written to the dataset (grid record). | **$0.004** | | **Property detail enriched** | Once per home whose full detail page is fetched (`includePropertyDetails` on, or any `propertyUrls`). | **$0.004** | - **Grid-only** run (`includePropertyDetails: false`) → **$0.004 / home** - **Full-detail** run (default) → **$0.008 / home** (listing + enrichment) Example: 1,000 homes with full details = **$8.00**; the same 1,000 grid-only = **$4.00**. Apify platform compute & proxy usage is billed separately by Apify. ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it hourly/daily to monitor a market for new listings and price drops. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/redfin-scraper').call({ listingType: 'for_sale', zipCodes: ['78701'], minPrice: 400000, includePropertyDetails: true, monitorMode: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} Redfin properties`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new listings or agent leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored market gets new listings or price cuts. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. You can call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find 3-bed houses under $800k in Austin and list the agents" and let it run this scraper for you. ### More scrapers from scrapesage Build a complete **property & local-market intelligence stack**: - **[Rent.com Scraper](https://apify.com/scrapesage/rent-com-scraper)** — US apartment & rental listings with property-management leads. - **[Craigslist Scraper](https://apify.com/scrapesage/craigslist-scraper)** — FSBO housing, real estate & classifieds with phone/email leads. - **[Houzz Scraper](https://apify.com/scrapesage/houzz-scraper)** — home-improvement pros, contacts and reviews. - **[Hipages Scraper](https://apify.com/scrapesage/hipages-scraper)** — Australian home-services trades with phone, ABN & licence. - **[Companies House Scraper](https://apify.com/scrapesage/companies-house-scraper)** — UK companies, directors & PSCs. - **[Insurance Agent Scraper](https://apify.com/scrapesage/insurance-agent-scraper)** — multi-carrier insurance-agent leads. - **[Financial Advisor Scraper](https://apify.com/scrapesage/financial-advisor-scraper)** — FINRA & SEC adviser/firm leads. ### Tips - **Big cities**: Redfin's map API returns up to ~350 homes per region. To exhaust a large market, scrape by **ZIP or neighborhood** (smaller regions) and/or narrow with price/beds — the actor caps per region and tells you when a region is maxed out. - **Sold comps**: set `listingType: "sold"` and `soldWithinDays` for a comparable-sales (CMA) pull. The actor resolves each region's `market` automatically so sold results are accurate. - **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to track only new listings and price drops. - **Proxies**: keep the default **US residential** proxy — Redfin's CDN blocks datacenter IPs, so residential is required (and is the default). A fully blocked run **fails loudly** instead of returning an empty dataset. - **Cost control**: turn off `includePropertyDetails` for a fast, listing-grid-only run — no per-home page fetch, and you pay only the base **$0.004/home** with no enrichment fee (see **Pricing** above). ### FAQ **How do I scrape Redfin listings for a specific city or ZIP?** Paste the Redfin city/ZIP/neighborhood/county page URL into `searchUrls`, or just add the 5-digit ZIP to `zipCodes`. Combine with filters to narrow by price, beds or property type. **Can I get recently sold homes (comps)?** Yes — set `listingType` to `sold` and choose a `soldWithinDays` window (7 days to 3 years). Each comp includes sale price, sale date, beds/baths/sqft and (with details on) full sale history. **Where does the Redfin Estimate and rent estimate come from?** They are Redfin's own published on-page estimates, extracted from the home's public page — the same numbers a visitor sees. **Does it include the listing agent's contact?** Yes — for active listings the listing agent name, phone (when published) and brokerage are included. They're blank only when Redfin/the MLS doesn't publish them. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **How do I monitor new listings automatically?** Turn on `monitorMode` and create a [Schedule](https://docs.apify.com/platform/schedules). Each run emits only homes that are new or changed since the last run, tagged with `changeType`. **Is scraping Redfin legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws and Redfin's terms. **A field is null — why?** Some homes genuinely don't publish an HOA, lot size, agent phone or estimate. Fields are `null` only when the data doesn't exist, not because the scraper skipped them. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `listingType` (type: `string`): Scrape homes currently `For sale` (active, coming-soon & pending) or recently `Sold` (comparable sales for CMA / investor analysis). ## `searchUrls` (type: `array`): Paste Redfin **city, ZIP, neighborhood or county** page URLs — e.g. `https://www.redfin.com/city/11203/CA/Los-Angeles`, `https://www.redfin.com/zipcode/90210`, `https://www.redfin.com/neighborhood/9719/CA/Los-Angeles/Hollywood`. Browse Redfin, apply any filters you like, then copy the URL from your address bar. Every listing in that region is scraped. ## `zipCodes` (type: `array`): Optional shortcut — a list of 5-digit US ZIP codes (e.g. `78701`, `90210`). Each is resolved to its Redfin region and scraped. Use this instead of, or in addition to, Search URLs. ## `propertyUrls` (type: `array`): Optional. Paste individual Redfin home URLs (`https://www.redfin.com/CA/Los-Angeles/123-Main-St-90001/home/12345678`) to scrape the full detail for just those homes (price history, Redfin Estimate, schools, climate risk, agent & brokerage). ## `minPrice` (type: `integer`): Only keep homes priced at least this much (USD). Leave empty for no filter. ## `maxPrice` (type: `integer`): Only keep homes priced at most this much (USD). Leave empty for no filter. ## `minBeds` (type: `integer`): Minimum number of bedrooms. Leave empty for no filter. ## `maxBeds` (type: `integer`): Maximum number of bedrooms. Leave empty for no filter. ## `minBaths` (type: `integer`): Minimum number of bathrooms. Leave empty for no filter. ## `propertyTypes` (type: `array`): Limit to specific property types. Leave empty to include all. ## `soldWithinDays` (type: `string`): For `Sold` listing type only — how far back to pull comparable sales. ## `sort` (type: `string`): Order in which listings are pulled (also controls which appear first when capped). ## `includePropertyDetails` (type: `boolean`): Open each home's page for the rich detail layer: **Redfin Estimate, rent estimate, full price/sale history, assigned schools (with ratings), climate-risk factors, tax & public records, building permits, all photos, full description, and the listing agent & brokerage**. Turn off for a faster, listing-grid-only run (address, price, beds/baths/sqft, lot, year, status, MLS#, geo). Adds one page fetch per home. ## `maxResults` (type: `integer`): Global cap on the total number of properties emitted in this run. ## `maxResultsPerSearch` (type: `integer`): Cap per region (city/ZIP/neighborhood/county). Redfin's map API returns at most ~350 homes per region — narrow with price, beds or a smaller region (ZIP/neighborhood) for deeper coverage of large markets. ## `monitorMode` (type: `boolean`): Remember listings already returned and emit ONLY homes that are **new** or whose **price/status changed** since the last run (tagged `changeType`: new / price\_drop / price\_increase / status\_change). Perfect for new-listing alerts and price-drop tracking. Pairs with Apify Schedules. ## `monitorStoreName` (type: `string`): Named key-value store that holds the 'already seen' listings for monitoring mode. Use a different name per tracked market to keep histories separate (lowercase letters, digits and hyphens). ## `maxConcurrency` (type: `integer`): Maximum parallel requests. Keep it moderate to stay friendly to Redfin's servers. ## `proxyConfiguration` (type: `object`): Proxy settings. Redfin's CDN (CloudFront) blocks datacenter IPs and returns nothing, so **US residential proxies are required** — this is the default and should not be changed unless you supply your own US residential proxy. Datacenter proxies will produce empty runs. ## Actor input object example ```json { "listingType": "for_sale", "searchUrls": [ "https://www.redfin.com/zipcode/90210" ], "propertyTypes": [], "soldWithinDays": "90", "sort": "recommended", "includePropertyDetails": true, "maxResults": 200, "maxResultsPerSearch": 350, "monitorMode": false, "monitorStoreName": "redfin-monitor", "maxConcurrency": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): All scraped Redfin properties in the default dataset. Use the Listings / Investor / Leads dataset views to filter the columns. # 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/zipcode/90210" ] }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/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/zipcode/90210"] } # Run the Actor and wait for it to finish run = client.actor("scrapesage/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/zipcode/90210" ] }' | apify call scrapesage/redfin-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/redfin-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Redfin Scraper - Listings, Sold Comps, Estimates & Leads", "description": "Scrape Redfin for-sale & sold homes for any US city, ZIP, neighborhood or county: price, beds/baths/sqft, lot, year, HOA, Redfin Estimate, rent estimate, price history, schools, climate risk, photos & listing agent/broker. New-listing & price-drop monitoring. No login, key or browser.", "version": "0.1", "x-build-id": "MdqOgPhkXEJmmobdW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~redfin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~redfin-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-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/scrapesage~redfin-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-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": { "listingType": { "title": "Listing type", "enum": [ "for_sale", "sold" ], "type": "string", "description": "Scrape homes currently `For sale` (active, coming-soon & pending) or recently `Sold` (comparable sales for CMA / investor analysis).", "default": "for_sale" }, "searchUrls": { "title": "Search URLs (Redfin region pages)", "type": "array", "description": "Paste Redfin **city, ZIP, neighborhood or county** page URLs — e.g. `https://www.redfin.com/city/11203/CA/Los-Angeles`, `https://www.redfin.com/zipcode/90210`, `https://www.redfin.com/neighborhood/9719/CA/Los-Angeles/Hollywood`. Browse Redfin, apply any filters you like, then copy the URL from your address bar. Every listing in that region is scraped.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes", "type": "array", "description": "Optional shortcut — a list of 5-digit US ZIP codes (e.g. `78701`, `90210`). Each is resolved to its Redfin region and scraped. Use this instead of, or in addition to, Search URLs.", "items": { "type": "string" } }, "propertyUrls": { "title": "Property URLs (individual homes)", "type": "array", "description": "Optional. Paste individual Redfin home URLs (`https://www.redfin.com/CA/Los-Angeles/123-Main-St-90001/home/12345678`) to scrape the full detail for just those homes (price history, Redfin Estimate, schools, climate risk, agent & brokerage).", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only keep homes priced at least this much (USD). Leave empty for no filter." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only keep homes priced at most this much (USD). Leave empty for no filter." }, "minBeds": { "title": "Minimum bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of bedrooms. Leave empty for no filter." }, "maxBeds": { "title": "Maximum bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum number of bedrooms. Leave empty for no filter." }, "minBaths": { "title": "Minimum bathrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of bathrooms. Leave empty for no filter." }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Limit to specific property types. Leave empty to include all.", "items": { "type": "string", "enum": [ "house", "condo", "townhouse", "multi-family", "land", "manufactured", "co-op", "other" ], "enumTitles": [ "House", "Condo", "Townhouse", "Multi-family", "Land", "Manufactured", "Co-op", "Other" ] }, "default": [] }, "soldWithinDays": { "title": "Sold within (days)", "enum": [ "7", "30", "90", "180", "365", "1095" ], "type": "string", "description": "For `Sold` listing type only — how far back to pull comparable sales.", "default": "90" }, "sort": { "title": "Sort by", "enum": [ "recommended", "newest", "most-recently-sold", "price-low-high", "price-high-low", "sqft", "lot-size", "price-per-sqft" ], "type": "string", "description": "Order in which listings are pulled (also controls which appear first when capped).", "default": "recommended" }, "includePropertyDetails": { "title": "Include full property details", "type": "boolean", "description": "Open each home's page for the rich detail layer: **Redfin Estimate, rent estimate, full price/sale history, assigned schools (with ratings), climate-risk factors, tax & public records, building permits, all photos, full description, and the listing agent & brokerage**. Turn off for a faster, listing-grid-only run (address, price, beds/baths/sqft, lot, year, status, MLS#, geo). Adds one page fetch per home.", "default": true }, "maxResults": { "title": "Max properties (whole run)", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Global cap on the total number of properties emitted in this run.", "default": 200 }, "maxResultsPerSearch": { "title": "Max properties per region", "minimum": 1, "maximum": 350, "type": "integer", "description": "Cap per region (city/ZIP/neighborhood/county). Redfin's map API returns at most ~350 homes per region — narrow with price, beds or a smaller region (ZIP/neighborhood) for deeper coverage of large markets.", "default": 350 }, "monitorMode": { "title": "Monitoring mode — only new & changed", "type": "boolean", "description": "Remember listings already returned and emit ONLY homes that are **new** or whose **price/status changed** since the last run (tagged `changeType`: new / price_drop / price_increase / status_change). Perfect for new-listing alerts and price-drop tracking. Pairs with Apify Schedules.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Named key-value store that holds the 'already seen' listings for monitoring mode. Use a different name per tracked market to keep histories separate (lowercase letters, digits and hyphens).", "default": "redfin-monitor" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum parallel requests. Keep it moderate to stay friendly to Redfin's servers.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Redfin's CDN (CloudFront) blocks datacenter IPs and returns nothing, so **US residential proxies are required** — this is the default and should not be changed unless you supply your own US residential proxy. Datacenter proxies will produce empty runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } } ```