# Redfin Property Listings Scraper (`scrapeworks/redfin-property-scraper`) Actor Scrape Redfin listings in bulk from any Redfin search URL: for-sale, sold and rental homes. Get price, beds, baths, sqft, lot, year built, address, geo, HOA, days on market, status and more. Paginates deep past Redfin's 350-per-search cap. - **URL**: https://apify.com/scrapeworks/redfin-property-scraper.md - **Developed by:** [Nicolas van Arkens](https://apify.com/scrapeworks) (community) - **Categories:** Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 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/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 Scrape **Redfin** real-estate listings in bulk from any Redfin search page — **for‑sale homes, recently sold homes, and rentals**. Paste one or more Redfin search URLs and get a clean, structured row for every listing: price, beds, baths, square footage, lot size, year built, full address, GPS coordinates, HOA, days on market, sold date, status, feature tags and the listing description. No login, no API key, no browser automation. The scraper paginates **deep** past Redfin's 350‑results‑per‑search limit automatically, so a single busy city URL can return **thousands** of listings. --- ### What you can do with it - Build a **comps / valuation** dataset for a market (active + recently sold, with price/sqft and sold dates). - Feed a **lead list** for agents, investors, iBuyers, lenders and home‑service businesses (new listings, price drops, high days‑on‑market). - Track **inventory and pricing trends** across cities, ZIPs or neighborhoods over time. - Power a **property search / map app** or an internal real‑estate dashboard. - Enrich a CRM with fresh listing data by ZIP or neighborhood. --- ### Input Give the actor a **list of Redfin search URLs**. Open [redfin.com](https://www.redfin.com), search for a city, ZIP code or neighborhood, apply any filters you like (for‑sale, sold, price, beds, property type…), then copy the page URL from your browser and paste it in. | Field | Type | Description | |---|---|---| | `searchUrls` | array of strings | Redfin search‑result page URLs. One row per listing is returned for each. **Required.** | | `maxResultsPerSearch` | integer | Max listings per URL (default `1000`). Set ≤ 350 for one fast request per URL. | | `maxResults` | integer | Optional overall cap across **all** URLs combined. | | `enablePriceSlicing` | boolean | Deep pagination past Redfin's 350 cap via automatic price bands (default `true`). | | `priceMin` / `priceMax` | integer | Optional global price filter (USD; monthly rent for rentals). Overrides any price already in the URL. | | `proxyConfiguration` | object | Residential proxy (required — Redfin blocks datacenter IPs). Default: Apify Proxy `RESIDENTIAL`, `US`. | #### Example input ```json { "searchUrls": [ "https://www.redfin.com/city/30818/TX/Austin", "https://www.redfin.com/zipcode/78701", "https://www.redfin.com/city/30818/TX/Austin/filter/include=sold-3mo" ], "maxResultsPerSearch": 1000, "enablePriceSlicing": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ```` **Where do the URLs come from?** Anything you can search on Redfin works: - City: `https://www.redfin.com/city/30818/TX/Austin` - ZIP code: `https://www.redfin.com/zipcode/78701` - Recently sold: add `/filter/include=sold-3mo` (or `sold-1wk`, `sold-1mo`, `sold-6mo`, `sold-1yr`) - Filtered: `.../filter/property-type=house,min-price=400k,max-price=800k,min-beds=3` *** ### Output Every listing becomes one flat row. Sample (a for‑sale home in Denver, CO): ```json { "propertyId": 41326377, "listingId": 191234567, "mlsNumber": "9432187", "status": "Active", "url": "https://www.redfin.com/CO/Denver/1309-S-Humboldt-St-80210/home/41326377", "price": 1475000, "pricePerSqFt": 512, "hoaMonthly": null, "soldDate": null, "beds": 4, "baths": 3.0, "fullBaths": 3, "sqft": 2880, "lotSize": 6250, "stories": 2.0, "yearBuilt": 1925, "propertyType": "Single-family home", "uiPropertyTypeCode": 1, "streetAddress": "1309 S Humboldt St", "unitNumber": null, "city": "Denver", "state": "CO", "zip": "80210", "neighborhood": "Washington Park", "countryCode": "US", "latitude": 39.6975, "longitude": -104.9678, "daysOnMarket": 6, "timeOnRedfinDays": 6.1, "isNewConstruction": false, "isHot": true, "hasVirtualTour": true, "hasVideoTour": false, "has3DTour": true, "photoCount": 40, "statusBadges": ["New", "Hot Home"], "listingTags": ["UPDATED KITCHEN", "FINISHED BASEMENT"], "keyFacts": ["Washington Park location", "Detached 2-car garage"], "description": "Beautifully updated home just steps from Washington Park...", "dataSourceId": 4, "marketId": 8, "searchUrl": "https://www.redfin.com/city/5155/CO/Denver", "resultPosition": 1, "scrapedAt": "2026-07-19T00:00:00+00:00" } ``` #### Output fields | Field | Description | |---|---| | `propertyId`, `listingId`, `mlsNumber` | Redfin property id, listing id and MLS number. | | `status` | MLS status string (e.g. `Active`, `Pending`, `Closed`). | | `url` | Full Redfin listing page URL. | | `price` | List price (for‑sale), sale price (sold) or monthly rent (rentals). | | `pricePerSqFt`, `hoaMonthly` | Price per sq ft and monthly HOA dues. | | `soldDate` | Sale date (sold listings) or last sale date (active listings), `YYYY-MM-DD`. | | `beds`, `baths`, `fullBaths` | Bedroom and bathroom counts. | | `sqft`, `lotSize`, `stories`, `yearBuilt` | Interior sq ft, lot sq ft, stories, year built. | | `propertyType` / `uiPropertyTypeCode` | Human label + Redfin numeric type code. | | `streetAddress`, `unitNumber`, `city`, `state`, `zip`, `neighborhood`, `countryCode` | Address parts. | | `latitude`, `longitude` | GPS coordinates. | | `daysOnMarket`, `timeOnRedfinDays` | Days on market and days on Redfin. | | `isNewConstruction`, `isHot`, `hasVirtualTour`, `hasVideoTour`, `has3DTour` | Listing flags. | | `photoCount` | Number of photos on the listing. | | `statusBadges`, `listingTags`, `keyFacts` | Redfin badges (New, Price Drop, Open House…), feature tags, and highlighted facts. | | `description` | The public listing remarks. | | `dataSourceId`, `marketId` | Redfin source / market identifiers. | | `searchUrl`, `resultPosition`, `scrapedAt` | Which input URL it came from, its position, and the scrape timestamp (UTC). | *** ### How deep pagination works Redfin returns at most **350 results** for a single search. When a search has more than that and `enablePriceSlicing` is on, the actor automatically re‑runs the search across narrowing **price bands** (`min-price` / `max-price`) and merges the results, de‑duplicated by property id. That's how one city URL can yield thousands of listings. Set `maxResultsPerSearch` to control how deep it goes; set it to 350 or turn slicing off for a single fast request per URL. *** ### Notes & FAQ **Do I need proxies?** Yes. Redfin blocks datacenter IP addresses, so the actor runs on **residential** proxies (the default). Keep the default proxy configuration. **Does it work for rentals?** Yes — paste a Redfin rentals search URL. The `price` field is the monthly rent. **How do I get sold homes?** Add `/filter/include=sold-3mo` (or another window) to the URL, or use a Redfin "Sold" search and copy that URL. **Why is `soldDate` filled on active listings?** For an active home it reflects the last time the home sold, which is useful history. On a "sold" search it is the current sale date. **Is this legal?** The actor reads the same publicly available listing data your browser loads on Redfin's search pages. You are responsible for complying with Redfin's terms and applicable laws. It does not access anything behind a login. **Pricing.** Pay‑per‑result: you are charged once per listing returned. Blocked or empty pages are never charged. # Actor input Schema ## `searchUrls` (type: `array`): A list of Redfin search-result page URLs to scrape. Open Redfin.com, search a city / ZIP / neighborhood (and apply any filters you want, e.g. for-sale, sold, price, beds, property type), then copy the page URL from your browser and paste it here. Examples: https://www.redfin.com/city/30818/TX/Austin , https://www.redfin.com/zipcode/78701 , https://www.redfin.com/city/30818/TX/Austin/filter/include=sold-3mo . Every URL is paginated deep automatically. Add as many as you like - each returns up to 'Max results per search' listings. ## `maxResultsPerSearch` (type: `integer`): The maximum number of listings to return for each URL. Redfin caps a single search at 350 results; to go beyond that this actor automatically splits the search into price bands (see 'Enable deep pagination'). Set to 350 or less for one fast request per URL. ## `maxResults` (type: `integer`): An optional hard cap on the total number of listings across ALL URLs combined. Leave empty for no overall cap (each URL is still limited by 'Max results per search'). ## `enablePriceSlicing` (type: `boolean`): When on, searches that hit Redfin's 350-result cap are automatically re-run across narrower price bands and merged (de-duplicated by property), so a single busy city URL can return thousands of listings. Turn off for a single, faster request per URL (max 350 each). ## `priceMin` (type: `integer`): Only return listings at or above this price (US dollars; for rentals this is monthly rent). Applies to every URL and overrides any min price already in the URL. Leave empty for no minimum. ## `priceMax` (type: `integer`): Only return listings at or below this price (US dollars; for rentals this is monthly rent). Applies to every URL and overrides any max price already in the URL. Leave empty for no maximum. ## `proxyConfiguration` (type: `object`): Redfin blocks datacenter IP addresses, so residential proxies are required. Keep the default (Apify Proxy, RESIDENTIAL, US) unless you know what you are doing. ## Actor input object example ```json { "searchUrls": [ "https://www.redfin.com/city/30818/TX/Austin", "https://www.redfin.com/zipcode/78701" ], "maxResultsPerSearch": 1000, "enablePriceSlicing": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # 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/30818/TX/Austin", "https://www.redfin.com/zipcode/78701" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeworks/redfin-property-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/30818/TX/Austin", "https://www.redfin.com/zipcode/78701", ], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("scrapeworks/redfin-property-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/30818/TX/Austin", "https://www.redfin.com/zipcode/78701" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call scrapeworks/redfin-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeworks/redfin-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Redfin Property Listings Scraper", "description": "Scrape Redfin listings in bulk from any Redfin search URL: for-sale, sold and rental homes. Get price, beds, baths, sqft, lot, year built, address, geo, HOA, days on market, status and more. Paginates deep past Redfin's 350-per-search cap.", "version": "0.1", "x-build-id": "6MeaOBfXhIKLD25da" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeworks~redfin-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeworks-redfin-property-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/scrapeworks~redfin-property-scraper/runs": { "post": { "operationId": "runs-sync-scrapeworks-redfin-property-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/scrapeworks~redfin-property-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeworks-redfin-property-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": [ "searchUrls" ], "properties": { "searchUrls": { "title": "Redfin search URLs", "type": "array", "description": "A list of Redfin search-result page URLs to scrape. Open Redfin.com, search a city / ZIP / neighborhood (and apply any filters you want, e.g. for-sale, sold, price, beds, property type), then copy the page URL from your browser and paste it here. Examples: https://www.redfin.com/city/30818/TX/Austin , https://www.redfin.com/zipcode/78701 , https://www.redfin.com/city/30818/TX/Austin/filter/include=sold-3mo . Every URL is paginated deep automatically. Add as many as you like - each returns up to 'Max results per search' listings.", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 1, "type": "integer", "description": "The maximum number of listings to return for each URL. Redfin caps a single search at 350 results; to go beyond that this actor automatically splits the search into price bands (see 'Enable deep pagination'). Set to 350 or less for one fast request per URL.", "default": 1000 }, "maxResults": { "title": "Max results (overall cap, optional)", "type": "integer", "description": "An optional hard cap on the total number of listings across ALL URLs combined. Leave empty for no overall cap (each URL is still limited by 'Max results per search')." }, "enablePriceSlicing": { "title": "Enable deep pagination (price-band slicing)", "type": "boolean", "description": "When on, searches that hit Redfin's 350-result cap are automatically re-run across narrower price bands and merged (de-duplicated by property), so a single busy city URL can return thousands of listings. Turn off for a single, faster request per URL (max 350 each).", "default": true }, "priceMin": { "title": "Minimum price (optional)", "type": "integer", "description": "Only return listings at or above this price (US dollars; for rentals this is monthly rent). Applies to every URL and overrides any min price already in the URL. Leave empty for no minimum." }, "priceMax": { "title": "Maximum price (optional)", "type": "integer", "description": "Only return listings at or below this price (US dollars; for rentals this is monthly rent). Applies to every URL and overrides any max price already in the URL. Leave empty for no maximum." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Redfin blocks datacenter IP addresses, so residential proxies are required. Keep the default (Apify Proxy, RESIDENTIAL, US) unless you know what you are doing.", "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 } } } } } } } } } } ```