# Redfin Real Estate Scraper — MLS, Prices, HOA & Listing Agents (`foxlabs/redfin-scraper`) Actor

Scrape US homes for sale and recently sold properties from Redfin by city, ZIP code, or Redfin search URL. Extracts MLS IDs, prices, price/sqft, HOA fees, beds/baths, days on market, 3D tour flags, and listing agents.

- **URL**: https://apify.com/foxlabs/redfin-scraper.md
- **Developed by:** [Berkan Kaplan](https://apify.com/foxlabs) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 1,000 redfin property listings

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

<p align="center">
  <img src="https://img.shields.io/badge/Pay--Per--Event-%242.00_%2F_1K_Properties-00C853?style=for-the-badge" alt="Pay-Per-Event" />&nbsp;
  <img src="https://img.shields.io/badge/US_MLS_%26_Sold_Comps-HOA_%C2%B7_SqFt_%C2%B7_Agents-2962FF?style=for-the-badge" alt="US MLS & Sold Comps" />&nbsp;
  <img src="https://img.shields.io/badge/AI_Agent_Ready-MCP_%26_x402-7C4DFF?style=for-the-badge" alt="MCP & x402 Ready" />&nbsp;
  <img src="https://img.shields.io/badge/Dual_Runtime-Batch_%2B_Standby_API-FF6D00?style=for-the-badge" alt="Batch + Standby API" />
</p>

## Redfin Real Estate Scraper — MLS, Prices, HOA & Listing Agents 🚀

**foXLabs Real Estate, Location & Local Lead Series:** [Zillow Scraper](https://apify.com/foxlabs/zillow-scraper) · [Airbnb Scraper](https://apify.com/foxlabs/airbnb-scraper) · [Yelp Business Leads Scraper](https://apify.com/foxlabs/yelp-business-scraper) · [Booking.com Hotels Scraper](https://apify.com/foxlabs/booking-hotels-scraper) · [Google Maps Leads](https://apify.com/foxlabs/google-maps-scraper)

🎉 Extract structured **US active for-sale homes, pending/under-contract listings and recently sold comps (`sold_last_3m`, `sold_last_6m`, `sold_last_1y`)** from **Redfin** across any **US city, 5-digit ZIP code or Redfin region URL** — capturing **MLS IDs, prices, price/sq ft, monthly HOA fees, beds/baths, square footage, lot size, year built, days on market, sold dates, open-house schedules, 3D/video tour flags, listing agent names, brokerages and exact GPS coordinates** in **~5.8 seconds per 25 homes** at **$2.00 / 1,000**.

Built for residential & institutional real-estate investors, wholesalers, CMA / sold-comp valuation analysts, PropTech SaaS teams, mortgage/solar/moving B2B lead generators and real-estate AI agents.

### 🔍 What is the Redfin Real Estate Scraper — and when should you use it?

Because Redfin operates as a direct licensed real-estate brokerage across US Multiple Listing Services (MLSs), its listings expose **first-class MLS metadata right on search speed** — including `mlsId`, `hoaMonthlyUsd`, `pricePerSqFtUsd`, `lotSizeSqFt`, `yearBuilt`, `soldDate`, `openHouseText` and `listingAgentName` — without requiring slow per-property browser visits!

This Actor turns US cities, ZIP codes, Redfin region URLs and individual `/home/` property URLs into a clean **61-column MLS, AVM valuation & rental yield dataset** inside a lightweight `256 MB` HTTP runtime:

- **US Cities, 5-Digit ZIP Codes, Region URLs & Direct Property URLs** — pass `"Austin, TX"`, `"Miami, FL"`, `"78701"` or `"98101"` directly in `locations`, supply `/city/...` or `/zipcode/...` links in `redfinRegionUrls`, or target specific `/home/<propertyId>` links in `propertyUrls`.
- **Active, Pending & Sold Comps + Property Type Filter** — switch between `"for_sale"`, `"for_sale_and_pending"`, `"sold_last_3m"`, `"sold_last_6m"` and `"sold_last_1y"`, and optionally filter by `propertyTypes` (`"house"`, `"condo"`, `"townhouse"`, `"multifamily"`, `"land"`).
- **Rich 61-Field Extraction + Optional AVM & Rent Yield Enrichment (`enrichPropertyDetails: true`)** — captures `mlsId`, `priceUsd`, `pricePerSqFtUsd`, `hoaMonthlyUsd`, `primaryPhotoUrl`, `photoUrls[]`, `listingTags[]`, `beds`, `baths`, `sqFt`, `lotSizeSqFt`, `yearBuilt`, `daysOnMarket`, `soldDate`, `redfinEstimateUsd`, `avm1YearChangePct`, `zipMedianEstimateUsd`, `rentEstimateUsd` (`Low`/`High` + `grossRentYieldPct`), `lastSoldPriceUsd` and `lastSoldDate` at a flat **`$0.002` per property**.

**Use it when you need:** sold-comp CMA valuation tables (`pricePerSqFtUsd`, `soldDate`, `hoaMonthlyUsd`, `yearBuilt`); cash-flow & cap-rate screening (`redfinEstimateUsd`, `rentEstimateUsd`, `grossRentYieldPct`); daily newly listed MLS alerts (`daysOnMarket <= 1`); or PropTech / solar / home-services trigger leads.

**Use something else when:** you need **dedicated apartment rental portals** (`forRent` apartment communities — use [Zillow Scraper](https://apify.com/foxlabs/zillow-scraper) for `forRent` buildings, or [Airbnb Scraper](https://apify.com/foxlabs/airbnb-scraper) for short-term rental nightly rates).

### 🤖 Use with AI agents (MCP, Claude, Cursor & x402)

**Already connected to the Apify MCP server?** Ask your AI assistant to call `foxlabs/redfin-scraper`.

- **Hosted MCP URL (zero install):** `https://mcp.apify.com?tools=foxlabs/redfin-scraper`
- **Local stdio config (Claude Desktop, Cursor, Cline, Windsurf):**

```json
{
  "mcpServers": {
    "redfin-scraper": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--tools", "foxlabs/redfin-scraper"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}
```

**Your agent can pay for its own runs.** Billed at a flat **$0.002 per unique `property`** (`$2.00 / 1,000`, diagnostic `status` rows `$0.00`), this Actor supports autonomous micropayments via **x402 (USDC on Base)** or **Skyfire** alongside standard Apify tokens.

Copy-paste prompt for Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
Use the Apify Actor `foxlabs/redfin-scraper` to extract US active for-sale properties, pending contracts and recently sold comps from Redfin with MLS IDs, HOA fees, price/sqft, year built and listing agents.

Input fields:
- `locations`: array of US "City, ST" names or 5-digit ZIP codes (e.g. ["Austin, TX", "78704"])
- `listingStatus`: "for_sale" (default) | "for_sale_and_pending" | "sold_last_3m" | "sold_last_6m" | "sold_last_1y"
- `minPrice` / `maxPrice`: integer USD price filters (0 = no limit)
- `minBeds`: integer minimum bedroom count (0 = any)
- `redfinRegionUrls`: optional array of https://www.redfin.com/city/... or /zipcode/... URLs
- `maxPropertiesPerLocation`: integer 1..350 (default 25)

Start with:
{"locations":["Austin, TX"],"listingStatus":"for_sale","minBeds":3,"maxPrice":600000,"maxPropertiesPerLocation":25}
```

**Things you can ask your AI agent:**

- *"Pull 50 3+ bedroom homes sold in the last 3 months (`sold_last_3m`) in ZIP `78704` and calculate the median `pricePerSqFtUsd` and `daysOnMarket`."*
- *"Find active single-family homes under `$450,000` in Phoenix, AZ with `hoaMonthlyUsd` under `$100` (or `null`) listed in the last 3 days."*
- *"Compare active `pricePerSqFtUsd` (`for_sale`) against closed `pricePerSqFtUsd` (`sold_last_3m`) across Austin, Dallas and San Antonio."*

The machine-readable Actor summary, MCP metadata and schema live at `https://apify.com/foxlabs/redfin-scraper.md`.

### 📋 Overview

Everything needed for US MLS property intelligence, sold-comp underwriting and real-estate lead generation — in one 44-column dataset.

| Property | Details |
|---|---|
| **Public data source** | Public Redfin US MLS search & region feeds (`redfin.com`) |
| **Supported statuses** | `for_sale`, `for_sale_and_pending`, `sold_last_3m`, `sold_last_6m`, `sold_last_1y` |
| **Authentication required** | None — zero Redfin login, MLS IDX feed license or cookies |
| **Container footprint** | Lightweight `256 MB` HTTP runtime (**5.8s** for 25 properties on verified QA) |
| **Output row types (`rowType`)** | `property` (`$0.002` / `$2.00 per 1,000`), `status` (`$0.00` diagnostic) |
| **Deduplication & restart safety** | Deterministic `rowKey` (`redfin:<propertyId>`) across multi-ZIP sweeps & restarts |
| **Execution modes** | Standard Batch Dataset runs + synchronous Standby HTTP API (`GET /`, `POST /scrape`) |

**Why real-estate investors & data teams pick this Actor:**

- 🏠 **HOA fees, `yearBuilt`, `lotSizeSqFt` & `mlsId` in one fast pass** — unlike portals that hide HOA fees and year built behind slow per-property detail requests, Redfin's brokerage feed delivers all 44 columns in ~6 seconds!
- 📉 **True Sold Comps (`sold_last_3m` / `6m` / `1y`)** — pull verified closed sale prices (`priceUsd`), `soldDate` and `pricePerSqFtUsd` by ZIP code to underwrite flips, BRRRR deals and appraisals accurately.
- 🤝 **Listing Agent & Open House Signals** — captures `listingAgentName`, `listingBrokerage`, `openHouseText`, `has3DTour` and `isHotHome`.
- 💸 **Flat `$2.00 / 1,000` on standard Datacenter proxies** — zero residential proxy bandwidth bills or detail-tier surcharges.

### ✨ Key Features

- 🗺️ **City, 5-Digit ZIP & Custom Region URL Support** — Built-in US metro lookup + live autocomplete resolution for any US city or ZIP code, plus direct support for Redfin `/city/`, `/zipcode/`, `/neighborhood/` and `/county/` URLs.
- 🏗️ **Granular Structural & Tour Attributes** — Extracts `beds`, `baths`, `fullBaths`, `partialBaths`, `sqFt`, `lotSizeSqFt`, `yearBuilt`, `propertyType`, `isNewConstruction`, `has3DTour`, `hasVideoTour`, `hasVirtualTour`, `photoCount`, `badges[]` and `keyFacts[]`.
- 📍 **Exact Parcel Coordinates & Subdivision** — Captures `streetAddress`, `city`, `state`, `zipCode`, `neighborhoodOrSubdivision`, `latitude` and `longitude`.
- ⚡ **Synchronous Standby HTTP (`POST /scrape`)** — Ready for real-time underwriting calculators, Clay workflows and AI deal-screening agents.

### 🎬 Quick Start (API & Standby HTTP)

**1. Synchronous Batch API call (returns JSON array directly):**

```bash
curl -X POST "https://api.apify.com/v2/acts/foxlabs~redfin-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"locations":["Austin, TX"],"listingStatus":"for_sale","minBeds":3,"maxPropertiesPerLocation":25}'
```

**2. Real-time Standby HTTP API (`POST /scrape`):**

```bash
curl -X POST "https://foxlabs--redfin-scraper.apify.actor/scrape?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"locations":["78704"],"listingStatus":"sold_last_3m","maxPropertiesPerLocation":20}'
```

### 🚀 Getting Started (3 steps)

1. **Enter US cities, ZIP codes or Redfin region URLs** — Add `"Austin, TX"`, `"78701"` or `"Seattle, WA"` in **Locations**, or paste Redfin region links in **Redfin Region URLs**.
2. **Pick listing status & price/bedroom filters** — Select `"for_sale"`, `"for_sale_and_pending"` or `"sold_last_3m"`/`"6m"`/`"1y"`, and set optional `minPrice`, `maxPrice` and `minBeds`.
3. **Run & export** — Click **Start** and download your 44-column MLS property dataset in JSON, CSV, Excel or Parquet.

### 📥 Input & Filters

```json
{
  "locations": ["Austin, TX", "78704"],
  "listingStatus": "for_sale",
  "propertyTypes": ["house", "townhouse"],
  "minPrice": 250000,
  "maxPrice": 750000,
  "minBeds": 3,
  "redfinRegionUrls": [],
  "propertyUrls": [],
  "enrichPropertyDetails": true,
  "maxPropertiesPerLocation": 50
}
```

| Field | Type | Default | Description |
|---|---|---|---|
| `locations` | `array<string>` | `["Austin, TX"]` | US `"City, ST"` names or 5-digit ZIP codes (`"Austin, TX"`, `"78701"`, `"Miami, FL"`, `"Seattle, WA"`). |
| `listingStatus` | `string` | `"for_sale"` | `"for_sale"`, `"for_sale_and_pending"`, `"sold_last_3m"`, `"sold_last_6m"`, or `"sold_last_1y"`. |
| `propertyTypes` | `array<string>` | `[]` | Optional filter: `"house"`, `"condo"`, `"townhouse"`, `"multifamily"`, `"land"`, `"manufactured"`. |
| `minPrice` / `maxPrice` | `integer` | `0` / `0` | Optional USD price floor and ceiling (`0` = no limit). |
| `minBeds` | `integer` | `0` | Optional minimum bedroom count (`0` = any bedroom count). |
| `redfinRegionUrls` | `array<string>` | `[]` | Direct Redfin region URLs (`https://www.redfin.com/city/30818/TX/Austin`, `/zipcode/78701`, `/neighborhood/...`). |
| `propertyUrls` | `array<string>` | `[]` | Direct Redfin `/home/<propertyId>` URLs (automatically enriches AVM valuation & rental estimates). |
| `enrichPropertyDetails` | `boolean` | `false` | Enriches every property with `redfinEstimateUsd`, `avm1YearChangePct`, `zipMedianEstimateUsd`, `rentEstimateUsd` (`Low`/`High` + `grossRentYieldPct`) and `lastSoldPriceUsd` / `lastSoldDate` at the same flat `$2.00 / 1,000` rate. |
| `maxPropertiesPerLocation` | `integer` | `25` | Maximum properties extracted per location or region URL (`1`–`350`). |
| `proxyConfiguration` | `object` | `{"useApifyProxy": true}` | Managed automatically via standard Apify Proxy. |

**Copy-paste input recipes:**

- **ZIP-level 90-day Sold Comps CMA (`sold_last_3m`):**
  `{"locations":["78704","78745","78702"],"listingStatus":"sold_last_3m","minBeds":3,"maxPropertiesPerLocation":100}`
- **BRRRR & Rental Yield Underwriting (`enrichPropertyDetails: true`):**
  `{"locations":["Seattle, WA"],"listingStatus":"for_sale","propertyTypes":["house"],"enrichPropertyDetails":true,"maxPropertiesPerLocation":30}`
- **Direct Redfin `/home/` property URL lookup (`propertyUrls`):**
  `{"locations":[],"propertyUrls":["https://www.redfin.com/WA/Seattle/9041-13th-Ave-SW-98106/home/475125"]}`

### 📤 Output Schema & Real Sample Record

Each item carries `rowType` (`"property"` or free diagnostic `"status"`) and deterministic `rowKey` (`redfin:<propertyId>`).

| Field Group | Fields (61 Columns Total) |
|---|---|
| **Property & MLS Identity** | `rowKey`, `rowType`, `propertyId`, `listingId`, `mlsId`, `mlsSourceId`, `mlsStatus`, `url`, `propertyType`, `detailsEnriched`, `listingStatusFilter`, `searchLocation`, `scrapedAt` |
| **Pricing, AVM & Rental Yield** | `priceUsd`, `pricePerSqFtUsd`, `hoaMonthlyUsd`, `redfinEstimateUsd`, `avm1YearChangePct`, `zipMedianEstimateUsd`, `rentEstimateUsd`, `rentEstimateLowUsd`, `rentEstimateHighUsd`, `grossRentYieldPct`, `lastSoldPriceUsd`, `lastSoldDate`, `daysOnMarket`, `soldDate` |
| **Beds, Baths & Lot Specs** | `beds`, `baths`, `fullBaths`, `partialBaths`, `sqFt`, `lotSizeSqFt`, `yearBuilt`, `isNewConstruction`, `isHotHome`, `isRedfinListing` |
| **Address & Coordinates** | `streetAddress`, `unitNumber`, `city`, `state`, `zipCode`, `neighborhoodOrSubdivision`, `countryCode`, `timeZone`, `latitude`, `longitude` |
| **Photos, Agent, Tours & Tags** | `primaryPhotoUrl`, `photoUrls[]`, `photoCount`, `listingAgentName`, `listingBrokerage`, `openHouseText`, `has3DTour`, `hasVideoTour`, `hasVirtualTour`, `hasInteractiveFloorplan`, `badges[]`, `keyFacts[]`, `listingTags[]`, `description` |

#### Real sample record (from verified platform pre-publish run `vSS89ydRiQXJ20FcN`, 2026-11-14)

```json
{
  "rowKey": "redfin:32823689",
  "rowType": "property",
  "propertyId": "32823689",
  "listingId": "226607626",
  "mlsId": "3953946",
  "mlsStatus": "Active",
  "url": "https://www.redfin.com/TX/Austin/12325-Los-Indios-Trl-78729/unit-17/home/32823689",
  "streetAddress": "12325 Los Indios Trl #17",
  "unitNumber": "17",
  "city": "Austin",
  "state": "TX",
  "zipCode": "78729",
  "neighborhoodOrSubdivision": "Groves Los Indios Condos Ph 02",
  "countryCode": "US",
  "latitude": 30.4400412,
  "longitude": -97.7663067,
  "priceUsd": 225000,
  "pricePerSqFtUsd": 185,
  "hoaMonthlyUsd": 438,
  "beds": 3,
  "baths": 2.5,
  "fullBaths": 2,
  "partialBaths": 1,
  "sqFt": 1219,
  "lotSizeSqFt": 740,
  "yearBuilt": 1986,
  "daysOnMarket": 1,
  "soldDate": null,
  "propertyType": "Townhouse",
  "isNewConstruction": false,
  "isHotHome": false,
  "has3DTour": true,
  "hasVideoTour": false,
  "hasVirtualTour": true,
  "openHouseText": "Nov 14, 2:00PM",
  "photoCount": 21,
  "listingAgentName": "Vanessa Stroud",
  "listingBrokerage": null,
  "badges": [
    "Open House",
    "3D Walkthrough"
  ],
  "keyFacts": [
    "Updated bathrooms",
    "Cozy fireplace",
    "Open concept layout"
  ],
  "description": "Enjoy comfortable, low-maintenance living in this beautifully appointed two-story corner-unit home, ideally located near The Domain, major highways, premier shopping, and dining...",
  "listingStatusFilter": "for_sale",
  "searchLocation": "Austin, TX",
  "scrapedAt": "2026-11-14T05:07:56.929Z"
}
```

Every run also writes a `SOURCE_REPORT` telemetry summary to the default Key-Value Store.

### 🧪 Data Quality — Measured

Verified on the Apify platform across QA runs (`RB26TemPBrEOeMHS2`, `eq2jy6dYpkobsChKR`, `ThanGu7EPaTR1xsJb`) and pre-publish live billing verification (`vSS89ydRiQXJ20FcN` on 2026-11-14):

- **100% parcel uniqueness across multi-city & multi-ZIP sweeps:** Deduplicated by `redfin:<propertyId>` (`50/50` unique properties verified across multi-city tests, `0` duplicates).
- **Rich single-pass MLS completeness:** `propertyId`, `mlsId`, `priceUsd`, `pricePerSqFtUsd`, `beds`, `baths`, `sqFt`, `yearBuilt`, `latitude` and `longitude` populated directly without slow browser detail crawls, while absent HOA fees or sold dates emit honest `null` values.
- **Verified PPE billing accuracy:** Settled `chargedEventCounts` on run `vSS89ydRiQXJ20FcN` matched `property` rows `1:1` (`$0.002` each), with diagnostic `status` rows at `$0.00`.

### ⏱️ Performance — Measured

Measured on the Apify platform at the default **`256 MB`** memory tier:

- **5.8 seconds for 25 Austin MLS properties:** Platform QA run `RB26TemPBrEOeMHS2` (`locations: ["Austin, TX"]`, `25` properties) finished in **`5.8s`** on standard Datacenter proxies inside `256 MB` RAM.
- **Migration-safe Dataset deduplication:** Hydrates existing `redfin:<propertyId>` keys on startup so container restarts never duplicate properties or charges.

### 💼 Use Cases

1. **Automated Sold-Comp Underwriting & Flip Analysis (`sold_last_3m` / `6m`)**
   - *Input:* `{"locations":["78704","78702"],"listingStatus":"sold_last_6m","minBeds":3,"maxPropertiesPerLocation":200}`
   - *Output:* Closed `priceUsd`, `pricePerSqFtUsd`, `soldDate`, `sqFt`, `lotSizeSqFt`, `yearBuilt` and `neighborhoodOrSubdivision`.
   - *Business action:* Calculate subdivision-level After-Repair Value (ARV) per square foot automatically before making cash offers.

2. **Same-Day New Listing & Distressed Keyword Alerts**
   - *Input:* Daily scheduled run with `listingStatus: "for_sale"` across target investment ZIP codes.
   - *Output:* Filter `daysOnMarket <= 1` or scan `description` / `keyFacts` for `"investor"`, `"TLC"`, `"as-is"`, `"assumable"` or `"ADU"`.
   - *Business action:* Beat competing buyers to newly listed MLS deals within hours of listing activation.

3. **Home-Services, Moving, Solar & Insurance Trigger Marketing**
   - *Input:* `{"locations":["Phoenix, AZ","Scottsdale, AZ"],"listingStatus":"for_sale_and_pending","minPrice":400000,"maxPropertiesPerLocation":150}`
   - *Output:* Exact `streetAddress`, `city`, `state`, `zipCode`, `sqFt`, `yearBuilt` and `mlsStatus` (`Pending` / `Under Contract`).
   - *Business action:* Mail or target homeowners in escrow (`Pending`) right when moving, roofing, solar and home-warranty purchase intent peaks.

4. **Zillow + Redfin Dual-Portal Cross-Verification**
   - *Input:* Join `foxlabs/redfin-scraper` (`mlsId`, `hoaMonthlyUsd`, `keyFacts`, `openHouseText`) with [Zillow Scraper](https://apify.com/foxlabs/zillow-scraper) (`zestimate`, `rentZestimate`, `taxAssessedValue`).
   - *Output:* Unified investment underwriting sheet combining MLS comp accuracy with automated rent & valuation estimates.
   - *Business action:* Flag properties listed >12% below both neighborhood sold-comp `pricePerSqFtUsd` and Zestimate.

### 🔗 Integrations (Node.js, Python, n8n, Make & Clay)

#### JavaScript / Node.js (`apify-client`)

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('foxlabs/redfin-scraper').call({
    locations: ['Austin, TX'],
    listingStatus: 'for_sale',
    minBeds: 3,
    maxPropertiesPerLocation: 25,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Fetched ${items.length} Redfin MLS properties`, items[0]);
```

#### Python (`apify-client` v3)

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("foxlabs/redfin-scraper").call(
    run_input={
        "locations": ["Austin, TX"],
        "listingStatus": "sold_last_3m",
        "minBeds": 3,
        "maxPropertiesPerLocation": 25,
    }
)

for item in client.dataset(run.default_dataset_id).iterate_items():
    if item["rowType"] == "property":
        print(item["streetAddress"], "| $", item["priceUsd"], "| $/sqft:", item["pricePerSqFtUsd"], "| MLS:", item["mlsId"])
```

*(Written for `apify-client` v3 where `call()` returns a `Run` object exposing `run.default_dataset_id`; on `apify-client` v1/v2 use `run["defaultDatasetId"]`.)*

#### n8n, Make, Zapier & Clay

- **Automated Underwriting Bot (n8n / Make):** Trigger `POST https://foxlabs--redfin-scraper.apify.actor/scrape` synchronously whenever a wholesaler enters a property's 5-digit ZIP code in Airtable/Slack, returning instant 90-day sold comps in ~5 seconds.

### 📊 Pricing (Pay-Per-Event)

Simple, flat **Pay-Per-Event (PPE)** pricing — all 44 MLS, HOA, structural and agent columns are included in one flat rate:

| Event Name | Trigger | Price per Item | Price per 1,000 |
|---|---|---|---|
| `property` | Once per unique Redfin listing or sold comp delivered (`rowType: "property"`) | **$0.002** | **$2.00 / 1,000** |
| `status` *(diagnostic)* | Empty input, unresolved region, or zero-match filter note | **$0.00 (Free)** | **$0.00** |

**Worked cost examples:**

- **100 active MLS listings or sold comps across 4 ZIP codes:** `100 × $0.002` = **$0.20**
- **500 properties across Austin, Dallas & Houston:** `500 × $0.002` = **$1.00**
- **1,000 US MLS properties:** `1,000 × $0.002` = **$2.00**

**Billing guarantees:**

- **Proxy traffic included:** Runs on standard Apify Proxy with zero external proxy charges.
- **Zero duplicate charges:** Overlapping city + ZIP inputs deduplicate automatically via `redfin:<propertyId>`.
- **Hard spend cap support:** Configure **Maximum cost per run** in Apify options; `ChargingManager` halts cleanly at your budget limit. *(Note: if Apify applies its platform `apify-actor-start` fee on your plan, that start event applies when a run starts, including zero-result runs.)*

### ❓ Frequently Asked Questions (FAQ)

#### Do I need a Redfin account, MLS IDX license, or residential proxies?

No. All public Redfin active, pending and sold property feeds are collected keylessly on standard Datacenter proxies managed automatically inside the Actor — zero Redfin login credentials, session cookies, MLS IDX agreements, or external proxy keys are ever required from you.

#### Why is `maxPropertiesPerLocation` capped at `350` per region, and how do I scrape an entire major metro?

Redfin's regional GIS feed returns up to `350` ranked homes per single city or region query. To collect `3,000–15,000+` homes across a large metro like Los Angeles, Chicago, Houston or Miami, pass an array of **5-digit ZIP codes** in `locations` (e.g., `["78701", "78702", "78704", "78745", ...]`) or slice by `minPrice` / `maxPrice` brackets — deterministic `redfin:<propertyId>` deduplication ensures overlapping boundary homes are never duplicated or billed twice.

#### When should I use `foxlabs/redfin-scraper` vs. `foxlabs/zillow-scraper`?

Redfin shines when you want **fast single-pass MLS & structural data** (`mlsId`, `hoaMonthlyUsd`, `yearBuilt`, `lotSizeSqFt`, `keyFacts`, `openHouseText`, `listingAgentName`) at `$2.00 / 1,000` in ~6 seconds, or clean `sold_last_3m` / `6m` / `1y` comp sweeps. Use [Zillow Scraper](https://apify.com/foxlabs/zillow-scraper) when you need **rental listings (`forRent` apartments/homes)**, Zillow's proprietary `zestimate` & `rentZestimate` valuations, or full historical multi-year `priceHistory` & `taxHistory` arrays.

#### How does `soldDate` behave in non-disclosure states like Texas?

In public-record disclosure states (such as California, Florida, Washington, Arizona or New York), `sold_last_3m` / `6m` / `1y` rows report exact closed sale prices and `soldDate` timestamps. Even in non-disclosure states like Texas where county clerks do not publish deed prices, Redfin still surfaces MLS-participating sold listings and last-known list/MLS pricing wherever permitted by the local MLS board.

#### What types of URLs can I pass inside `redfinRegionUrls`?

You can paste any public Redfin region URL directly from your browser address bar, including city URLs (`https://www.redfin.com/city/30818/TX/Austin`), ZIP code URLs (`https://www.redfin.com/zipcode/78701`), neighborhood URLs (`https://www.redfin.com/neighborhood/...`), or county URLs (`https://www.redfin.com/county/...`). Remember to set `"locations": []` if you only want your `redfinRegionUrls` to run.

#### Why is `hoaMonthlyUsd` `null` on many single-family houses?

Fee-simple single-family homes outside Homeowners Associations have no monthly HOA assessment (`hoaMonthlyUsd: null`). Rather than emitting a misleading `0` when an MLS listing has no HOA fee field, the Actor outputs `null` so condo/townhouse HOA averages remain mathematically accurate.

#### How do I get Pending / Under-Contract listings before they close?

Set `"listingStatus": "for_sale_and_pending"` in your input, then filter the output Dataset on `mlsStatus` (for example `"Pending"`, `"Contingent"` or `"Under Contract"`). Pending listings are goldmines for moving companies, home-insurance brokers, solar installers and remodelers.

#### Does Redfin cover properties outside the United States?

Redfin focuses on US MLS markets (plus select Canadian MLS regions supported on `redfin.com` via `redfinRegionUrls`). For European real estate or global short-term stays, check out our [Airbnb Scraper](https://apify.com/foxlabs/airbnb-scraper) and [Booking.com Hotels Scraper](https://apify.com/foxlabs/booking-hotels-scraper).

#### How do I format city names in `locations` to avoid ambiguous city collisions (e.g., Portland OR vs. Portland ME)?

Always include the 2-letter US state abbreviation after the city name — such as `"Portland, OR"`, `"Springfield, IL"`, `"Columbus, OH"` or `"Miami, FL"` — or pass exact 5-digit US ZIP codes (`"97201"`, `"78704"`) or canonical `redfinRegionUrls` for 100% deterministic, zero-ambiguity parcel targeting.

#### What happens if a small rural ZIP code has zero homes matching my `minPrice` / `minBeds` filter?

If an entire run produces zero matching homes across all requested locations, the Actor finishes cleanly with `SUCCEEDED` and writes one free diagnostic `rowType: "status"` row explaining that zero properties matched your filter criteria (`$0.00` event charge).

#### Can AI agents and Clay workflows call this Actor synchronously?

Yes. Connect Claude Desktop, Cursor, Windsurf or custom MCP agents to `https://mcp.apify.com?tools=foxlabs/redfin-scraper`, or `POST` JSON requests directly to `https://foxlabs--redfin-scraper.apify.actor/scrape` in Apify Standby mode for sub-10-second real-time comps.

#### Is the Actor protected against duplicate rows and double charges on container restarts?

Yes. At startup, the Actor inspects the active run's Dataset, hydrates all previously delivered `redfin:<propertyId>` keys into memory, and skips any property already emitted prior to a container migration or restart — guaranteeing 100% Dataset uniqueness and zero duplicate PPE billing.

### 🐛 Troubleshooting

- **City search stopped at `350` properties:** Redfin caps any single region query at `350` properties; split the metro into 5-digit ZIP codes in `locations` to extract thousands of homes seamlessly.
- **Default `"Austin, TX"` ran alongside `redfinRegionUrls`:** Pass `"locations": []` when running region URLs alone.
- **Location autocomplete could not resolve an informal area name:** Use standard `"City, ST"` format (`"Austin, TX"`), a 5-digit ZIP code (`"78704"`), or copy the exact URL from `redfin.com` into `redfinRegionUrls`.
- **Dataset contains only `rowType: "status"` (`EMPTY_INPUT`):** Both `locations` and `redfinRegionUrls` were empty.

### 🚧 What It Does Not Do

- Does **not** scrape apartment rental portals (use [Zillow Scraper](https://apify.com/foxlabs/zillow-scraper) with `listingStatus: "forRent"` for apartments and houses for rent).
- Does **not** bypass MLS login walls for realtor-only private remarks or lockbox codes.

### ⚠️ Trademark Notice

This Actor is an independent software tool developed by **foXLabs** and is not affiliated with, endorsed by, or sponsored by Redfin Corporation. "Redfin" is a registered trademark of Redfin Corporation, referenced strictly to describe compatibility with publicly accessible web pages.

### ⚖️ Is It Legal to Scrape Public Redfin Property Data?

This Actor accesses only publicly displayed real-estate listings, public county/MLS summary fields and public listing-agent attributions visible to unauthenticated web visitors — with zero login or authentication bypass. Ensure downstream usage and any agent outreach comply with applicable federal and state laws (including CCPA and CAN-SPAM).

### 🤝 Support, Custom Data & Contact

- 🌐 **Website & full portfolio:** [data.foxlabs.com.tr](https://data.foxlabs.com.tr)
- 📧 **Custom data & enterprise inquiries:** info@foxlabs.com.tr
- 🐛 **Bug reports & feature requests:** open an issue in the Actor's **Issues** tab on Apify Store (include your Run ID)
- 🧰 **Browse all foXLabs Actors:** [apify.com/foxlabs](https://apify.com/foxlabs)

### Changelog

#### 0.1.3 (2026-11-14)

- Added `propertyUrls`, `enrichPropertyDetails` and `propertyTypes` input options and expanded the dataset from 44 to 61 columns (`primaryPhotoUrl`, `photoUrls[]`, `listingTags[]`, `hasInteractiveFloorplan`, `redfinEstimateUsd`, `avm1YearChangePct`, `zipMedianEstimateUsd`, `rentEstimateUsd`, `rentEstimateLowUsd`, `rentEstimateHighUsd`, `grossRentYieldPct`, `lastSoldPriceUsd`, `lastSoldDate`) with zero PPE price increase.

#### 0.1.2 (2026-11-14)

- Upgraded Store README to full SIÁN standard with MCP & x402 AI agent configuration, Standby HTTP `POST /scrape` examples, verified QA & PPE billing metrics, worked cost tables, and expanded 12-question FAQ.

#### 0.1.0 (2026-11-13)

- Initial release of `foxlabs/redfin-scraper` supporting US cities, 5-digit ZIP codes and `redfinRegionUrls` across `for_sale`, `for_sale_and_pending` and `sold_last_3m`/`6m`/`1y` statuses, with Batch + Standby HTTP modes.

# Changelog

This Actor's version history is a separate document: https://apify.com/foxlabs/redfin-scraper/changelog.md

# Actor input Schema

## `locations` (type: `array`):

US city + state names or 5-digit ZIP codes (e.g. 'Austin, TX', '78701', 'Miami, FL', 'Seattle, WA').

## `listingStatus` (type: `string`):

Choose Active For-Sale listings, Pending/Under Contract, or Recently Sold homes.

## `propertyTypes` (type: `array`):

Optional filter by property type: 'house', 'condo', 'townhouse', 'multifamily', 'land', 'manufactured'. Leave empty for all types.

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

Minimum listing/sale price in USD (0 = no minimum).

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

Maximum listing/sale price in USD (0 = no maximum).

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

Minimum bedroom count (0 = any).

## `redfinRegionUrls` (type: `array`):

Optional Redfin region URLs such as https://www.redfin.com/city/30818/TX/Austin or https://www.redfin.com/zipcode/78701.

## `propertyUrls` (type: `array`):

Optional direct Redfin property URLs (e.g. https://www.redfin.com/WA/Seattle/9041-13th-Ave-SW-98106/home/475125). Automatically enriches AVM valuation and rent estimates.

## `enrichPropertyDetails` (type: `boolean`):

When enabled, fetches Redfin AVM home valuation, 1-year valuation change %, ZIP median estimate, monthly rental estimate (low/high + gross yield %), and prior sale price/date for every property at the same flat $2.00/1K rate.

## `maxPropertiesPerLocation` (type: `integer`):

Maximum properties to extract per location or URL (1–350).

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. Runs on standard Datacenter proxies by default.

## Actor input object example

```json
{
  "locations": [
    "Austin, TX"
  ],
  "listingStatus": "for_sale",
  "propertyTypes": [],
  "minPrice": 0,
  "maxPrice": 0,
  "minBeds": 0,
  "redfinRegionUrls": [],
  "propertyUrls": [],
  "enrichPropertyDetails": false,
  "maxPropertiesPerLocation": 25,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `dataset` (type: `string`):

No description

## `sourceReport` (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 = {
    "locations": [
        "Austin, TX"
    ],
    "maxPropertiesPerLocation": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("foxlabs/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 = {
    "locations": ["Austin, TX"],
    "maxPropertiesPerLocation": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("foxlabs/redfin-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Austin, TX"
  ],
  "maxPropertiesPerLocation": 25
}' |
apify call foxlabs/redfin-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,foxlabs/redfin-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/vqVAk4LHglZDOIc5w/builds/JyJmLSvnhK8ufc05E/openapi.json
