# Redfin Real Estate Listings Scraper (`mangudai/redfin-real-estate-scraper`) Actor Scrape for-sale home listings from any Redfin city or ZIP code. Get price, beds, baths, sqft, lot size, year built, days on market, HOA, coordinates, MLS number and agent remarks. No login, no API key. Filter by price, size, type and freshness. Cheapest Redfin scraper on the store. - **URL**: https://apify.com/mangudai/redfin-real-estate-scraper.md - **Developed by:** [MangudΓ€i](https://apify.com/mangudai) (community) - **Categories:** Real estate, Developer tools, Open source - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.47 / 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/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 real estate listings scraper Pull every for-sale home Redfin shows for a city or ZIP code into a clean table. Address, price, beds, baths, square footage, lot size, year built, days on market, HOA dues, coordinates, MLS number and the agent's own listing remarks, one row per property. No login, no API key, no captcha. Point it at a Redfin URL and run. ### What it does Give it one or more Redfin regions. For each one the actor reads Redfin's public region search endpoint, the same JSON the map on redfin.com loads, and writes one dataset row per listing. Accepted region formats: - a Redfin city URL, `https://www.redfin.com/city/30818/TX/Austin` - a bare five-digit ZIP code, `78704` - a Redfin ZIP page, `https://www.redfin.com/zipcode/78704` - an explicit region pair, `6:30818` (region type, then region id), for neighborhoods, counties and anything else you already have ids for Mix as many as you like in one run. Roughly 350 listings come back per region, so cover a metro by listing its ZIP codes rather than only its city. ### Filters Everything below is optional and applied to the listings that come back: `minPrice`, `maxPrice`, `minBeds`, `maxBeds`, `minBaths`, `minSqft`, `maxSqft`, `minYearBuilt`, `maxDaysOnMarket`, `propertyTypes` (house, condo, townhouse, multi-family, land, manufactured, other), and `keyword`, which matches against the address, neighborhood, listing tags and agent remarks. Set `maxDaysOnMarket` to 7 and you get this week's new inventory. ### Output One row per listing, 37 fields: `propertyId`, `listingId`, `mlsNumber`, `mlsStatus`, `address`, `unitNumber`, `city`, `state`, `zip`, `neighborhood`, `latitude`, `longitude`, `price`, `pricePerSqft`, `beds`, `baths`, `sqft`, `lotSizeSqft`, `yearBuilt`, `propertyType`, `daysOnMarket`, `hoaMonthly`, `lastSoldDate`, `isNewConstruction`, `isHot`, `has3dTour`, `hasVirtualTour`, `hasVideoTour`, `photoCount`, `listingTags`, `keyFacts`, `description`, `url`, `searchUrl`, `regionId`, `regionType`, `scrapedAt`. Sample row: ```json { "address": "604 Rainbow Cv", "city": "West Lake Hills", "state": "TX", "zip": "78746", "neighborhood": "Rainbows End Estates Sec 02", "price": 2695000, "pricePerSqft": 760, "beds": 4, "baths": 3.5, "sqft": 3546, "yearBuilt": 1979, "propertyType": "Single Family Residential", "daysOnMarket": 3, "mlsNumber": "6704596", "mlsStatus": "Active", "latitude": 30.2819996, "longitude": -97.795715, "url": "https://www.redfin.com/TX/West-Lake-Hills/604-Rainbow-Cv-78746/home/31222544" } ```` Export to JSON, CSV, Excel or feed it straight into a sheet, a CRM or a pricing model through the Apify API. ### Uses - Comp sets and price-per-square-foot benchmarks for a neighborhood - Watching new inventory in a target market on a schedule - Investor screening: filter by price, size, year built and days on market - Feeding listing data into a valuation or lead-scoring pipeline ### Notes on reliability Redfin answers an unknown region id with a default result set from a different city rather than an error. The actor checks every region's results against the state or ZIP the URL promised and skips the region with a warning instead of writing listings from the wrong place. Requests retry with backoff on throttling, and Apify Proxy spreads them across IPs. Redfin serves roughly 350 listings per region request and applies no server-side filtering here, so filters run over that result set. For full coverage of a large metro, pass its ZIP codes as separate regions. ### Pricing Pay per event. You pay per listing returned, at a lower per-listing price than any comparable Redfin scraper on the store, plus Apify's small Actor start fee. No monthly rental. ### Legal Scrapes only public pages that need no account. Listing data belongs to Redfin and the originating MLS. Check Redfin's terms and your local rules before using the output commercially, and don't redistribute the raw listing text. # Actor input Schema ## `startUrls` (type: `array`): Redfin city URLs (for example https://www.redfin.com/city/30818/TX/Austin), bare 5-digit ZIP codes, or an explicit "regionType:regionId" pair such as 6:30818. One region per line. ## `maxItemsPerRegion` (type: `integer`): How many listings to request per region. Redfin serves up to roughly 350 per region reliably. ## `maxItems` (type: `integer`): Stop the run once this many listings have been saved. Leave at 0 for no cap. ## `propertyTypes` (type: `array`): Limit results to these property types. Leave empty for every type. ## `minPrice` (type: `integer`): Drop listings priced below this. ## `maxPrice` (type: `integer`): Drop listings priced above this. ## `minBeds` (type: `integer`): Drop listings with fewer bedrooms. ## `maxBeds` (type: `integer`): Drop listings with more bedrooms. ## `minBaths` (type: `integer`): Drop listings with fewer bathrooms. ## `minSqft` (type: `integer`): Drop listings smaller than this. ## `maxSqft` (type: `integer`): Drop listings larger than this. ## `minYearBuilt` (type: `integer`): Drop listings built before this year. ## `maxDaysOnMarket` (type: `integer`): Keep only fresh listings, for example 7 for the past week. ## `keyword` (type: `string`): Keep only listings whose address, neighborhood, tags or agent remarks contain this text, for example "pool". ## `includeDescription` (type: `boolean`): Add the full listing description written by the agent. Turn off for smaller rows. ## `proxyConfiguration` (type: `object`): Apify Proxy keeps requests spread across IPs. Recommended. ## Actor input object example ```json { "startUrls": [ "https://www.redfin.com/city/30818/TX/Austin", "https://www.redfin.com/city/17151/CA/San-Francisco" ], "maxItemsPerRegion": 350, "maxItems": 0, "propertyTypes": [], "includeDescription": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `listings` (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": [ "https://www.redfin.com/city/30818/TX/Austin", "https://www.redfin.com/city/17151/CA/San-Francisco" ] }; // Run the Actor and wait for it to finish const run = await client.actor("mangudai/redfin-real-estate-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": [ "https://www.redfin.com/city/30818/TX/Austin", "https://www.redfin.com/city/17151/CA/San-Francisco", ] } # Run the Actor and wait for it to finish run = client.actor("mangudai/redfin-real-estate-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": [ "https://www.redfin.com/city/30818/TX/Austin", "https://www.redfin.com/city/17151/CA/San-Francisco" ] }' | apify call mangudai/redfin-real-estate-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mangudai/redfin-real-estate-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Redfin Real Estate Listings Scraper", "description": "Scrape for-sale home listings from any Redfin city or ZIP code. Get price, beds, baths, sqft, lot size, year built, days on market, HOA, coordinates, MLS number and agent remarks. No login, no API key. Filter by price, size, type and freshness. Cheapest Redfin scraper on the store.", "version": "0.0", "x-build-id": "0bDN92beA38M4TM4M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mangudai~redfin-real-estate-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mangudai-redfin-real-estate-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/mangudai~redfin-real-estate-scraper/runs": { "post": { "operationId": "runs-sync-mangudai-redfin-real-estate-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/mangudai~redfin-real-estate-scraper/run-sync": { "post": { "operationId": "run-sync-mangudai-redfin-real-estate-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": { "startUrls": { "title": "Redfin regions", "type": "array", "description": "Redfin city URLs (for example https://www.redfin.com/city/30818/TX/Austin), bare 5-digit ZIP codes, or an explicit \"regionType:regionId\" pair such as 6:30818. One region per line.", "default": [ "https://www.redfin.com/city/30818/TX/Austin", "https://www.redfin.com/city/17151/CA/San-Francisco" ], "items": { "type": "string" } }, "maxItemsPerRegion": { "title": "Max listings per region", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many listings to request per region. Redfin serves up to roughly 350 per region reliably.", "default": 350 }, "maxItems": { "title": "Max listings in total", "minimum": 0, "type": "integer", "description": "Stop the run once this many listings have been saved. Leave at 0 for no cap.", "default": 0 }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Limit results to these property types. Leave empty for every type.", "items": { "type": "string", "enum": [ "house", "condo", "townhouse", "multi-family", "land", "manufactured", "other" ], "enumTitles": [ "House", "Condo / Co-op", "Townhouse", "Multi-family", "Land", "Manufactured", "Other" ] }, "default": [] }, "minPrice": { "title": "Min price (USD)", "type": "integer", "description": "Drop listings priced below this." }, "maxPrice": { "title": "Max price (USD)", "type": "integer", "description": "Drop listings priced above this." }, "minBeds": { "title": "Min bedrooms", "type": "integer", "description": "Drop listings with fewer bedrooms." }, "maxBeds": { "title": "Max bedrooms", "type": "integer", "description": "Drop listings with more bedrooms." }, "minBaths": { "title": "Min bathrooms", "type": "integer", "description": "Drop listings with fewer bathrooms." }, "minSqft": { "title": "Min interior sqft", "type": "integer", "description": "Drop listings smaller than this." }, "maxSqft": { "title": "Max interior sqft", "type": "integer", "description": "Drop listings larger than this." }, "minYearBuilt": { "title": "Min year built", "type": "integer", "description": "Drop listings built before this year." }, "maxDaysOnMarket": { "title": "Max days on market", "type": "integer", "description": "Keep only fresh listings, for example 7 for the past week." }, "keyword": { "title": "Keyword", "type": "string", "description": "Keep only listings whose address, neighborhood, tags or agent remarks contain this text, for example \"pool\"." }, "includeDescription": { "title": "Include agent remarks", "type": "boolean", "description": "Add the full listing description written by the agent. Turn off for smaller rows.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy keeps requests spread across IPs. Recommended.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```