# Zillow ZIP Code Scraper – Prices & Inventory (`lukehunter/zillow-zip-scraper`) Actor

Scrape Zillow property listings from one or more US ZIP codes. Export asking prices, price changes, days on Zillow, beds, baths, square footage, broker, coordinates, and inventory counts. Simple ZIP input, predictable limits, and clean price and location views.

- **URL**: https://apify.com/lukehunter/zillow-zip-scraper.md
- **Developed by:** [Luke Hunter](https://apify.com/lukehunter) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$2.00 / 1,000 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

## Zillow ZIP Code Scraper — Prices, Listings & Inventory

Scrape **Zillow listings by ZIP code** and turn Zillow search results into clean, structured property data. Enter one or more US ZIP codes and get asking prices, price changes, days on Zillow, beds, baths, square footage, brokerage, coordinates, listing URLs, and Zillow's own reported inventory count.

Built for people who want a **simple Zillow ZIP scraper** rather than a large configuration screen: choose ZIP codes, set a hard result limit, and run.

**[Try the Zillow ZIP Code Scraper on Apify](https://apify.com/lukehunter/zillow-zip-scraper)**

#### Popular ready-to-run examples

- [Get Zillow Listings for Any ZIP Code](https://apify.com/lukehunter/zillow-zip-scraper/examples/zillow-listings-by-zip)
- [Compare Zillow Prices Across ZIP Codes](https://apify.com/lukehunter/zillow-zip-scraper/examples/compare-zillow-prices-by-zip)

### Why use this Zillow ZIP scraper?

| Need | What this Actor gives you |
|---|---|
| Zillow listings by ZIP code | Enter 1–20 ZIP codes or paste Zillow for-sale ZIP URLs |
| Price research | Numeric asking price plus Zillow's displayed price text |
| Price-cut tracking | `priceChange`, `datePriceChanged`, and `daysOnZillow` |
| Inventory research | Zillow's own `zipTotalResultCount` on every row |
| Property comparison | Beds, baths, living area, lot size, home type, tax assessment |
| Mapping | Latitude, longitude, image URL, and listing URL |
| Predictable spend | `maxItems` is a hard cap on delivered listings and therefore on cost |
| Clean exports | Flat rows ready for CSV, Excel, JSON, databases, or the Apify API |

The Actor is intentionally focused on **for-sale ZIP-code research**. That makes the input simple and keeps the output useful for repeatable market analysis.

### What can you do with Zillow listing data?

#### Compare property prices across ZIP codes

Run several ZIP codes together and compare asking prices, beds, baths, square footage, home type, brokerages, and inventory. The `zipCode` field stays attached to every row, so side-by-side analysis is straightforward.

#### Track Zillow price cuts

Use `priceChange` to find reduced listings and `datePriceChanged` to see when the latest change happened. Negative values in `priceChange` are price cuts.

#### Monitor days on market and inventory

Combine `daysOnZillow` with `zipTotalResultCount` to watch how a ZIP's active inventory and listing age change over time.

#### Build property-research datasets

Schedule repeat runs in Apify and export each run to CSV, Excel, JSON, a database, or another workflow through the Apify API and integrations.

#### Get a per-ZIP market snapshot for free

Every run also writes a **ZIP market snapshot** — one summary row per ZIP with median asking price, median price per square foot, median days on market, and the price-cut count/rate — built from the same listings you already scraped. It lands in its own dataset (open the **marketSnapshots** view under the run's Storage tab, or fetch it via the Apify API) and does not count toward your billed listings.

### How to scrape Zillow by ZIP code

1. Enter one or more five-digit US ZIP codes, for example `90210` or `10001`.
2. Set **Maximum listings**. This is your hard result and cost cap.
3. Click **Start**.
4. Open the **Listings**, **Prices only**, **Locations**, or **All fields** dataset view.
5. Export the data as CSV, Excel, JSON, or access it programmatically.

You can also paste a Zillow for-sale URL such as:

```text
https://www.zillow.com/homes/for_sale/90210/
```

The Actor extracts the ZIP code automatically.

### Input

```json
{
  "zipCodes": ["90210", "10001"],
  "maxItems": 100,
  "maxPagesPerZip": 20
}
```

| Field | Type | Default | Description |
|---|---|---:|---|
| `zipCodes` | string\[] | required | 1–20 US ZIP codes. Zillow for-sale ZIP URLs are also accepted. |
| `maxItems` | integer | 100 | 1–5000. Hard cap on listings delivered across the whole run. |
| `maxPagesPerZip` | integer | 20 | 1–20. Safety cap on Zillow search-result pages fetched per ZIP. |

For most users, the only settings that matter are **ZIP codes** and **Maximum listings**.

### Zillow data fields

| Category | Fields |
|---|---|
| Identity | `zpid`, `zipCode` |
| Address | `address`, `addressStreet`, `addressCity`, `addressState`, `addressZipcode` |
| Price | `price`, `priceDisplay`, `currencySymbol` |
| Property | `beds`, `baths`, `area`, `lotAreaValue`, `lotAreaUnit`, `homeType`, `statusType` |
| Market signals | `daysOnZillow`, `priceChange`, `datePriceChanged`, `taxAssessedValue` |
| Listing | `brokerName`, `imageUrl`, `detailUrl`, `isZillowOwned` |
| Location | `latitude`, `longitude` |
| Inventory | `zipTotalResultCount` |
| Freshness | `scrapedAt` |

Missing values are returned as `null`. The Actor does not invent or infer missing listing data.

### Zillow output example

```json
{
  "zpid": "20533678",
  "zipCode": "90210",
  "address": "3084 Franklin Canyon Dr, Beverly Hills, CA 90210",
  "price": 3895000,
  "priceDisplay": "$3,895,000",
  "beds": 6,
  "baths": 5,
  "area": 4073,
  "homeType": "SINGLE_FAMILY",
  "daysOnZillow": 125,
  "priceChange": -300000,
  "taxAssessedValue": 4052357,
  "brokerName": "Keller Williams Beverly Hills",
  "latitude": 34.128544,
  "longitude": -118.40726,
  "detailUrl": "https://www.zillow.com/homedetails/3084-Franklin-Canyon-Dr-Beverly-Hills-CA-90210/20533678_zpid/",
  "zipTotalResultCount": 263,
  "scrapedAt": "2026-09-21T00:00:00.000Z"
}
```

### Use it as a Zillow listings API

The Actor can be called from any application through the Apify API. No separate Zillow API key is required.

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("lukehunter/zillow-zip-scraper").call(
    run_input={
        "zipCodes": ["90210", "10001"],
        "maxItems": 100,
        "maxPagesPerZip": 20,
    }
)

for listing in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(listing["zipCode"], listing["address"], listing["price"])
```

Use Apify schedules for recurring market snapshots, and webhooks or integrations to send completed datasets into the rest of your workflow.

### Pricing and cost control

This Actor uses **pay per delivered listing** pricing.

**Current configured rate: $0.002 per listing delivered.** Check the Apify **Pricing** tab for the latest published rate.

| Listings delivered | Cost at $0.002/listing |
|---:|---:|
| 100 | $0.20 |
| 1,000 | $2.00 |
| 5,000 | $10.00 |

There is no charge for merely starting a run. `maxItems` gives you a clear upper bound on the number of billable listings.

Listings are de-duplicated by `zpid` within a run.

### Reliability and data quality

The Actor is designed to fail visibly rather than quietly return misleading data.

- If Zillow blocks the request before any listings are found, the run fails instead of returning an apparently successful empty dataset.
- Built-in quality checks detect malformed or degraded Zillow responses and reject pages that no longer look like normal listing data instead of quietly treating them as valid.
- Individual listings can still have fields that Zillow does not provide. Missing values are returned as `null` rather than guessed.
- `zipTotalResultCount` gives you Zillow's own reported search total so you can compare it with the number of rows your limits allowed the run to deliver.
- Missing values stay `null`; they are not guessed.
- Duplicate `zpid` values are removed within the run.

### Important limitations

- **For-sale ZIP searches only.** This Actor does not currently scrape rentals, sold listings, city searches, school districts, or custom map areas.
- **No Zestimate field.** It reads the fields available from the ZIP search results used by this Actor and does not open every property detail page.
- **Up to 20 ZIP codes per run.** Split larger jobs across multiple runs.
- `maxItems` and `maxPagesPerZip` can intentionally stop a run before every Zillow result is collected.
- Zillow inventory and prices change continuously. Every row is a point-in-time observation identified by `scrapedAt`.
- Individual agent names, phone numbers, and email addresses are not collected. `brokerName` is the brokerage company when Zillow publishes it.
- The Actor does not use CAPTCHA bypass, proxy rotation, credential capture, or impersonation.
- This is an independent tool and is **not affiliated with, endorsed by, or connected to Zillow Group, Inc.** Zillow is a trademark of its owner. You are responsible for using the data in accordance with applicable terms and laws.

### FAQ

#### Can I scrape Zillow by ZIP code?

Yes. Enter one or more five-digit US ZIP codes and the Actor returns the for-sale listings Zillow publishes for those ZIP searches.

#### Can I export Zillow listings to CSV or Excel?

Yes. Every run writes a standard Apify dataset that can be downloaded as CSV, Excel, JSON, and other supported formats.

#### Can I compare Zillow prices across multiple ZIP codes?

Yes. Put multiple ZIP codes in one run. Each result includes its source `zipCode`, making it easy to group or compare markets.

#### Can I track Zillow price reductions?

Yes. `priceChange` contains Zillow's most recent signed price change when available. Negative values indicate a reduction.

#### Can I schedule Zillow data collection?

Yes. Use Apify schedules to run the same input automatically, then compare datasets over time.

#### Does this scrape Zillow rentals or sold properties?

No. This Actor is deliberately focused on for-sale listings by ZIP code.

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

No separate Zillow API key or Zillow login is required.

#### How do I control the cost?

Set `maxItems`. It is a hard cap on the number of listings delivered across the run and therefore on billable results.

# Actor input Schema

## `zipCodes` (type: `array`):

US ZIP codes to search, five digits each, e.g. "90210". A pasted https://www.zillow.com/homes/for\_sale/90210/ URL is also accepted and reduced to its ZIP. Maximum 20 ZIP codes per run.

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

Hard cap on the number of listings delivered across all ZIP codes. You are charged per delivered listing, so this is your cost cap.

## `maxPagesPerZip` (type: `integer`):

Safety cap on how many search result pages are fetched per ZIP code (each page holds roughly 41 listings). Lower it to sample a busy ZIP faster. Zillow's own page count for the ZIP stops the run earlier whenever it is smaller.

## Actor input object example

```json
{
  "zipCodes": [
    "90210",
    "10001"
  ],
  "maxItems": 100,
  "maxPagesPerZip": 20
}
```

# Actor output Schema

## `listings` (type: `string`):

No description

## `marketSnapshots` (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 = {
    "zipCodes": [
        "90210",
        "10001"
    ],
    "maxItems": 100,
    "maxPagesPerZip": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("lukehunter/zillow-zip-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 = {
    "zipCodes": [
        "90210",
        "10001",
    ],
    "maxItems": 100,
    "maxPagesPerZip": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("lukehunter/zillow-zip-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 '{
  "zipCodes": [
    "90210",
    "10001"
  ],
  "maxItems": 100,
  "maxPagesPerZip": 20
}' |
apify call lukehunter/zillow-zip-scraper --silent --output-dataset

```

## MCP server setup

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