# Zillow Scraper — Sales, Rentals, Sold, Zestimate & Agent Data (`foxlabs/zillow-scraper`) Actor

Scrape Zillow homes for sale, rentals, and recently sold listings by city, ZIP code, or URL. Extracts price, Zestimate, rent Zestimate, tax assessment, price drops, beds/baths/sqft, GPS, MLS ID, agent/broker contact, HOA fee, and price history. No login required.

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

## Pricing

from $2.50 / 1,000 zillow 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-Sales_%2B_Rentals_%2B_Sold-00C853?style=for-the-badge" alt="Pay-Per-Event" />&nbsp;
  <img src="https://img.shields.io/badge/Zestimate_%26_MLS-Agent_Phones_Included-2962FF?style=for-the-badge" alt="Zestimate & MLS" />&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>

## Zillow Scraper — Sales, Rentals, Sold, Zestimate & Agent Data 🚀

**foXLabs Real Estate & Local Intelligence Series:** [Redfin Real Estate Scraper](https://apify.com/foxlabs/redfin-scraper) · [Airbnb Scraper](https://apify.com/foxlabs/airbnb-scraper) · [Booking.com Hotels Scraper](https://apify.com/foxlabs/booking-hotels-scraper) · [Yelp Business Leads Scraper](https://apify.com/foxlabs/yelp-business-scraper) · [Google Maps Leads](https://apify.com/foxlabs/google-maps-scraper) · [AutoScout24 Scraper](https://apify.com/foxlabs/autoscout24-scraper)

🎉 Extract structured **US Zillow real estate listings** — **Homes For Sale**, **Rentals & Multi-Unit Apartment Communities**, and **Recently Sold Comps** — by **city, neighborhood, 5-digit ZIP code**, custom **Zillow map/filter search URL**, or direct **ZPID / `homedetails` URL** with **zero login, zero cookies and zero user API keys**.

Built for real-estate investors & acquisitions teams, mortgage/proptech B2B lead generation, cap-rate & AVM valuation modelers, brokerages and autonomous AI agents.

### 🔍 What is the Zillow Scraper — and when should you use it?

Legacy Zillow scrapers typically force buyers to stitch together three separate paid Actors — one for city/map search, a second for ZIP code sweeps, and a third for property detail & agent enrichment — while charging heavy browser compute costs.

This Actor unifies Zillow discovery and deep MLS/property enrichment inside a single `256 MB` HTTP runtime:

- **Search by City, Neighborhood, ZIP or Map URL** (`locations` & `searchUrls`) — query `"Austin, TX"`, `"78701"`, or paste any custom polygon/school-district/keyword URL directly from `zillow.com`.
- **Active Sales + Rentals + Sold Comps (`listingStatus`)** — switch seamlessly between `"forSale"`, `"forRent"` (including multi-family apartment community floorplan & unit rent breakdowns in `units[]`), and `"sold"` comps (with realized sale price and `dateSold`).
- **Instant Valuations Right on Search Rows (`enrichDetails: false`)** — every search listing already delivers **`price`, `zestimate`, `rentZestimate`, `taxAssessedValue`, `priceChange`, `daysOnZillow`, `bedrooms`, `bathrooms`, `livingAreaSqft`, `latitude`, `longitude` and `brokerName`** without opening individual detail pages.
- **Optional Deep MLS & Listing Agent Enrichment (`enrichDetails: true` / `propertyUrls`)** — enriches properties with `yearBuilt`, `monthlyHoaFee`, **`mlsId`**, **`mlsName`**, **`agentPhone`** (MLS attribution contact), `agentName`, `priceHistory`, `taxHistory`, `openHouseSchedule` and full `description`.

**Use it when you need:** automated cap-rate & gross-yield screening (`(rentZestimate * 12) / price`); sold-comp valuation tables by ZIP code; listing-agent & brokerage outreach lists (`agentPhone`, `brokerName`, `mlsId`); price-cut distress tracking (`priceChange < 0`); or single-property ZPID lookups.

**Use something else when:** you need **non-US/Canadian international property portals** (Zillow covers the United States and select Canadian markets) or **off-market county deed/mortgage lien filings** not listed on Zillow. To cross-check MLS attribution, HOA fees and agent emails from a second US brokerage portal, pair this Actor with [Redfin Real Estate Scraper](https://apify.com/foxlabs/redfin-scraper).

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

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

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

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

**Your agent can pay for its own runs.** This Actor uses pay-per-event pricing and supports agentic micropayments, allowing autonomous agents to invoke runs and settle usage over **x402 (USDC on Base)** or **Skyfire** as well as standard Apify tokens. Each unique property triggers either `listing` (`$0.0025`) or `property-detail` (`$0.0045`, never both on the same property), and diagnostic `status` rows are `$0.00`.

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

```text
Use the Apify Actor `foxlabs/zillow-scraper` to search US Zillow homes for sale, rentals, or recently sold comps, or to enrich specific ZPIDs.

Input fields:
- `locations`: array of US cities, neighborhoods or 5-digit ZIP codes (e.g. ["Austin, TX", "78701"])
- `searchUrls`: optional array of custom Zillow map/filter URLs
- `propertyUrls`: optional array of Zillow homedetails URLs or numeric ZPIDs (e.g. ["89550912"])
- `listingStatus`: "forSale" (default) | "forRent" | "sold"
- `maxItemsPerLocation`: integer 1..820 (default 40)
- `enrichDetails`: boolean (default false) — fetches MLS ID, agent phone, HOA fee, yearBuilt & price/tax history
- `minPrice` / `maxPrice`: optional integer USD bounds
- `minBeds` / `minBaths`: optional bedroom / bathroom minimums
- `homeTypes`: optional array (e.g. ["SINGLE_FAMILY", "TOWNHOUSE", "CONDO", "MULTI_FAMILY"])

Start with:
{"locations":["Austin, TX"],"listingStatus":"forSale","maxItemsPerLocation":25,"minBeds":3,"maxPrice":750000}
```

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

- *"Find 40 single-family homes for sale under $600,000 in Austin, TX, compute `(rentZestimate * 12) / price` gross rental yield for each, and show the top 10 highest-yield listings."*
- *"Pull 30 recently sold homes in ZIP 78704 with `enrichDetails: true` and summarize median sold price per square foot and days on market."*
- *"Look up ZPID 89550912 and extract its MLS ID, HOA fee, listing brokerage, agent phone and recent price cuts."*

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

### 📋 Overview

Everything needed to turn Zillow city searches, ZIP code grids, custom map polygons and ZPID lists into clean 63-column real-estate datasets — with zero browser bloat and zero custom proxy setup.

| Property | Details |
|---|---|
| **Public data source** | Public Zillow search results & `homedetails` property pages (`zillow.com`) |
| **Authentication required** | None — zero Zillow login, cookies, API keys or user-supplied proxies |
| **Container footprint** | Lightweight `256 MB` HTTP runtime |
| **Output row types (`rowType`)** | `listing` (`$0.0025` search-level · `$0.0045` `property-detail` when enriched), `status` (`$0.00`) |
| **Deduplication & restart safety** | Deterministic `rowKey` (`listing:<zpid>`) — zero duplicate properties across overlapping ZIPs or restarts |
| **Execution modes** | Standard Batch Dataset runs + synchronous Standby HTTP API (`GET /`, `GET /health`, `POST /scrape`) |

**Why teams pick this Actor:**

- 📊 **Zestimate + Rent Zestimate + Tax Assessment included at search tier** — screen cap rates and equity spreads across hundreds of homes at `$0.0025` per property without needing detail-page requests.
- 📞 **Deep MLS & Agent Enrichment on demand** — turn on `enrichDetails: true` (or pass `propertyUrls`) for `mlsId`, `mlsName`, `agentPhone`, `monthlyHoaFee`, `yearBuilt`, `priceHistory` and `taxHistory`.
- 🏢 **Multi-unit rental intelligence** — captures `isBuilding`, `buildingName`, `minBaseRent`, `maxBaseRent` and available unit floorplan tiers (`units[]`) in `forRent` mode.
- 📉 **Price-cut & distress flags** — surfaces `priceChange`, `priceReductionText`, `datePriceChanged`, `isPreforeclosureAuction`, `isNonOwnerOccupied` and `daysOnZillow`.
- 💎 **Mutually exclusive PPE billing** — an enriched property is billed **only** `property-detail` (`$0.0045`), never `listing` + `property-detail` stacked together.

### ✨ Key Features

- 🗺️ **4 Input Entry Points in One Actor** — City/neighborhood names (`"Miami, FL"`), 5-digit ZIP codes (`"33139"`), custom filtered/polygon `zillow.com` `searchUrls`, and direct `homedetails` URLs or raw numeric ZPIDs (`propertyUrls`).
- 🏠 **For Sale, For Rent & Recently Sold** — Toggle `listingStatus` between `"forSale"`, `"forRent"` and `"sold"` comps.
- 💰 **Automated Valuation & Equity Signals** — Captures `price`, `zestimate`, `rentZestimate`, `taxAssessedValue`, `priceChange`, `datePriceChanged` and `dateSold`.
- 🧾 **MLS Attribution & Property History (`enrichDetails: true`)** — Extracts `mlsId`, `mlsName`, `brokerName`, `agentName`, `agentPhone`, `agentEmail` (when published), `yearBuilt`, `monthlyHoaFee`, `priceHistory[]`, `taxHistory[]` and `openHouseSchedule[]`.
- 🎯 **Granular Property Filters** — Filter results by `minPrice`, `maxPrice`, `minBeds`, `minBaths` and `homeTypes` (`SINGLE_FAMILY`, `CONDO`, `TOWNHOUSE`, `MULTI_FAMILY`, `LOT`, `MANUFACTURED`).
- 🖼️ **High-Resolution Media & 3D Tour Flags** — Includes `thumbnailUrl`, `photosCount`, high-resolution `photos[]` (`1536px`), `has3DModel`, `hasVideo` and `isShowcaseListing`.

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

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

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

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

```bash
curl -X POST "https://foxlabs--zillow-scraper.apify.actor/scrape?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"locations":[],"propertyUrls":["89550912"]}'
```

### 🚀 Getting Started (3 steps)

1. **Enter locations, map URLs or ZPIDs** — Type cities or 5-digit ZIP codes into **Locations** (`"Austin, TX"`, `"78701"`), paste custom map URLs into **Search URLs**, or paste ZPIDs into **Property URLs**.
2. **Choose listing status & detail depth** — Select `listingStatus` (`forSale`, `forRent`, `sold`), set price/bed/bath filters, and keep `enrichDetails: false` for fast Zestimate search scans or `true` for MLS/HOA/agent phone enrichment.
3. **Run & export** — Click **Start** and download your 63-column dataset as JSON, CSV, Excel, Parquet or XML.

### 📥 Input & Filters

```json
{
  "locations": ["Austin, TX", "78701"],
  "searchUrls": [],
  "propertyUrls": [],
  "listingStatus": "forSale",
  "maxItemsPerLocation": 40,
  "enrichDetails": false,
  "minPrice": 250000,
  "maxPrice": 950000,
  "minBeds": 3,
  "minBaths": 2,
  "homeTypes": ["SINGLE_FAMILY", "TOWNHOUSE"]
}
```

| Field | Type | Default | Description |
|---|---|---|---|
| `locations` | `array<string>` | `["Austin, TX"]` | US cities, neighborhoods, or 5-digit ZIP codes to search. |
| `searchUrls` | `array<string>` | `[]` | Direct `zillow.com` search URLs (including custom map polygons, school ratings or keyword filters). |
| `propertyUrls` | `array<string>` | `[]` | Direct Zillow `homedetails` URLs or raw numeric ZPIDs (`"89550912"`). Automatically enriches full property details. |
| `listingStatus` | `string` | `"forSale"` | Listing status: `"forSale"`, `"forRent"`, or `"sold"`. |
| `maxItemsPerLocation` | `integer` | `40` | Maximum properties collected per location or search URL (`1`–`820`). |
| `enrichDetails` | `boolean` | `false` | When `true`, fetches each property's detail page for `mlsId`, `agentPhone`, `monthlyHoaFee`, `yearBuilt`, `priceHistory` and `taxHistory`. |
| `minPrice` / `maxPrice` | `integer` | — | Optional minimum / maximum sale price or monthly rent in USD. |
| `minBeds` | `integer` | — | Optional minimum bedrooms count. |
| `minBaths` | `number` | — | Optional minimum bathrooms count (supports half-baths like `1.5` or `2.5`). |
| `homeTypes` | `array<string>` | `[]` | Optional filter (`SINGLE_FAMILY`, `CONDO`, `TOWNHOUSE`, `MULTI_FAMILY`, `APARTMENT_BUILDING`, `LOT`, `MANUFACTURED`). |
| `proxyConfiguration` | `object` | `{"useApifyProxy": true}` | Managed automatically on our side via Apify Proxy. |

**Copy-paste input recipes:**

- **Fast cap-rate & Zestimate screen across multiple ZIP codes (`enrichDetails: false`):**
  `{"locations":["78701","78702","78704"],"listingStatus":"forSale","maxItemsPerLocation":100,"enrichDetails":false,"homeTypes":["SINGLE_FAMILY"]}`
- **Recently sold comps with MLS ID, HOA & price/tax history (`enrichDetails: true`):**
  `{"locations":["Miami, FL"],"listingStatus":"sold","maxItemsPerLocation":25,"enrichDetails":true}`
- **Direct ZPID / `homedetails` enrichment lookup (`propertyUrls`):**
  `{"locations":[],"propertyUrls":["89550912","https://www.zillow.com/homedetails/360-Nueces-St-APT-1208-Austin-TX-78701/89550912_zpid/"]}`

### 📤 Output Schema & Real Sample Record

Every Dataset record carries `rowType` (`"listing"` or free diagnostic `"status"`), `detailsEnriched` (`false` for search-tier `listing`, `true` for `property-detail`), and deterministic `rowKey: "listing:<zpid>"`.

| Field Group | Fields (63 Columns Total) |
|---|---|
| **Identity & Status** | `rowKey`, `rowType`, `zpid`, `detailUrl`, `homeStatus` (`FOR_SALE`, `FOR_RENT`, `SOLD`), `statusText`, `marketingStatus`, `homeType`, `buildingName`, `isBuilding`, `detailsEnriched` |
| **Pricing & Valuations** | `price`, `priceFormatted`, `minBaseRent`, `maxBaseRent`, `currency`, `zestimate`, `rentZestimate`, `taxAssessedValue`, `priceChange`, `priceReductionText`, `datePriceChanged`, `dateSold`, `daysOnZillow` |
| **Dimensions & Specs** | `bedrooms`, `bathrooms`, `livingAreaSqft`, `lotAreaValue`, `lotAreaUnit`, `yearBuilt` *(detail)*, `monthlyHoaFee` *(detail)*, `availabilityCount`, `units[]` *(rental floorplans)* |
| **Address & Coordinates** | `address`, `streetAddress`, `city`, `state`, `zipcode`, `country`, `latitude`, `longitude` |
| **Brokerage, Agent & MLS** | `brokerName`, `agentName` *(detail)*, `agentPhone` *(detail)*, `agentEmail` *(detail)*, `mlsId` *(detail)*, `mlsName` *(detail)* |
| **Distress, Media & History** | `isZillowOwned`, `isShowcaseListing`, `isFeatured`, `isPreforeclosureAuction`, `isNonOwnerOccupied`, `has3DModel`, `hasVideo`, `thumbnailUrl`, `photosCount`, `photos[]`, `description` *(detail)*, `priceHistory[]` *(detail)*, `taxHistory[]` *(detail)*, `openHouseSchedule[]` *(detail)*, `scrapedAt` |

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

```json
{
  "rowType": "listing",
  "rowKey": "listing:89550912",
  "zpid": "89550912",
  "detailUrl": "https://www.zillow.com/homedetails/360-Nueces-St-APT-1208-Austin-TX-78701/89550912_zpid/",
  "homeStatus": "FOR_SALE",
  "statusText": "Active",
  "marketingStatus": "For Sale by Agent",
  "homeType": "CONDO",
  "buildingName": null,
  "isBuilding": false,
  "price": 380000,
  "priceFormatted": "$380,000",
  "minBaseRent": null,
  "maxBaseRent": null,
  "currency": "USD",
  "zestimate": null,
  "rentZestimate": null,
  "taxAssessedValue": 469332,
  "priceChange": -19000,
  "priceReductionText": "$19,000 (Oct 30)",
  "datePriceChanged": "2026-10-30",
  "dateSold": 1527897600000,
  "daysOnZillow": 127,
  "bedrooms": 1,
  "bathrooms": 1,
  "livingAreaSqft": 732,
  "lotAreaValue": 100.188,
  "lotAreaUnit": "Square Feet",
  "yearBuilt": 2008,
  "monthlyHoaFee": 710,
  "address": "360 Nueces St APT 1208, Austin, TX, 78701",
  "streetAddress": "360 Nueces St APT 1208",
  "city": "Austin",
  "state": "TX",
  "zipcode": "78701",
  "country": "USA",
  "latitude": 30.26751,
  "longitude": -97.749596,
  "brokerName": "Compass RE Texas, LLC",
  "agentName": null,
  "agentPhone": "(512) 627-4688",
  "agentEmail": null,
  "mlsId": "8592109",
  "mlsName": "Unlock MLS",
  "isZillowOwned": false,
  "isShowcaseListing": true,
  "isFeatured": false,
  "isPreforeclosureAuction": false,
  "isNonOwnerOccupied": true,
  "has3DModel": true,
  "hasVideo": false,
  "thumbnailUrl": "https://photos.zillowstatic.com/fp/190148ebb6253d3555f6496010add794-p_h.jpg",
  "photosCount": 27,
  "detailsEnriched": true,
  "scrapedAt": "2026-11-14T11:30:12.000Z"
}
```

Every completed 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 (`GkSn7nr212j4BJOEA`, `lUlFuBvcssi3hgqCs`, `oPgh80EcQH8KNhXrB`) and pre-publish live billing verification (`KbxqYWwUdcCbxFGcv` on 2026-11-14):

- **100% ZPID uniqueness:** Deduplicated by `listing:<zpid>` across overlapping cities, ZIP codes and map URLs (`0` duplicate properties).
- **Rich search-tier payload:** Search cards alone deliver up to ~41 properties per page with `price`, `zestimate`, `rentZestimate`, `taxAssessedValue`, `priceChange`, `daysOnZillow`, specs, coordinates and `brokerName`.
- **Verified two-tier PPE accuracy:** Verified across three separate platform billing runs (`listing`-only search, `property-detail` enriched lookup `KbxqYWwUdcCbxFGcv`, and empty-input `status` check) with `100%` match on settled `chargedEventCounts`.

### ⏱️ Performance — Measured

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

- **~41 listings per search request:** With `enrichDetails: false`, fetching 40 properties requires just one lightweight search request, completing in **4 to 9 seconds**.
- **Low-memory container:** Runs cleanly inside `256 MB` RAM with zero Playwright/Chromium memory spikes.
- **Migration idempotency:** Container restarts automatically skip any `listing:<zpid>` already written to the run's Dataset.

### 💼 Use Cases

1. **Automated Cap-Rate & Gross Rental Yield Screening (`forSale` + `rentZestimate`)**
   - *Input:* `{"locations":["78701","78702","78704","78745"],"listingStatus":"forSale","maxItemsPerLocation":100,"enrichDetails":false,"homeTypes":["SINGLE_FAMILY","MULTI_FAMILY"]}`
   - *Output:* Active homes with `price`, `zestimate`, `rentZestimate`, `taxAssessedValue` and `daysOnZillow`.
   - *Business action:* Flag properties trading below `zestimate` where `(rentZestimate * 12) / price` exceeds your target yield threshold.

2. **Motivated Seller & Price-Cut Distress Tracking**
   - *Input:* `{"locations":["Phoenix, AZ","Tampa, FL"],"listingStatus":"forSale","maxItemsPerLocation":120,"enrichDetails":true}`
   - *Output:* Properties showing `priceChange < 0`, `daysOnZillow > 90`, `isNonOwnerOccupied`, `isPreforeclosureAuction`, `agentPhone` and `mlsId`.
   - *Business action:* Route stale or price-reduced listings with direct listing-office phone numbers to acquisitions teams daily.

3. **Sold Comps & Appraisal Modeling (`listingStatus: "sold"`)**
   - *Input:* `{"locations":["78704"],"listingStatus":"sold","maxItemsPerLocation":80,"enrichDetails":true}`
   - *Output:* Realized sold prices, `dateSold`, `livingAreaSqft`, `lotAreaValue`, `yearBuilt`, `monthlyHoaFee` and `taxHistory`.
   - *Business action:* Build hyper-local price-per-sqft comp tables for underwriting flips, new construction or property tax appeals.

4. **Multi-Family & Apartment Rent Benchmarking (`listingStatus: "forRent"`)**
   - *Input:* `{"locations":["Austin, TX"],"listingStatus":"forRent","maxItemsPerLocation":60,"enrichDetails":false}`
   - *Output:* Single-family rentals and apartment buildings (`isBuilding`, `buildingName`, `minBaseRent`, `maxBaseRent`, `units[]`).
   - *Business action:* Track competing apartment community rent concessions and bedroom-tier pricing weekly.

### 🔗 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/zillow-scraper').call({
    locations: ['Austin, TX'],
    listingStatus: 'forSale',
    maxItemsPerLocation: 40,
    enrichDetails: false,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Fetched ${items.length} Zillow 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/zillow-scraper").call(
    run_input={
        "locations": ["Austin, TX"],
        "listingStatus": "forSale",
        "maxItemsPerLocation": 40,
        "enrichDetails": False,
    }
)

for item in client.dataset(run.default_dataset_id).iterate_items():
    if item["rowType"] == "listing":
        print(item["zpid"], item["priceFormatted"], item["zestimate"], item["address"])
```

*(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

- **Daily acquisitions pipeline (n8n / Make / Zapier):** Schedule daily ZIP-code runs → filter `priceChange < 0` or `price < zestimate * 0.9` → push leads into Airtable, Podio, HubSpot or Follow Up Boss.
- **Clay ZPID enrichment:** POST `{"locations":[],"propertyUrls":["{{zpid}}"]}` to `https://foxlabs--zillow-scraper.apify.actor/scrape` to enrich property addresses or ZPIDs with MLS ID, HOA fees and agent phone numbers in real time.

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

Fair, mutually exclusive **Pay-Per-Event (PPE)** billing — pay search-tier pricing for fast market scans and detail-tier pricing only when you request deep property enrichment:

| Event Name | Trigger | Price per Item | Price per 1,000 |
|---|---|---|---|
| `listing` | Once per unique search-level property (`detailsEnriched: false`) | **$0.0025** | **$2.50 / 1,000** |
| `property-detail` | Once per unique deep-enriched property (`enrichDetails: true` or `propertyUrls`) | **$0.0045** | **$4.50 / 1,000** |
| `status` *(diagnostic)* | Empty input, invalid URL, or zero-match filter note | **$0.00 (Free)** | **$0.00** |

**Worked cost examples:**

- **200 homes for sale with Zestimate & Rent Zestimate (`enrichDetails: false`):** `200 × $0.0025` = **$0.50**
- **100 deep-enriched properties with MLS ID, HOA & agent phone (`enrichDetails: true`):** `100 × $0.0045` = **$0.45** *(replaces `listing` — never double-charged!)*
- **1,000 search-tier properties across 10 ZIP codes:** `1,000 × $0.0025` = **$2.50**

**Billing guarantees:**

- **Never billed twice for the same property:** An enriched property emits `property-detail` (`$0.0045`) **instead of** `listing` (`$0.0025`), and overlapping ZIP searches deduplicate by `zpid`.
- **Proxy handling is included:** Anti-bot session rotation is covered inside the per-event price above — zero external proxy bills.
- **Exact spend cap support:** Configure **Maximum cost per run** in Apify options; `ChargingManager` enforces your ceiling cleanly. *(Note: if Apify applies its platform `apify-actor-start` fee on your plan, that start event applies when a run starts, including runs that return zero billable rows.)*

### ❓ Frequently Asked Questions (FAQ)

#### Do I need a Zillow account, API key, cookies, or custom residential proxies?

No. Zillow's official Bridge/Zestimate APIs require institutional partner approval and strict display restrictions, whereas this Actor runs 100% keylessly on our infrastructure. Anti-bot handling and proxy rotation are managed automatically inside the Actor with zero credentials or external proxy keys required from you.

#### When should I keep `enrichDetails: false` vs. turning on `enrichDetails: true`?

Keep `enrichDetails: false` (default) for fast, low-cost (`$2.50 / 1K`) market scans: Zillow's search payload already includes `price`, `zestimate`, `rentZestimate`, `taxAssessedValue`, `priceChange`, `daysOnZillow`, `bedrooms`, `bathrooms`, `livingAreaSqft`, `latitude`, `longitude`, `brokerName` and photos (~41 homes per request). Enable `enrichDetails: true` (`$4.50 / 1K`) when you also need `yearBuilt`, `monthlyHoaFee`, `mlsId`, `mlsName`, `agentPhone`, `priceHistory`, `taxHistory` and full `description`.

#### Why does Zillow cap individual search queries at ~820 listings, and how do I scrape a whole metro?

Zillow paginates any single search result list up to 20 pages (~41 properties per page = ~820 listings). To collect all 5,000–20,000 active listings across a major metro like Houston, Phoenix or Atlanta, pass a list of 5-digit **ZIP codes** in `locations` (e.g. `["78701", "78702", "78703", "78704", ...]`) or split by `minPrice` / `maxPrice` brackets; deterministic `listing:<zpid>` deduplication guarantees overlapping homes are never duplicated or billed twice.

#### Can I scrape custom map-bounding-box, polygon, or school-district searches from Zillow?

Yes. Configure any custom drawn map boundary, zoom rectangle, keyword filter (`"pool"`, `"adu"`),HOA cap or school-rating filter directly in your browser on `zillow.com`, copy the resulting URL from your address bar, and paste it into `searchUrls` (setting `"locations": []` if you want only that URL).

#### How are multi-unit apartment buildings represented in `forRent` mode?

When `listingStatus` is `"forRent"`, Zillow returns both individual single-family/condo rentals (`isBuilding: false`) and multi-family apartment communities (`isBuilding: true`). For apartment communities, `buildingName` carries the complex name, `minBaseRent` and `maxBaseRent` show the rent range, and the `units[]` array breaks down available floorplan tiers (`beds`, `price`, `priceText`).

#### How can I calculate instant cap-rate or gross rental yield from the output?

Every `forSale` property where Zillow publishes automated valuations carries both `price` (and `zestimate`) alongside `rentZestimate` (estimated monthly market rent). Dividing `(rentZestimate * 12)` by `price` gives an immediate gross rental yield percentage, and when `enrichDetails: true` is active you can also subtract `monthlyHoaFee * 12` and latest `taxHistory` taxes for net operating income (NOI) screening.

#### Why is `zestimate` or `agentName` `null` on certain properties?

Condos in non-disclosure states (such as Texas, where sale prices are not public county record), brand-new construction lots, or off-market properties sometimes have `zestimate: null` on Zillow itself; similarly, some MLS feeds display the brokerage office phone (`agentPhone` + `brokerName`) without an individual agent name. Unknown values are always emitted as `null` — never fake `0`s.

#### Can I look up specific properties using only raw numeric ZPIDs?

Yes. Clear `locations` (`"locations": []`) and pass raw ZPIDs (for example `["89550912", "64625418"]`) or full `https://www.zillow.com/homedetails/...` links inside `propertyUrls`. Direct `propertyUrls` lookups automatically run full detail enrichment (`property-detail`).

#### What happens if a ZIP code or price filter matches zero properties?

Following clean status handling, the Actor finishes with `SUCCEEDED` and writes one free diagnostic row (`rowType: "status"`) explaining why zero properties matched your filters, without triggering any `listing` or `property-detail` charges.

#### Can I cross-reference Zillow listings with Redfin MLS data?

Yes. Both `foxlabs/zillow-scraper` (with `enrichDetails: true`) and [Redfin Real Estate Scraper](https://apify.com/foxlabs/redfin-scraper) extract `mlsId`, `streetAddress`, `zipcode`, `latitude` and `longitude`, allowing you to join records cleanly on `mlsId` or normalized address.

#### Does this Actor work with MCP AI agents and synchronous Standby HTTP calls?

Yes. Point Claude, Cursor or ChatGPT at `https://mcp.apify.com?tools=foxlabs/zillow-scraper` for conversational property screening, or send a JSON body to `POST https://foxlabs--zillow-scraper.apify.actor/scrape` in Standby mode for real-time CRM/Clay lookups.

#### What happens if Apify restarts or migrates my container mid-run?

At startup, the Actor inspects the active run's default Dataset, loads all previously emitted `listing:<zpid>` keys into memory, and skips any property already delivered prior to a container restart or server migration — guaranteeing 100% Dataset uniqueness and zero duplicate per-event charges.

### 🐛 Troubleshooting

- **Dataset contains only a `rowType: "status"` row with `"EMPTY_INPUT"`:** `locations`, `searchUrls`, and `propertyUrls` were all empty. Add at least one city/ZIP, search URL, or ZPID.
- **`mlsId`, `monthlyHoaFee`, and `agentPhone` are `null` on search results:** You ran with `enrichDetails: false` (default fast search mode). Set `enrichDetails: true` or pass target ZPIDs in `propertyUrls` to fetch detail-page MLS & HOA fields.
- **Default `"Austin, TX"` ran alongside your `searchUrls` or `propertyUrls`:** Clear `locations` in the Console UI or pass `"locations": []` in your API payload when using `searchUrls` or `propertyUrls` alone.
- **City search stopped around ~800 homes:** Zillow caps single search queries at 20 pages; pass 5-digit ZIP codes in `locations` to sweep thousands of properties across a metro.

### 🚧 What It Does Not Do

- Does **not** scrape properties outside Zillow's US/Canadian footprint.
- Does **not** unlock private homeowner phone numbers/emails for off-market un-listed homes (extracts public MLS brokerage & listing-agent attribution contacts published on active/sold listings).
- Does **not** fabricate `0` values when Zillow withholds a Zestimate or HOA fee (`null` is returned honestly).

### ⚠️ Trademark Notice

This Actor is an independent data-collection tool built by **foXLabs** and is not affiliated with, endorsed by, or sponsored by Zillow Group, Inc. "Zillow" and "Zestimate" are registered trademarks of Zillow Group, Inc., used strictly to identify publicly accessible source data.

### ⚖️ Is It Legal to Scrape Public Zillow Listings?

This Actor accesses only publicly visible real-estate listings, public property records and MLS attribution details served to unauthenticated web visitors — with zero account login or paywall bypass. Listing-agent contact details may constitute personal or business contact data under CCPA and state regulations; ensure your outreach and storage comply with applicable laws.

### 🤝 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)

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

#### 0.1.2 (2026-11-13)

- Split Pay-Per-Event billing into `listing` (`$0.0025` search-level properties) and `property-detail` (`$0.0045` deep-enriched properties, mutually exclusive per record).

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

- Initial release of `foxlabs/zillow-scraper` supporting `forSale`, `forRent` and `sold` listings across cities, ZIP codes, custom `searchUrls` and `propertyUrls`, with Batch + Standby HTTP support.

# Changelog

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

# Actor input Schema

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

US cities, neighborhoods, or 5-digit ZIP codes to search on Zillow (e.g. 'Austin, TX', 'Miami, FL', '78701', '90210').

## `searchUrls` (type: `array`):

Optional full Zillow search URLs (including custom map bounds or filter URLs copied from zillow.com).

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

Optional Zillow homedetails URLs (https://www.zillow.com/homedetails/.../123456_zpid/) or numeric ZPIDs for deep single-property extraction.

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

Property listing status to scrape for `locations`.

## `maxItemsPerLocation` (type: `integer`):

Maximum properties to extract per location or search URL (Zillow returns ~41 listings per page, up to 20 pages = ~820 per search).

## `enrichDetails` (type: `boolean`):

When enabled, fetches each listing's full property detail page to add yearBuilt, monthlyHoaFee, mlsId, mlsName, agentPhone/attributionContact, brokerageName, priceHistory, taxHistory, and full description.

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

Optional minimum price (or monthly rent) filter.

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

Optional maximum price (or monthly rent) filter.

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

Optional minimum number of bedrooms.

## `minBaths` (type: `number`):

Optional minimum number of bathrooms.

## `homeTypes` (type: `array`):

Optional filter by Zillow homeType values (e.g. SINGLE_FAMILY, CONDO, TOWNHOUSE, MULTI_FAMILY, APARTMENT, LOT, MANUFACTURED). Leave empty for all types.

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

Apify Proxy settings. Automatically uses Apify Unblocker for Zillow anti-bot bypass with zero user keys or cookies.

## Actor input object example

```json
{
  "locations": [
    "Austin, TX"
  ],
  "searchUrls": [],
  "propertyUrls": [],
  "listingStatus": "forSale",
  "maxItemsPerLocation": 40,
  "enrichDetails": false,
  "homeTypes": [],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (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"
    ],
    "maxItemsPerLocation": 40
};

// Run the Actor and wait for it to finish
const run = await client.actor("foxlabs/zillow-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"],
    "maxItemsPerLocation": 40,
}

# Run the Actor and wait for it to finish
run = client.actor("foxlabs/zillow-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"
  ],
  "maxItemsPerLocation": 40
}' |
apify call foxlabs/zillow-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,foxlabs/zillow-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/0oerEDQVZSQIpC3zT/builds/zrfPhIBhC9TcI41Gu/openapi.json
