# 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 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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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 <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/h5bkpFdESmaG1RxEy/builds/0bDN92beA38M4TM4M/openapi.json