# Redfin Scraper - Home Prices, Beds & Days on Market (`goat255/redfin-scraper`) Actor Pull property listings for any area by pasting a public search URL. Each row has price, price per square foot, beds, baths, square footage, lot size, year built, listing status, days on market, HOA fee and map coordinates. Filter by price or switch to sold homes. - **URL**: https://apify.com/goat255/redfin-scraper.md - **Developed by:** [Goutam Soni](https://apify.com/goat255) (community) - **Categories:** Automation, Lead generation, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.60 / 1,000 listing scrapeds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Scraper Pull property listings for any area by pasting a public search URL. Each row comes back with price, price per square foot, size, year built, listing status, days on market and map coordinates. No login and no API key. ### What it does - **Point it at any area** - paste a public city or zip code search URL and it collects that area's listings. No opaque region codes to look up. - **The numbers buyers compare** - price, price per square foot, beds, baths, square footage, lot size, year built and HOA fee. - **Market timing** - listing status and days on market, so you can spot stale inventory and fresh listings. - **Sold comparables** - switch to recently sold homes for comparables research. - **Price filters** - set a minimum, a maximum, or both. - **Map ready** - latitude and longitude on every row. Prices and statuses change daily, so schedule the run to track a market over time. Common uses: comparables and pricing research, inventory and days on market tracking, investment screening, and building a housing dataset. ### Input | Field | Type | Description | |---|---|---| | `searchUrls` | array | Public listing URLs for the areas you want. One run per entry. | | `maxResultsPerRegion` | integer | Cap per area. Default 100, up to 350. | | `soldListings` | boolean | Return recently sold homes instead of active ones. Default false. | | `minPrice` | integer | Skip listings below this price. 0 for no minimum. | | `maxPrice` | integer | Skip listings above this price. 0 for no maximum. | | `proxyConfiguration` | object | Optional. Enable to spread requests across IPs. | #### Example input ```json { "searchUrls": [ "https://www.redfin.com/city/11203/CA/Los-Angeles", "https://www.redfin.com/city/16163/WA/Seattle" ], "maxResultsPerRegion": 200, "minPrice": 400000 } ```` ### Output Each item is one listing. ```json { "listingId": "100000001", "propertyId": "200000001", "address": "123 Example St", "city": "Los Angeles", "state": "CA", "postalCode": "90023", "price": 538000, "pricePerSqFt": 419.0, "hoaFee": null, "beds": 3, "baths": 2.0, "sqFt": 1284, "lotSizeSqFt": 6582, "yearBuilt": 1921, "status": "Active", "daysOnMarket": 12, "isNewConstruction": false, "hasVirtualTour": true, "latitude": 34.0201, "longitude": -118.1937, "photoCount": 24, "url": "https://www.redfin.com/CA/Los-Angeles/123-Example-St-90023/home/100000001" } ``` Land and lot listings have no beds, baths or square footage, so those come back as `null` while the shape stays the same. ### Notes - No login and no API key. Paste the search URLs for the areas you care about and run. - The feed returns up to 350 listings per area, so split a large market into several area URLs for fuller coverage. - Turn on `soldListings` to build a comparables set instead of active inventory. ### Privacy To improve our actors we collect anonymized usage telemetry (run stats and input patterns). No personal account data is collected. # Actor input Schema ## `searchUrls` (type: `array`): Public listing URLs for the areas you want, for example a city or zip code search page. Copy them straight from the site. One run per entry. ## `maxResultsPerRegion` (type: `integer`): Cap per area. The feed returns up to 350 listings for a single area. ## `soldListings` (type: `boolean`): Return recently sold homes instead of homes currently for sale. ## `minPrice` (type: `integer`): Skip listings below this price. Leave at 0 for no minimum. ## `maxPrice` (type: `integer`): Skip listings above this price. Leave at 0 for no maximum. ## `proxyConfiguration` (type: `object`): Optional. Enable to spread requests across IPs on large runs. ## Actor input object example ```json { "searchUrls": [ "https://www.redfin.com/city/16163/WA/Seattle" ], "maxResultsPerRegion": 100, "soldListings": false, "minPrice": 0, "maxPrice": 0, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 = { "searchUrls": [ "https://www.redfin.com/city/11203/CA/Los-Angeles" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("goat255/redfin-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchUrls": ["https://www.redfin.com/city/11203/CA/Los-Angeles"], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("goat255/redfin-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchUrls": [ "https://www.redfin.com/city/11203/CA/Los-Angeles" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call goat255/redfin-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=goat255/redfin-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Redfin Scraper - Home Prices, Beds & Days on Market", "description": "Pull property listings for any area by pasting a public search URL. Each row has price, price per square foot, beds, baths, square footage, lot size, year built, listing status, days on market, HOA fee and map coordinates. Filter by price or switch to sold homes.", "version": "0.0", "x-build-id": "7MZCyP8e1F9vwb1nP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/goat255~redfin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-goat255-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/goat255~redfin-scraper/runs": { "post": { "operationId": "runs-sync-goat255-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/goat255~redfin-scraper/run-sync": { "post": { "operationId": "run-sync-goat255-redfin-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Public listing URLs for the areas you want, for example a city or zip code search page. Copy them straight from the site. One run per entry.", "items": { "type": "string" } }, "maxResultsPerRegion": { "title": "Max listings per area", "minimum": 1, "maximum": 350, "type": "integer", "description": "Cap per area. The feed returns up to 350 listings for a single area.", "default": 100 }, "soldListings": { "title": "Sold listings", "type": "boolean", "description": "Return recently sold homes instead of homes currently for sale.", "default": false }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Skip listings below this price. Leave at 0 for no minimum.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Skip listings above this price. Leave at 0 for no maximum.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Enable to spread requests across IPs on large runs." } } }, "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 } } } } } } } } } } ```