# 🏡 Redfin Scraper — For Sale & Sold · $2/1k (`themineworks/redfin-scraper`) Actor

Scrape Redfin for-sale and recently-sold listings by city or zip: price, beds, baths, sqft, price/sqft, agent, MLS, coordinates and photos. No login, no API key. Use as an MCP server in Claude & AI agents.

- **URL**: https://apify.com/themineworks/redfin-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Real estate, MCP servers, Lead generation
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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 — For Sale & Sold Property Data

### What is the Redfin Scraper?

The **Redfin Scraper** extracts real estate listings from [Redfin.com](https://www.redfin.com) by city, ZIP code, or Redfin URL — returning clean, structured JSON for every for-sale and recently-sold property, with **no login and no API key**. Point it at a location and get back price, beds, baths, square footage, price per sqft, listing agent, broker, MLS ID, coordinates, and the listing URL for hundreds of homes in a single run.

Built lean and HTTP-only, it runs on Apify residential proxies and bills **pay-per-result** — the first 25 properties are free (lifetime), then just **$2 per 1,000 results** ($0.002 each).

### Why scrape Redfin?

- 📈 **Track the market** — monitor prices, inventory, and days-on-market by city or ZIP.
- 🎯 **Build lead lists** — pull listing agents and brokers for agent outreach and CRM enrichment.
- 🏦 **Source investment deals** — filter by price, beds, and property type to find candidates.
- 📊 **Run comps & CMAs** — combine for-sale and recently-sold data for accurate valuations.
- 🤖 **Feed AI & data products** — deliver fresh, structured housing data straight into your pipeline.

### Go beyond the limits of the official Redfin API

Redfin does not offer a public listings API, and its Data Center exports are aggregated market metrics — not individual listings. That leaves scraping as the only way to get property-level data at scale. This actor talks directly to Redfin's own listing endpoints over plain HTTP, resolving any free-text location to a search region automatically, so you are not capped by the row limits, rate limits, or coverage gaps of a third-party data feed. You control the location, the filters, and the volume. No API key, no account, no unblocker subscription.

### What data does the Redfin Scraper extract?

| | |
|---|---|
| 🏠 Full street address | 💰 List or sold price |
| 🏙️ City, state, ZIP | 📐 Price per sqft |
| 🛏️ Bedrooms | 🛁 Bathrooms |
| 📏 Interior sqft | 🌳 Lot size |
| 🏗️ Year built | 🏡 Property type |
| 📋 MLS ID | 🔖 MLS status |
| ⏳ Days on market | 📅 Sold date |
| 📍 Latitude & longitude | 💵 Monthly HOA fee |
| 👤 Listing agent name | 🏢 Listing broker name |
| 🆕 New-construction flag | 📷 Primary photo URL |
| 🔗 Redfin listing URL | 🆔 Redfin property ID |

### How to scrape Redfin in 5 steps

1. Create a free [Apify account](https://console.apify.com/sign-up).
2. Open the **Redfin Scraper** and enter a **location** (e.g. `Austin, TX`, `90210`) — or paste a Redfin city URL.
3. Optionally set `maxItems`, `soldWithinDays`, `minPrice`, `maxPrice`, or `minBeds`.
4. Click **Start** and let the actor page through results.
5. Download your data as **JSON, CSV, or Excel**, or pull it via the Apify API.

### Example input

```json
{
  "location": "Austin, TX",
  "maxItems": 100,
  "minPrice": 400000,
  "maxPrice": 900000,
  "minBeds": 3,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}
````

To scrape recently-sold homes instead, add `"soldWithinDays": 30` (7, 30, 90, 180, or 365). To target an exact region, set `redfinUrl` to a Redfin city/search URL.

### Example output

Each property is returned as a flat JSON record:

```json
{
  "propertyId": "170210161",
  "mlsId": "5678901",
  "address": "4501 Red River St",
  "city": "Austin",
  "state": "TX",
  "zip": "78751",
  "price": 725000,
  "beds": 3,
  "baths": 2,
  "sqft": 1680,
  "lotSize": 6534,
  "pricePerSqft": 432,
  "yearBuilt": 1948,
  "propertyType": "Single Family Residential",
  "status": "Active",
  "listingType": "3",
  "daysOnMarket": 12,
  "soldDate": null,
  "latitude": 30.30542,
  "longitude": -97.72519,
  "hoaFee": null,
  "listingAgentName": "Jane Miller",
  "listingBrokerName": "Compass RE Texas, LLC",
  "isNewConstruction": false,
  "photoUrl": "https://ssl.cdn-redfin.com/photo/1/bigphoto/161/170210161_0.jpg",
  "url": "https://www.redfin.com/TX/Austin/4501-Red-River-St-78751/home/170210161",
  "scraped_at": "2026-07-10T18:20:44.301Z"
}
```

*Field availability depends on what Redfin publishes for each listing; sold-only fields such as `soldDate` populate in recently-sold mode. Null fields are omitted from the record.*

### Use cases

- **Comparable sales & CMA** — pull recently-sold homes in a ZIP to value a subject property.
- **Investor deal sourcing** — filter by price band and property type to find flip or rental candidates.
- **Agent & broker lead lists** — extract listing agent and brokerage names for outreach.
- **Price & inventory monitoring** — re-run on a schedule to track price cuts and new listings.
- **Market research & dashboards** — feed clean housing data into BI tools and reports.
- **AI real estate assistants** — supply live listing data to LLM agents and valuation models.

### FAQ

#### Do I need a Redfin account or API key?

No. The scraper requires no login, no cookies, and no API key. You only need an Apify account to run it.

#### Can I scrape recently-sold homes for comps?

Yes. Set `soldWithinDays` to 7, 30, 90, 180, or 365 to switch into recently-sold mode, which returns the sold price and sold date for each home.

#### How much does the Redfin Scraper cost?

Pay-per-result: the first 25 properties are free (lifetime), then **$2 per 1,000 results** ($0.002 per property). You only pay for properties actually returned.

#### How many properties can I scrape at once?

Set `maxItems` up to 5,000 per run. The actor pages through Redfin's results and de-duplicates automatically. Run multiple locations across separate runs or a schedule for larger jobs.

#### Is scraping Redfin legal?

Scraping publicly available listing data is generally permissible, but results may include personal data (e.g. agent names) protected under laws like GDPR. Ensure you have a legitimate purpose and comply with applicable regulations.

### Use in Claude, ChatGPT & any MCP agent

This actor is available as a hosted **MCP server**, so AI agents can call it directly:

```
https://mcp.apify.com/?tools=themineworks/redfin-scraper
```

Add that endpoint to Claude, ChatGPT, or any MCP-compatible client and ask it to pull Redfin listings on demand. Or call it from code with the Apify client:

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('themineworks/redfin-scraper').call({
  location: 'Austin, TX',
  maxItems: 100,
  minBeds: 3,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

### Related real estate scrapers

Chain these siblings into a full property-data pipeline:

- [Realtor.com Scraper](https://apify.com/themineworks/realtor-scraper) — Realtor.com listings with agent & office data.
- [Zillow Search Scraper](https://apify.com/themineworks/zillow-search-scraper) — Zillow for-sale listings by location.
- [Zillow Property Details Scraper](https://apify.com/themineworks/zillow-property-details) — full Zillow detail pages by URL/ZPID.
- [Zillow Recently Sold Scraper](https://apify.com/themineworks/zillow-recently-sold) — Zillow sold comps for CMA.
- [Zillow Rental Listings Scraper](https://apify.com/themineworks/zillow-rental-listings) — Zillow for-rent listings.

# Actor input Schema

## `location` (type: `string`):

City, neighborhood or ZIP code to search (e.g. "Austin, TX", "90210", "Seattle, WA").

## `redfinUrl` (type: `string`):

Optionally paste a Redfin city/search URL (e.g. https://www.redfin.com/city/30818/TX/Austin) to scrape that exact region. Overrides the location field.

## `maxItems` (type: `integer`):

Maximum number of properties to scrape. First 25 lifetime are free.

## `soldWithinDays` (type: `integer`):

Leave empty for for-sale listings. Set to 7, 30, 90, 180 or 365 to scrape recently-sold homes instead.

## `minPrice` (type: `integer`):

Only return properties priced at or above this value.

## `maxPrice` (type: `integer`):

Only return properties priced at or below this value.

## `minBeds` (type: `integer`):

Only return properties with at least this many bedrooms.

## `proxyConfig` (type: `object`):

Apify proxy settings. US residential recommended for Redfin.

## Actor input object example

```json
{
  "location": "Austin, TX",
  "maxItems": 5,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `results` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "location": "Austin, TX",
    "maxItems": 5,
    "proxyConfig": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "location": "Austin, TX",
    "maxItems": 5,
    "proxyConfig": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/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 '{
  "location": "Austin, TX",
  "maxItems": 5,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call themineworks/redfin-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=themineworks/redfin-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "🏡 Redfin Scraper — For Sale & Sold · $2/1k",
        "description": "Scrape Redfin for-sale and recently-sold listings by city or zip: price, beds, baths, sqft, price/sqft, agent, MLS, coordinates and photos. No login, no API key. Use as an MCP server in Claude & AI agents.",
        "version": "0.1",
        "x-build-id": "RSDnqZie7n1tjUpPc"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/themineworks~redfin-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~redfin-scraper/runs": {
            "post": {
                "operationId": "runs-sync-themineworks-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/themineworks~redfin-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-themineworks-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",
                "required": [
                    "location"
                ],
                "properties": {
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "City, neighborhood or ZIP code to search (e.g. \"Austin, TX\", \"90210\", \"Seattle, WA\").",
                        "default": "Austin, TX"
                    },
                    "redfinUrl": {
                        "title": "Redfin URL (optional)",
                        "type": "string",
                        "description": "Optionally paste a Redfin city/search URL (e.g. https://www.redfin.com/city/30818/TX/Austin) to scrape that exact region. Overrides the location field."
                    },
                    "maxItems": {
                        "title": "Max properties",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Maximum number of properties to scrape. First 25 lifetime are free.",
                        "default": 5
                    },
                    "soldWithinDays": {
                        "title": "Sold within days (recently-sold mode)",
                        "type": "integer",
                        "description": "Leave empty for for-sale listings. Set to 7, 30, 90, 180 or 365 to scrape recently-sold homes instead."
                    },
                    "minPrice": {
                        "title": "Minimum price (USD)",
                        "type": "integer",
                        "description": "Only return properties priced at or above this value."
                    },
                    "maxPrice": {
                        "title": "Maximum price (USD)",
                        "type": "integer",
                        "description": "Only return properties priced at or below this value."
                    },
                    "minBeds": {
                        "title": "Minimum bedrooms",
                        "type": "integer",
                        "description": "Only return properties with at least this many bedrooms."
                    },
                    "proxyConfig": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify proxy settings. US residential recommended for Redfin.",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```