# Zillow ZIP Code Scraper | $0.50/1K | Bulk Search (`x_guru/zillow-zip-code-scraper`) Actor

Search Zillow homes for sale, rent or recently sold across multiple ZIP codes. Set per-ZIP quotas, continue unfinished exports and download CSV or JSON.

- **URL**: https://apify.com/x_guru/zillow-zip-code-scraper.md
- **Developed by:** [Hundevmode Labs](https://apify.com/x_guru) (community)
- **Categories:** Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 paid plans: saved properties

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

Search Zillow properties across multiple US ZIP codes with a separate quota for each ZIP. Export homes for sale, rental listings or recently sold homes as a flat CSV or JSON dataset.

**Result pricing:** $0.50/1,000 property rows on paid Apify plans; $1.00/1,000 on Free. Automatic source access recovery is included. No Zillow login or additional service is required.

### What you can collect

- Build a property export for a list of ZIP codes without configuring each search separately.
- Control both the total batch size and the number of unique properties collected for each ZIP.
- Keep ZIP codes such as `02108` intact by entering them as five-character strings.
- Inspect coverage for each ZIP and continue unfinished work without saving the same property twice along the same continuation chain.

### How to use Zillow ZIP Code Scraper

1. Enter your five-digit ZIP codes and set a per-ZIP quota.
2. Set **Maximum results this run** and optional filters.
3. Set a spending limit in Apify run options, then click **Start**.
4. Open the results, review the coverage summary, and download CSV, Excel or JSON.

#### Quick-start input

```json
{
  "zipCodes": [
    "78704",
    "78745"
  ],
  "maxResultsPerZip": 20,
  "maxResults": 40
}
```

This example is a starting point; replace its sources with your own. ZIP codes must remain five-character strings.

### Input options

| Input | Purpose | Default |
| --- | --- | --- |
| `zipCodes` | Required: up to 100 five-digit US ZIP strings, e.g. `["78704", "02108"]`. | Your ZIP list |
| `listingType` | `sale`, `rent` or `sold`. | `sale` |
| `maxResultsPerZip` | Unique rows per ZIP across this collection and all continuation batches. | 100 |
| `maxResults` | Maximum new rows saved in this run. | 100 |
| `Price and size filters` | USD price; monthly USD for rent; bedrooms, bathrooms and living area in square feet. | Unset |
| `resumeFromRunId` | Continue the latest finished batch with the same query. | Unset |
| `advanced` | Optional request, time, download and retry ceilings. | 300 requests, 600 seconds, 50 MB on paid plans |

Manually supplied source lists accept up to 100 entries. You may combine supported input methods; earlier sources can consume the shared result limit before later ones are reached.

### Output: CSV and JSON fields

Each result is one property record. Missing source fields are `null`. The default table uses readable column labels while exports keep stable field names.

| Data | Columns |
| --- | --- |
| Property | `recordId`, `zpid`, `url`, `status` |
| Search attribution | `searchedZipcode` identifies the ZIP search that first saved the property. |
| Location | `address`, `city`, `state`, `zipcode`, `latitude`, `longitude` |
| Price and size | `price`, `bedrooms`, `bathrooms`, `livingArea` |

Nested attributes, where present, are serialized as JSON strings so CSV remains flat. Errors are not mixed into paid dataset rows. **Coverage and limits** (`RUN_SUMMARY`), **Source issues** (`ERRORS`) and **Continue collection** (`PAGINATION`) are separate run output links. `REQUEST_METRICS` and `CHECKPOINT` are available in key-value storage.

Pagination and bounded map splitting handle larger ZIP searches. A reached per-ZIP quota is intentionally limited coverage, not a full ZIP export.

### 💳 Pricing and spending limits

| Apify account | Price per 1,000 property rows | Collection allowance |
| --- | ---: | --- |
| Paid plan | $0.50 | Requested count, source availability and run limits |
| Free | $1.00 | 100 rows across one collection and its continuation chain |

Only saved result rows are charged as results. Failed requests and diagnostic records are kept separately.

The platform actor-start event is **$0.00005 per GB of allocated memory, with a minimum of one event**. A 256 MB run therefore pays $0.00005 to start. Each new continuation run and each Resurrect may incur another start event. There are no separate enrichment or access-recovery add-ons. Platform usage is included in the PPE policy; no extra dataset-item event is configured.

Apify authenticates the account plan automatically; input cannot select the cheaper rate. **Free is an Apify account plan, not zero-price output:** results consume available account credits. Free runs also stop at 40 requests, 180 seconds or 10 MB of compressed downloaded responses. These ceilings cannot be raised in the input. Downloads are checked between responses, so one response can exceed the remaining traffic allowance. Independent fresh collections have independent allowances; this is not an account-wide monthly quota.

Minimum permitted Max total charge: $0.00105, covering the start event and at least one result at the highest Free rate. This is a minimum budget setting, not a minimum bill: only the start and saved result events are charged. The same result rates apply to all paid Apify plans.

Set **Max total charge** in Apify run options, or `maxTotalChargeUsd` through the API. The requested result count is not a dollar budget. The SDK checks remaining run budget before saving charged rows, and Apify can stop a run when its budget is reached. Paid-account credit balance and overage settings are separate from this run limit. Rates are configured for the current private release; the actor has not been published in Apify Store.

### 🔁 Continue after a limit or source error

1. Keep the saved dataset and wait until the previous run has finished.
2. Open **Continue collection** (`PAGINATION`) in the run output.
3. If `hasMore=true`, copy the **full `nextInput`** into a new run of this same actor. It includes `resumeFromRunId`.
4. Keep the query, filters and any monitor baseline unchanged. You may change `maxResults` and advanced collection limits; ZIP per-code quotas stay unchanged.
5. Set a new spending budget. Download this batch’s dataset and combine it with your earlier batches.

The next batch contains newly saved rows only. Earlier rows are skipped and are not charged again along that continuation chain. Use the **latest** finished batch: branching twice from an older run can create overlapping datasets. The previous run must belong to your own account and this actor, and its storage must remain available.

| Stop or issue | Next step |
| --- | --- |
| Result, request, time or download ceiling | Use `PAGINATION.nextInput` if `hasMore=true`; adjust the next batch’s limits. |
| Temporary restriction or HTTP 403 | Bounded automatic recovery has already been attempted. Retain progress and try the continuation later. A fresh run does not guarantee that access is restored. |
| Spending limit | Keep saved rows and resume with a new per-run budget. The budget is not shared across the chain. |
| Free collection allowance | Continuation and Resurrect do not replenish it. Upgrade the account before collecting beyond the Free allowance. |
| Invalid input or changed query | Correct the input; keep the original query for continuation or start a separate collection. |
| Missing checkpoint after a hard stop | A usable continuation may be unavailable. Keep any saved rows; a fresh collection cannot guarantee deduplication against that dataset. |

Apify **Resurrect** restarts the same run and storage. `resumeFromRunId` creates a separate batch and dataset. Do not use both methods simultaneously. A requested count is a ceiling, not a promise that Zillow has that many accessible records.

### Run through the Apify API

The same JSON input works in Apify Console and through the [Apify Actor API](https://docs.apify.com/api/v2/actor-runs). Start a run, wait for it to finish, then export its dataset as JSON, CSV or Excel. Use the actor ID from its Console page and your own Apify API token; no Zillow API key is required. Pass `maxTotalChargeUsd` as a run option rather than an input field. Never put API tokens in the input.

### Choose the right Zillow actor

Choose this actor for a list of ZIP territories with independent quotas and coverage. Use **Zillow Scraper** for a general city/search-URL workflow, **Zillow Rental Scraper** for available apartment units, or **Zillow Property Details Scraper** when you already have property URLs or ZPIDs.

### Frequently asked questions

#### How is this different from a city search?

The ZIP scraper tracks a separate quota and coverage status for each ZIP. Use a general Zillow search scraper for a single city or a filtered Zillow search URL.

#### Does the ZIP quota mean all homes were collected?

No. A quota is a collection limit. Zillow pagination, source restrictions and runtime limits can leave a ZIP partially collected. Check `RUN_SUMMARY.targets` and `zipCounts`.

#### What happens if searches overlap?

Properties are deduplicated across the collection. `searchedZipcode` is the first search that emitted the property; the property’s own address ZIP is `zipcode`. Overlap can prevent a later ZIP from filling its quota.

#### Is this an official Zillow API?

No. This is an independent actor callable through the Apify API. It is not affiliated with, sponsored or endorsed by Zillow. Source fields, layouts and access can change; complete extraction and uninterrupted access are not guaranteed.

# Actor input Schema

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

Required. Up to 100 five-digit US ZIP codes, one per entry. Keep leading zeros, e.g. 02108. Duplicate ZIPs are searched once.

## `listingType` (type: `string`):

Keep this selection unchanged when continuing a collection.

## `maxResultsPerZip` (type: `integer`):

Quota per ZIP across this collection and its continuation runs.

## `maxResults` (type: `integer`):

Maximum NEW property rows saved in this run (1–100,000). Free: 100 rows per collection across continuation batches. Source availability, time and Max total charge can stop earlier.

## `minPrice` (type: `number`):

Optional Zillow search filter. Prices are USD; rental prices are monthly. Living area is in square feet.

## `maxPrice` (type: `number`):

Optional Zillow search filter. Prices are USD; rental prices are monthly. Living area is in square feet.

## `minBedrooms` (type: `number`):

Optional Zillow search filter. Prices are USD; rental prices are monthly. Living area is in square feet.

## `maxBedrooms` (type: `number`):

Optional Zillow search filter. Prices are USD; rental prices are monthly. Living area is in square feet.

## `minBathrooms` (type: `number`):

Optional Zillow search filter. Prices are USD; rental prices are monthly. Living area is in square feet.

## `minSquareFeet` (type: `number`):

Optional Zillow search filter. Prices are USD; rental prices are monthly. Living area is in square feet.

## `maxSquareFeet` (type: `number`):

Optional Zillow search filter. Prices are USD; rental prices are monthly. Living area is in square feet.

## `resumeFromRunId` (type: `string`):

Optional finished run ID from this actor and your account. Copy the full PAGINATION.nextInput to continue from the latest batch. Keep query filters unchanged; change maxResults or advanced limits if needed. Saved rows are skipped. Continuation does not renew the Free allowance or guarantee recovery from a 403.

## `advanced` (type: `object`):

Request, time and download ceilings. Automatic access recovery is included and requires no additional setup.

## Actor input object example

```json
{
  "zipCodes": [
    "78704"
  ],
  "listingType": "sale",
  "maxResultsPerZip": 100,
  "maxResults": 3
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `continuation` (type: `string`):

No description

## `errors` (type: `string`):

No description

## `requests` (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": [
        "78704"
    ],
    "maxResults": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("x_guru/zillow-zip-code-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": ["78704"],
    "maxResults": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("x_guru/zillow-zip-code-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": [
    "78704"
  ],
  "maxResults": 3
}' |
apify call x_guru/zillow-zip-code-scraper --silent --output-dataset

```

## MCP server setup

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