# Redfin Property Listings Scraper (`fetch_cat/redfin-property-listings-scraper`) Actor Extract public Redfin property listings by URL, ZIP, city, county, or neighborhood. - **URL**: https://apify.com/fetch\_cat/redfin-property-listings-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.60 / 1,000 item processeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Property Listings Scraper Extract public Redfin property listings from search pages, ZIP codes, and supported city/county aliases. The Actor saves structured rows for real estate research, inventory monitoring, lead workflows, and market analysis. ### Why use Redfin Property Listings Scraper? Redfin Property Listings Scraper turns public Redfin search pages into analysis-ready property listing rows. Instead of copying listing cards manually, provide search URLs or supported locations and export the resulting dataset. ### What does this Actor do? The Actor fetches Redfin search result pages, extracts public listing data, deduplicates records across targets, and saves one structured dataset row per property listing. ### Who is it for? - **Real estate investors** tracking inventory, price ranges, and target ZIP codes. - **Agents and brokerages** monitoring market supply and comparable public listings. - **Proptech and data teams** feeding listing URLs, prices, and addresses into internal workflows. - **Researchers** building repeatable snapshots for market analysis. ### What you get - **Listing records** with Redfin URL, property ID, price, beds, square footage, address, coordinates, and scrape timestamp. - **Flexible targets** using Redfin search URLs, ZIP codes, supported aliases such as Austin TX, San Francisco CA, and Travis County TX, plus listing status filters. - **Exports and automation** through Apify datasets, API, webhooks, CSV, JSON, Excel, and MCP-compatible agents. - **Run summary** in key-value store record `RUN-SUMMARY` with saved count, failed targets, and partial-run status. ### Input recipes - **Austin ZIP smoke test**: set `locations` to `["78701"]` and `maxItems` to `10`. - **San Francisco city sample**: set `locations` to `["San Francisco CA"]` and `maxItems` to `25`. - **County inventory sample**: set `startUrls` to `[{"url":"https://www.redfin.com/county/2866/TX/Travis-County"}]` and choose your result limit. - **Filtered Redfin search**: paste a public Redfin search URL in `startUrls` to preserve Redfin-side filters. ### Example input ```json { "locations": ["78701"], "maxItems": 10, "statusFilter": "for_sale", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ```` ### Example output ```json { "propertyId": "31378169", "url": "https://www.redfin.com/TX/Austin/1800-Lavaca-St-78701/unit-A-407/home/31378169", "sourceUrl": "https://www.redfin.com/zipcode/78701", "propertyType": "Residence", "price": 234000, "beds": 1, "baths": null, "sqft": 608, "street": "1800 Lavaca St Unit A-407", "city": "Austin", "state": "TX", "zip": "78701", "latitude": 30.280586, "longitude": -97.741692, "scrapedAt": "2026-07-21T09:00:00.000Z", "warnings": [] } ``` ### Input settings | Setting | JSON key | Description | | --- | --- | --- | | Redfin search URLs | `startUrls` | Public Redfin ZIP, city, county, neighborhood, or filtered search URLs. Single home detail URLs are not supported in this version. | | Locations | `locations` | ZIP codes plus supported aliases. This build includes ZIP codes, `Austin TX`, `San Francisco CA`, and `Travis County TX`; use `startUrls` for other Redfin pages. | | Maximum listings | `maxItems` | Maximum dataset rows to save across all targets. Start small to verify output and cost. | | Listing status | `statusFilter` | Choose `for_sale`, `for_rent`, `sold`, or `all`/default. Redfin may expose fewer public rental or sold records in some markets. | | Include raw source snippets | `includeRaw` | Adds selected source snippets for debugging; keep off for smaller exports. | | Proxy configuration | `proxyConfiguration` | Redfin commonly needs US residential Apify Proxy routing. | ### Output fields | Field | Description | | --- | --- | | `propertyId`, `listingId`, `mlsId` | Stable identifiers when available. | | `url`, `sourceUrl` | Listing URL and source search page URL. | | `status`, `propertyType` | Listing status/type fields when available in public page data. | | `price`, `beds`, `baths`, `sqft`, `lotSize`, `yearBuilt`, `daysOnMarket` | Property metrics. | | `street`, `city`, `state`, `zip`, `country` | Address fields. | | `latitude`, `longitude` | Coordinates when available. | | `listingRemarks`, `primaryPhotoUrl`, `photoUrls`, `brokerName`, `agentName` | Optional public listing details when exposed by Redfin search data. | | `scrapedAt`, `warnings`, `raw` | Collection timestamp, row-level warnings, and optional raw snippet. | ### Pricing | Event | Price | Charged when | | --- | --- | --- | | Run start | `$0.005` per run | Once when the Actor starts. | | Item processed | Free `$0.00115`, Bronze `$0.00100`, Silver `$0.00078`, Gold `$0.00060`, Platinum `$0.00040`, Diamond `$0.00028` per saved dataset row | Each listing saved to the dataset. | Pricing will be rechecked with cloud cost measurements before Store publication. ### Tips and limits - Start with `maxItems: 10` before running broad searches. - Use Redfin search URLs when you need filters that are not represented by simple ZIP/city/county inputs. - If a target returns no data or a block page, the Actor records the failed target in `RUN-SUMMARY`; a run with some saved listings is treated as partial success. - Only public Redfin listing/search pages are supported. Do not use this Actor for private account data or pages that require login. ### API usage Node.js: ```js import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor("fetch_cat/redfin-property-listings-scraper").call({ locations: ["78701"], maxItems: 10, }); console.log(run.defaultDatasetId); ``` Python: ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("fetch_cat/redfin-property-listings-scraper").call(run_input={ "locations": ["78701"], "maxItems": 10, }) print(run["defaultDatasetId"]) ``` cURL: ```bash curl -X POST "https://api.apify.com/v2/acts/fetch_cat~redfin-property-listings-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"locations":["78701"],"maxItems":10}' ``` ### MCP and AI agents Use this Actor from MCP-compatible tools through the Apify MCP Server: ```bash claude mcp add --transport http apify "https://mcp.apify.com?tools=fetch_cat/redfin-property-listings-scraper" ``` JSON config: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=fetch_cat/redfin-property-listings-scraper" } } } ``` Example prompts: - "Run the Redfin scraper for ZIP 78701 and return the first 10 listings as a table." - "Collect public Redfin listings from this search URL and summarize price ranges." ### Related Actors - [Realtor.com Agents Scraper](https://apify.com/fetch_cat/realtor-com-agents-scraper) - [Google Maps Lead Finder](https://apify.com/fetch_cat/google-maps-lead-finder) - [Apartments.com Rentals Scraper](https://apify.com/fetch_cat/apartments-com-rentals-scraper) ### FAQ **Can I scrape individual Redfin home detail URLs?**\ Not in this first version. Use Redfin search, ZIP, city, county, neighborhood, or filtered search URLs. **Why is a residential proxy prefilled?**\ Redfin commonly rate-limits plain datacenter traffic. Keep the default US residential proxy unless you have tested another route. **What happens if one target fails?**\ The Actor saves listings from successful targets and records failed targets in `RUN-SUMMARY`. If every target fails or returns no listings, the run fails clearly. ### Support Questions or issues? Open an Actor issue on Apify and include: - Run ID - Input JSON - Expected output - Actual output or error - Reproducible public URL # Actor input Schema ## `startUrls` (type: `array`): Redfin city, ZIP, county, neighborhood, or filtered search URLs. Single property detail URLs are not supported in this first version. ## `locations` (type: `array`): ZIP codes or supported location aliases. This build supports ZIP codes, Austin TX, San Francisco CA, and Travis County TX. Use startUrls for other Redfin pages. ## `maxItems` (type: `integer`): Maximum number of property listings to save across all targets. ## `statusFilter` (type: `string`): Redfin listing status to request. Sold and rental availability varies by market and Redfin may return fewer public records. ## `includeRaw` (type: `boolean`): Include selected source JSON-LD for debugging and traceability. Leave off for smaller datasets. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration. Redfin commonly requires US residential proxy routing. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.redfin.com/zipcode/78701" } ], "locations": [ "78701" ], "maxItems": 10, "statusFilter": "for_sale", "includeRaw": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `overview` (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/zipcode/78701" } ], "locations": [ "78701" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/redfin-property-listings-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/zipcode/78701" }], "locations": ["78701"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/redfin-property-listings-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/zipcode/78701" } ], "locations": [ "78701" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call fetch_cat/redfin-property-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/redfin-property-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Redfin Property Listings Scraper", "description": "Extract public Redfin property listings by URL, ZIP, city, county, or neighborhood.", "version": "0.1", "x-build-id": "cAs769fJyNhEGLh0T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~redfin-property-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-redfin-property-listings-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/fetch_cat~redfin-property-listings-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-redfin-property-listings-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/fetch_cat~redfin-property-listings-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-redfin-property-listings-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": [ "maxItems" ], "properties": { "startUrls": { "title": "Redfin search URLs", "type": "array", "description": "Redfin city, ZIP, county, neighborhood, or filtered search URLs. Single property detail URLs are not supported in this first version.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "locations": { "title": "Locations", "type": "array", "description": "ZIP codes or supported location aliases. This build supports ZIP codes, Austin TX, San Francisco CA, and Travis County TX. Use startUrls for other Redfin pages.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of property listings to save across all targets.", "default": 10 }, "statusFilter": { "title": "Listing status", "enum": [ "for_sale", "for_rent", "sold", "all" ], "type": "string", "description": "Redfin listing status to request. Sold and rental availability varies by market and Redfin may return fewer public records.", "default": "for_sale" }, "includeRaw": { "title": "Include raw source snippets", "type": "boolean", "description": "Include selected source JSON-LD for debugging and traceability. Leave off for smaller datasets.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Redfin commonly requires US residential proxy routing." } } }, "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 } } } } } } } } } } ```