# Zillow ZIP Code Search API: For Sale, Rent & Sold by ZIP (`sauliusautomatesit/zillow-zip-code-search-api`) Actor

Zillow ZIP code search API and scraper: every home for sale, for rent or recently sold in your list of US ZIP codes, with price, Zestimate, beds, baths, area, broker and photos, past Zillow's 820 cap. Optional full details. No login; also via MCP. $1.50 per 1,000 homes.

- **URL**: https://apify.com/sauliusautomatesit/zillow-zip-code-search-api.md
- **Developed by:** [Saulius AutomatesIT](https://apify.com/sauliusautomatesit) (community)
- **Categories:** Real estate, Lead generation, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.28 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Search API: For Sale, Rent & Sold by ZIP

Zillow ZIP code search API and scraper: give it a list of US **ZIP codes** and get every home Zillow has **for sale, for rent or recently sold** in each, with price, Zestimate, rent Zestimate where shown, tax value, beds, baths, living area, lot, home type, days on Zillow, sold date, broker, coordinates and photos. Big ZIP codes are split into smaller map areas automatically, so you get past Zillow's 820-home cap.

No Zillow account, no cookies, no browser. **$1.50 per 1,000 homes**, or $2 per 1,000 with full details.

### What you can use it for

- **Investors and wholesalers**: every listing in your target ZIP codes each morning, with price next to Zestimate.
- **Sold comps**: recently sold homes per ZIP code with sold price and date.
- **Rental market research**: rentals per ZIP code with rent and unit prices for apartment buildings.
- **Agents and lenders**: new listings and price changes in your farm area, scheduled daily.

### How to use it

1. Add **ZIP codes**, one per line (or comma separated).
2. Pick **for sale**, **for rent** or **recently sold** and how many homes per ZIP code.
3. Turn on **Full details for every home** if you need description, Zestimate range, agent and facts.
4. Run it, or schedule it, and download JSON, CSV or Excel or read the rows through the API.

Inputs written for other Zillow ZIP code scrapers work too: `zipCodes`, `resultsLimit`, `forRent` and `sold` are accepted.

#### Input example

```json
{
  "zipCodes": ["78704", "07306", "33139"],
  "status": "forSale",
  "maxResultsPerZip": 500,
  "includeDetails": false
}
```

### Output

#### Listing (one per home found by a search)

```json
{
  "type": "listing",
  "zpid": "58312123",
  "url": "https://www.zillow.com/homedetails/1011-Brodie-St-APT-28-Austin-TX-78704/58312123_zpid/",
  "status": "FOR_SALE",
  "price": 600000,
  "address": "1011 Brodie St APT 28, Austin, TX 78704",
  "city": "Austin", "state": "TX", "zipcode": "78704",
  "latitude": 30.24636, "longitude": -97.76386,
  "bedrooms": 3, "bathrooms": 3, "livingArea": 1521,
  "lotArea": 4173.048, "lotAreaUnit": "sqft",
  "homeType": "SINGLE_FAMILY",
  "zestimate": null, "rentZestimate": null, "taxAssessedValue": 516022,
  "daysOnZillow": 2, "dateSold": null,
  "brokerName": "Compass RE Texas, LLC",
  "photos": ["https://photos.zillowstatic.com/fp/7a619a56e12d0d6372afe4917d72ff10-p_e.jpg"],
  "source": "search", "searchInput": "78704", "searchStatus": "forSale", "matchedPlace": "78704", "position": 2
}
```

Rentals in apartment buildings have `isBuilding: true`, the building name and `units` with price per bedroom count, and no zpid.

#### Property row

```json
{
  "type": "property",
  "zpid": "48749425",
  "url": "https://www.zillow.com/homedetails/2114-Bigelow-Ave-N-Seattle-WA-98109/48749425_zpid/",
  "status": "OTHER",
  "price": 2155400,
  "zestimate": 2155400, "zestimateLow": 1939860, "zestimateHigh": 2370940,
  "rentZestimate": 6769,
  "streetAddress": "2114 Bigelow Ave N", "city": "Seattle", "state": "WA", "zipcode": "98109",
  "county": "King County",
  "bedrooms": 4, "bathrooms": 3, "livingArea": 3470, "lotSize": 4680, "yearBuilt": 1924,
  "homeType": "SINGLE_FAMILY",
  "taxAssessedValue": 2044000, "propertyTaxRate": 0.82, "lastSoldPrice": 995000,
  "daysOnZillow": 6522, "pageViews": null, "favorites": null,
  "description": null,
  "agentName": null, "brokerName": null, "mlsId": null,
  "neighborhood": "Queen Anne", "pricePerSquareFoot": 621,
  "facts": { "homeType": "SingleFamily", "lotSize": "4,680 sqft", "yearBuilt": 1924, "parkingFeatures": ["Off-street", "Garage"] },
  "photos": ["https://photos.zillowstatic.com/fp/..."],
  "source": "address", "input": "2114 Bigelow Ave N, Seattle, WA 98109",
  "matchedAddress": "2114 Bigelow Ave N Seattle, WA 98109"
}
```

For-sale homes add the listing description, agent name and phone, broker, MLS name and id, page views and saves, HOA fee and price per square foot. `priceHistory` and `taxHistory` are filled when Zillow puts them in the page (some showcase listings); otherwise they are `null`.

### Good to know

- **Search size**: Zillow shows at most about 820 homes per search. Ask for more and the ZIP code's map is split into quarters, again where needed, with duplicates removed. The run summary (`OUTPUT`) shows how many homes Zillow has per ZIP code and how many you got.
- **Sold prices** are empty (`price: null`) in non-disclosure states such as Texas and Utah, where Zillow does not show sale prices to visitors; the sold date, Zestimate and tax value are still there.
- A ZIP code with no homes for the chosen status comes back as a free `NO_RESULTS` row; a line that is not a 5-digit ZIP code as a free `NOT_A_ZIP` row.
- Need cities, neighborhoods, counties or a Zillow search link with your own price, beds or home type filters? Use [Zillow Scraper API](https://apify.com/sauliusautomatesit/zillow-scraper-api).

### Pricing

| Item | Price |
|---|---|
| Listing (home from the ZIP code search) | $0.0015 ($1.50 per 1,000) |
| Property (with full details on) | $0.002 ($2 per 1,000) |
| Run start | $0.00005 |

Bronze, Silver and Gold Apify plans pay 5%, 10% and 15% less. With full details on, each home is charged once, as a property. Misses are free `error` rows.

### Use it from code or an AI agent

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("sauliusautomatesit/zillow-zip-code-search-api").call(run_input={
    "zipCodes": ["78704", "78702"],
    "status": "sold",
    "maxResultsPerZip": 300,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("zipcode"), item.get("price"), item.get("dateSold"), item.get("address"))
```

As an MCP tool for Claude, Cursor or any MCP client: `https://mcp.apify.com/?tools=sauliusautomatesit/zillow-zip-code-search-api`.

### Related Actors

- [Zillow Property Details API](https://apify.com/sauliusautomatesit/zillow-property-details-api): full details with Zestimate for Zillow links, zpids or street addresses.
- [Zillow Scraper API](https://apify.com/sauliusautomatesit/zillow-scraper-api): search by city, neighborhood or search link with filters, plus property details.

### Notes

The Actor reads only public data that Zillow shows to any logged-out visitor, and it does not collect agents' e-mail addresses. Use the data in line with Zillow's terms and the privacy and fair housing laws that apply to you.

# Actor input Schema

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

US ZIP codes, one per line, for example `78704`. Each gives up to `Max homes per ZIP code` homes with the status below.

## `status` (type: `string`):

`forSale` (the default when left empty), `forRent` or `sold` (recently sold).

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

Zillow shows at most about 820 homes per search; above that the ZIP code's map is split into smaller areas automatically, up to all the homes Zillow has. Default 100.

## `includeDetails` (type: `boolean`):

Opens each home for the full property row (description, Zestimate range, rent Zestimate, facts, agent, more photos). Charged as a property ($2 per 1,000) instead of a listing ($1.50 per 1,000). Apartment buildings stay listings.

## `maxPhotos` (type: `integer`):

Photo links per row, largest size. 0 for none.

## `concurrency` (type: `integer`):

Requests to Zillow at once. The default suits most runs.

## Actor input object example

```json
{
  "zipCodes": [
    "78704",
    "07306"
  ],
  "maxResultsPerZip": 25,
  "includeDetails": false,
  "maxPhotos": 5,
  "concurrency": 10
}
```

# Actor output Schema

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

Items of type listing and property. Download as JSON, CSV or Excel, or read it from this API endpoint.

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

Rows delivered per type, homes Zillow has per search, inputs not found and failures.

# 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",
        "07306"
    ],
    "maxResultsPerZip": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("sauliusautomatesit/zillow-zip-code-search-api").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",
        "07306",
    ],
    "maxResultsPerZip": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("sauliusautomatesit/zillow-zip-code-search-api").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",
    "07306"
  ],
  "maxResultsPerZip": 25
}' |
apify call sauliusautomatesit/zillow-zip-code-search-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sauliusautomatesit/zillow-zip-code-search-api"
        }
    }
}
```

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/TM1S5n1mTCTLbeIHG/builds/2bjPEMIFuBMkMFvvS/openapi.json