# Zillow Scraper - ZIP & City Search, Pay per Listing (`clearpath/zillow-zip-code-search-scraper`) Actor

Extract Zillow rentals, for-sale and sold listings by ZIP code, city, county or neighborhood. Export property details, photos, prices and available agent contacts. Filter by price, home type and listing status. Pay per exported listing and completed location search.

- **URL**: https://apify.com/clearpath/zillow-zip-code-search-scraper.md
- **Developed by:** [ClearPath](https://apify.com/clearpath) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Security:** Limited permissions
- **Stats:** 37 total users, 8 monthly users, 96.3% runs succeeded, 4 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.49 / 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 Search Scraper Pro | Lightning-Fast Property Data Extraction (2026)

[![Price cuts. Zestimates. Rent estimates. Compare listings across your target ZIP codes.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/zillow-zip-code-search-scraper-readme-hero-v1.png)](https://console.apify.com/actors/qEF4wZM7dQpm1ebJ3/input)

From **Clearpath**, creators of [Zillow Bulk Search](https://apify.com/clearpath/zillow-bulk-search-unlimited-scraper) and [Zillow Message Inbox](https://apify.com/clearpath/zillow-message-inbox-api). Search local property markets, build a shortlist and manage your Zillow workflow.

### Why choose this actor?

- **Find listings with price cuts.** Filter for reduced-price homes, then compare asking prices, Zestimates and days on market to build your shortlist.
- **Add rental context to your research.** Collect rent estimates alongside property details. Rental listings can also include contact phone numbers and special offers where Zillow provides them.
- **Search your target markets together.** Enter multiple ZIP codes or cities, choose for-sale, rental or sold listings, and filter by price, home type, size and listing recency. Export JSON, CSV or Excel.

<a href="https://console.apify.com/actors/qEF4wZM7dQpm1ebJ3/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/zillow-zip-code-search-scraper-readme-cta-v1.svg" width="250" height="48" alt="Find Zillow price cuts"></a>

### Try a price-cut search

Start with ten for-sale listings in Miami that have price reductions.

```json
{
  "locations": [
    "Miami FL"
  ],
  "propertyType": "forSale",
  "showOnlyPriceReductions": true,
  "maxResultsPerLocation": 10
}
```

[Open actor input](https://console.apify.com/actors/qEF4wZM7dQpm1ebJ3/input) to choose your locations. Keep `showOnlyPriceReductions: true` to filter for price cuts; this option applies to for-sale searches. Estimates and contact details depend on the listing. For searches beyond this actor’s per-location coverage, use [Zillow Bulk Search](https://apify.com/clearpath/zillow-bulk-search-unlimited-scraper).

<table>
<tr><td colspan="6" style="padding:10px 12px;background:#006AFF;border:none"><strong style="color:#FFFFFF;font-size:14px">Clearpath · Zillow Suite</strong></td></tr>
<tr>
<td style="padding:10px 11px;background:#EAF0FF;border:1px solid #CBD8EF;vertical-align:top;width:16%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-o7HmXfwKe2eunRYXI-9A6dajayVT-zillow-bulk-search-unlimited-scraper-logo.png.png" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/zillow-bulk-search-unlimited-scraper" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">Bulk Search</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">Larger searches</span></td>
<td style="padding:10px 11px;background:#D8E4FF;border:1px solid #CBD8EF;vertical-align:top;width:16%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-qEF4wZM7dQpm1ebJ3-8ed2mYypPN-zillow-zip-code-search-scraper.png" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/zillow-zip-code-search-scraper" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">ZIP Search</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">You are here</span></td>
<td style="padding:10px 11px;background:#EAF0FF;border:1px solid #CBD8EF;vertical-align:top;width:16%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-WOsEeX3kiEAVP3y0C-tbE8tfRWNS-zillow-contact-message-api-logo.png" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/zillow-contact-message-api" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">Contact</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">Send inquiries</span></td>
<td style="padding:10px 11px;background:#EAF0FF;border:1px solid #CBD8EF;vertical-align:top;width:16%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-vGu8Ujn448eqOjb6g-GZ9eLLaEOR-zillow-rental-application-submitter-logo.png" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/zillow-rental-application-submitter" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">Auto Apply</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">Rental requests</span></td>
<td style="padding:10px 11px;background:#EAF0FF;border:1px solid #CBD8EF;vertical-align:top;width:16%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-skl5evdFtHhSSNRQW-K6oSwOZwSN-zillow-inbox-actor-logo.png" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/zillow-message-inbox-api" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">Inbox</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">Export messages</span></td>
<td style="padding:10px 11px;background:#EAF0FF;border:1px solid #CBD8EF;vertical-align:top;width:16%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-LyfKD6NnSDWp7eRJ8-OJ77D2aoNc-redin-scraper-logo.jpg" width="20" height="20" style="vertical-align:middle">&nbsp; <a href="https://apify.com/clearpath/redfin-search-scraper" style="color:#173660;font-size:13px;font-weight:700;text-decoration:none">Redfin</a></span><br><span style="white-space:nowrap;color:#334766;font-size:12px">Homes &amp; rentals</span></td>
</tr>
</table>

#### Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

```
clearpath/zillow-zip-code-search-scraper on Apify. Call: ApifyClient("TOKEN").actor("clearpath/zillow-zip-code-search-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: locations (array, required: ZIP codes, city + state, counties, or neighborhoods written as 'Neighborhood, City, ST'), propertyType (string, required: forRent/forSale/sold), maxResultsPerLocation (integer, max 1000 per location). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/clearpath~zillow-zip-code-search-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Pricing: $1.49 per 1,000 exported listings plus $1.99 per 1,000 completed location searches, including empty searches. Platform usage included. Get token: https://console.apify.com/account/integrations
```

### Pricing

**Listing charges: $1.49 per 1,000 exported property listings.**

**Location-search charges: $1.99 per 1,000 completed location searches.** Each ZIP code, city, county, or neighborhood searched counts once, including a valid search with no matching listings. Failed searches are not charged as location searches. Listings delivered before a later search failure are still charged.

Platform usage is included. No monthly subscription. There is no fixed limit on the number of locations or total listings across locations; your run budget controls spending. Each location remains subject to available search coverage and your result limit.

The Actor reserves enough budget for a location search and one possible listing before starting it. It stops when the remaining budget cannot cover more work. A search that stops normally at your result or spending limit still counts as one location search. Repeated runs are charged for each search and listing export, even when a property appeared in an earlier run.

| Example | Listing charges | Location-search charges |
|---|---:|---:|
| 1 location, 200 listings | $0.298 | $0.00199 |
| 1,000 completed searches, no matches | $0 | $1.99 |

Repeated technical failures stop the run so it does not keep searching unsuccessfully. Successful empty searches are not treated as failures.

***

### ⚡ Key Features

#### Lightning-Fast Performance

- **Batch location processing** - Scrape multiple zip codes or cities in a single run
- **Parallel execution** - Concurrent location processing for maximum speed
- **Local market searches** - For larger result sets, use [Zillow Bulk Search](https://apify.com/clearpath/zillow-bulk-search-unlimited-scraper).
- **Reliable proxy support** - Built-in Apify proxy integration for consistent access

#### 📊 Complete Data Extraction

- **Three property types** - For Rent, For Sale, Recently Sold
- **Complete source records** - Every field Zillow publishes for a listing, kept whole
- **Metadata enrichment** - A timestamp and the search location on every row
- **Full listing details** - Addresses, prices, features, photos, agent info
- **Market statistics** - Total available listings, result counts per location

#### 🎯 Advanced Filtering System

- **Price ranges** - Min/max monthly rent or sale prices
- **Home types** - Houses, condos, apartments, townhomes, multi-family, manufactured, land
- **Property features** - Living area (sqft), bedrooms (min/max)
- **Listing types** - Agent listed, FSBO, new construction, foreclosures, auctions
- **Time-based filters** - Days on Zillow (1 day to 36 months)
- **Status filters** - Price reductions, pending/under contract, backup offers
- **Space preferences** - Entire places vs. room rentals (for rentals)
- **Flexible sorting** - Recommended (priority score), recently changed, newest, price, bedrooms, bathrooms

#### 🔄 Smart Location Handling

- **Multiple format support** - ZIP codes ("77494"), city + state ("New York NY"), counties ("Travis County, TX") and neighborhoods ("Capitol Hill, Seattle, WA")
- **Automatic resolution** - Converts locations to geographic boundaries
- **Batch processing** - Process dozens of locations efficiently
- **Error tolerance** - Continues processing if individual locations fail
- **Result tracking** - Detailed success/failure reporting per location

#### 📉 Price Change Tracking

- **Instant deal finder** - Filter exclusively for price reductions with `showOnlyPriceReductions`
- **Price drop alerts** - Every listing includes exact reduction amount and date changed
- **Motivated seller identification** - Find properties with recent price cuts
- **Market trend analysis** - Track pricing adjustments across neighborhoods
- **Competitive intelligence** - Monitor when competitors adjust pricing

***

### 🚀 Quick Start

**Note:** If you don't specify `propertyType`, the actor defaults to `forRent` (rental listings).

#### Basic - Rental Search by Zip Code

```json
{
  "locations": ["77494", "90210"],
  "propertyType": "forRent"
}
```

***

### 🎯 Use Cases

#### For Real Estate Investors

- **Price drop opportunities** - Use `showOnlyPriceReductions` to instantly find motivated sellers and negotiate better deals
- **Identify investment opportunities** - Find undervalued properties with price reduction filters
- **Market trend analysis** - Compare prices across multiple zip codes and neighborhoods
- **Foreclosure tracking** - Monitor foreclosures, auctions, and pre-foreclosures
- **New construction discovery** - Track new developments and coming-soon listings
- **ROI calculations** - Analyze sold properties to estimate potential returns
- **Portfolio expansion** - Scout new markets with comprehensive location searches

#### For Data Analysts & Researchers

- **Market research** - Extract bulk property data for statistical analysis
- **Price trend analysis** - Analyze price change patterns, frequency of reductions, and market elasticity
- **Price modeling** - Build predictive models with historical sold data
- **Trend identification** - Track market movements across time periods
- **Competitive analysis** - Compare inventory and pricing across regions
- **Custom dashboards** - Export data to BI tools for visualization
- **Academic research** - Gather datasets for housing market studies

#### For Property Managers & Real Estate Professionals

- **Rental market insights** - Monitor rental prices and availability by neighborhood
- **Competitor pricing intelligence** - Track when competing properties reduce prices to optimize your pricing strategy
- **Competitive positioning** - Track competitor listings and pricing strategies
- **Client prospecting** - Identify sellers and buyers in target markets
- **Market reports** - Generate comprehensive property reports for clients
- **Inventory tracking** - Monitor days on market and listing status changes
- **Neighborhood analysis** - Compare property features across zip codes

***

### Advanced Searches

#### Investment Property Search

```json
{
  "locations": ["Miami FL", "Orlando FL"],
  "propertyType": "forSale",
  "listingTypes": ["foreclosure", "foreclosed", "auction"],
  "minPrice": 100000,
  "maxPrice": 300000,
  "homeTypes": ["singleFamily"],
  "daysOnZillow": "1_week",
  "sortBy": "price_low"
}
```

#### Complete - Targeted Rental Analysis

```json
{
  "locations": ["New York NY", "Brooklyn NY", "Queens NY"],
  "propertyType": "forRent",
  "homeTypes": ["singleFamily", "townhome"],
  "minPrice": 2500,
  "maxPrice": 4000,
  "minBedrooms": 3,
  "maxBedrooms": 4,
  "minLivingAreaSqft": 1500,
  "maxLivingAreaSqft": 2500,
  "includeRoomForRent": false,
  "daysOnZillow": "1_month",
  "sortBy": "price_low"
}
```

***

### 📝 Input Parameters

| Parameter | Type | Description | Default |
|-----------|------|-------------|---------|
| **locations** | array | ZIP codes (`77494`), city + state (`New York NY`), counties (`Travis County, TX`) or neighborhoods written as `Neighborhood, City, ST` (`Mission District, San Francisco, CA`) | **Required** |
| **propertyType** | string | Type of listings: `forRent`, `forSale`, or `sold` | `forRent` |
| **homeTypes** | array | Property types to include: `singleFamily`, `condo`, `apartment`, `townhome`, `multiFamily`, `manufactured`, `land`. Leave empty for "Any". | Optional |
| **listingTypes** | array | For Sale only: `fsba` (Agent Listed), `fsbo` (Owner/FSBO), `newConstruction`, `comingSoon`, `auction`, `foreclosure`, `foreclosed`, `preforeclosure` | Optional |
| **minPrice** | integer | Minimum price (monthly rent for rentals, total price for sales/sold) | Optional |
| **maxPrice** | integer | Maximum price (monthly rent for rentals, total price for sales/sold) | Optional |
| **minBedrooms** | integer | Minimum number of bedrooms | Optional |
| **maxBedrooms** | integer | Maximum number of bedrooms | Optional |
| **minLivingAreaSqft** | integer | Minimum living area in square feet | Optional |
| **maxLivingAreaSqft** | integer | Maximum living area in square feet | Optional |
| **daysOnZillow** | string | Time filter: `1_day`, `1_week`, `2_weeks`, `1_month`, `3_months`, `6_months`, `12_months`, `24_months`, `36_months` | Optional |
| **sortBy** | string | Sort order: `rentalPriorityScore` (Recommended), `recentlyChanged`, `newest`, `price_high`, `price_low`, `bedrooms`, `bathrooms` | `rentalPriorityScore` |
| **showOnlyPriceReductions** | boolean | For Sale only: Show only listings with price drops | `false` |
| **includePendingAndUnderContract** | boolean | Include pending or under contract listings | `false` |
| **includeAcceptingBackupOffers** | boolean | Include listings accepting backup offers | `false` |
| **includeRoomForRent** | boolean | Rentals only: Include room-for-rent listings (false = entire places only) | `false` |
| **maxResultsPerLocation** | integer | Maximum results to scrape per location (1-1000) | `1000` |

#### ⚠️ Common Mistakes That Return Zero Results

Most "no results" runs are caused by input the actor does not recognise. It accepts the canonical names below — if you pass anything else, it will fail fast with a clear error instead of silently scraping nothing. Common pitfalls:

| Mistake | Fix |
|---------|-----|
| `"locations": ["123 Main St, Springfield, IL"]` | **Street addresses are not supported.** Use the ZIP code (`60601`), city + state (`Springfield IL`), county (`Sangamon County, IL`) or neighborhood (`Downtown, Springfield, IL`). |
| `"locations": ["Mission District San Francisco CA"]` | **Neighborhoods need their commas:** `Mission District, San Francisco, CA`. Without them the words can be read as a business or an address, and the run reports the place as not found. |
| `"locations": ["https://www.zillow.com/rooms-for-rent/?searchQueryState=..."]` | **Links are not supported.** Paste the place itself: the ZIP code, city + state, county or neighborhood. The choices inside the link do not carry over: set `propertyType`, `minPrice`/`maxPrice`, `minBedrooms`/`maxBedrooms` and `includeRoomForRent` here. A link that searches an area drawn by hand on the map cannot be reproduced at all; pick a place that covers it. |
| `"propertyType": "rent"` | Use the exact value `forRent` (also accepted: `forSale`, `sold`). Single-word aliases like `rent` / `sale` will be auto-mapped, but the canonical names are recommended. |
| `"homeType": ["house", "townhouse"]` | The field is `homeTypes` (plural). Values are `singleFamily`, `condo`, `apartment`, `townhome`, `multiFamily`, `manufactured`, `land` — not `house` / `townhouse` / `multi-family`. |
| `"listingType": "rental"` or `"listingStatus": "forSale"` | Neither field exists in this actor. Use `propertyType` for rent/sale/sold and `listingTypes` for For-Sale subtypes (`fsbo`, `fsba`, `newConstruction`, etc.). |
| `"maxItems": 100` | Use `maxResultsPerLocation` instead — `maxItems` from other Zillow scrapers is silently ignored. |
| `daysOnZillow: "1_day"` on rural ZIP for `sold` | Many rural ZIPs have zero sales per day/week. Try `1_month` or longer, or use a broader location like the county. |

If you get zero results, the actor now prints a checklist at the end of the run. Read it — most fixes take 30 seconds.

Two different messages tell you what happened to a location. `Could not find a place called '...'` means the location never became a search area (a typo, an address, a business name, or a neighborhood without its commas); it is not charged as a location search. `No listings currently match in '...'` means the place was found and searched and nothing is listed there under your filters; that is a completed location search and is charged as one.

#### Home Types by Property Type

**For Rentals** (4 types available):

- Houses (`singleFamily`)
- Condos/Co-ops (`condo`)
- Apartments (`apartment`)
- Townhomes (`townhome`)

**For Sales & Sold** (7 types available):

- Houses (`singleFamily`)
- Multi-family (`multiFamily`)
- Manufactured (`manufactured`)
- Lots/Land (`land`)
- Condos/Co-ops (`condo`)
- Apartments (`apartment`)
- Townhomes (`townhome`)

*Note: Invalid home types for the selected property type are automatically filtered.*

#### Sort Order Options

The actor supports multiple sorting options with **Recommended (Priority Score)** as the default:

- **`rentalPriorityScore`** (Recommended) - Zillow's algorithm for optimal listing relevance based on multiple quality signals
- **`recentlyChanged`** - Listings with recent updates (price changes, status updates)
- **`newest`** - Most recently listed properties first
- **`price_high`** / **`price_low`** - Sort by price (descending/ascending)
- **`bedrooms`** / **`bathrooms`** - Sort by number of rooms (most to least)

*Tip: Use the default `rentalPriorityScore` for balanced results, or switch to `price_low`/`price_high` for budget-focused searches.*

***

### 📊 Understanding the Data Structure

Each scraped item follows this structure:

```
item
├── rawData
│   ├── property                    ← All property details here
│   │   ├── zpid                   ← Zillow Property ID
│   │   ├── location               ← {latitude, longitude}
│   │   ├── address                ← {streetAddress, city, state, zipcode}
│   │   ├── media                  ← Photos, videos, VR tours
│   │   ├── rental                 ← Rental-specific info
│   │   ├── price                  ← {value, pricePerSquareFoot}
│   │   ├── listing                ← {listingStatus, marketingStatus}
│   │   ├── estimates              ← {zestimate, rentZestimate}
│   │   └── ... 40+ more fields
│   └── resultType                 ← "property" or "propertyGroup"
├── scrapedAt                       ← ISO timestamp
└── location                        ← Search location
```

**Quick Access Examples:**

```javascript
// Access property details
const zpid = item.rawData.property.zpid;
const address = item.rawData.property.address.streetAddress;
const price = item.rawData.property.price.value;

// Check if it's an apartment complex
const isComplex = item.rawData.resultType === "propertyGroup";

// Get metadata
const scrapedTime = item.scrapedAt;
const searchLocation = item.location;
```

***

### 📤 Output

Zillow ZIP Code Search Scraper Pro returns the complete, unmodified listing record Zillow publishes, with all available property data. Each result includes:

**Top-Level Structure**

- `rawData` - The complete listing record with all property information
- `scrapedAt` - ISO 8601 timestamp of when the data was extracted
- `location` - The search location (zip code or city)
- `resultType` - Either "property" (individual listing) or "propertyGroup" (apartment complex)

**Property Data (within `rawData.property`)**

All data is nested under `rawData.property` and includes:

- **Identification**: `zpid` (Zillow Property ID), `ssid`, `providerListingID`
- **Location**: `location` object (latitude/longitude), `address` object (street, city, state, zipcode, optional buildingId)
- **Pricing**:
  - Individual properties: `price.value`, `price.pricePerSquareFoot`
  - Apartment complexes: `minPrice`, `maxPrice`, `minBaseRent`, `maxBaseRent`, `unitsGroup` array
- **Property Details**: `bedrooms`, `bathrooms`, `livingArea`, `propertyType`, `factsAndFeatures`
- **Media**: Complete `media` object with `propertyPhotoLinks`, `allPropertyPhotos` (high-resolution URLs), `thirdPartyPhotoLinks` (Street View, satellite), VR/video flags
- **Rental Info**: `rental` object with `areApplicationsAccepted`, `isRoomForRent`, `isBuildToRent`, `baseRent`, `marketingTreatments`
- **Listing Status**: `listing` object with `listingStatus`, `marketingStatus`, `listingSubType`
- **Time Info**: `listingDateTimeOnZillow`, `daysOnZillow`, `bestGuessTimeZone`
- **Estimates**: `estimates` object with `zestimate`, `rentZestimate` (Zillow's automated valuations)
- **Tax Info**: `taxAssessment` object with `taxAssessedValue`, `taxAssessmentYear`
- **Display Info**: `hdpView`, `propertyDisplayRules`, `listCardRecommendation`, `personalizedResult`
- **Flags**: `isFeatured`, `isShowcaseListing`, `isUnmappable`, `isPreforeclosureAuction`, `hasFloorPlan`
- **Additional**: `currency`, `country`, `region`, `zillowOwnedProperty`

**Apartment Complexes** (`resultType: "propertyGroup"`) include additional fields:

- `title` - Complex name
- `groupType` - "apartmentComplex"
- `matchingHomeCount` - Number of available units
- `unitsGroup` - Array of unit configurations with bedrooms and price ranges

#### Output Example - Rental Property (Single Family Home)

```json
{
  "rawData": {
    "property": {
      "zpid": 117506944,
      "location": {
        "latitude": 29.735218,
        "longitude": -95.79938
      },
      "address": {
        "streetAddress": "4530 Ferndale Meadows Dr",
        "zipcode": "77494",
        "city": "Katy",
        "state": "TX"
      },
      "media": {
        "propertyPhotoLinks": {
          "highResolutionLink": "https://photos.zillowstatic.com/fp/63c087a2f63d388fe431ea21526fbdbc-p_f.jpg"
        },
        "thirdPartyPhotoLinks": {
          "streetViewLink": "https://maps.googleapis.com/maps/api/streetview?size=1440x448&location=...",
          "satelliteLink": "https://maps.googleapis.com/maps/api/staticmap?...",
          "streetViewMetadataLink": "https://maps.googleapis.com/maps/api/streetview/metadata?..."
        },
        "hasVRModel": false,
        "hasVideos": false,
        "hasIMX": false,
        "hasApprovedThirdPartyVirtualTour": false,
        "allPropertyPhotos": {
          "highResolution": [
            "https://photos.zillowstatic.com/fp/63c087a2f63d388fe431ea21526fbdbc-p_f.jpg",
            "https://photos.zillowstatic.com/fp/6d0e2ebd8b0528dc247c754687c694ce-p_f.jpg",
            "https://photos.zillowstatic.com/fp/62c5e4112544eda2e3c7feed5c464bc8-p_f.jpg"
          ]
        }
      },
      "isFeatured": true,
      "isShowcaseListing": false,
      "rental": {
        "areApplicationsAccepted": true,
        "isRoomForRent": false,
        "isBuildToRent": false,
        "isRentByBed": false,
        "marketingTreatments": [
          "paid",
          "zillowRentalManager"
        ],
        "baseRent": 2290.0,
        "hasVirtualTour": false
      },
      "currency": "usd",
      "country": "usa",
      "listingDateTimeOnZillow": 1759972785555,
      "bestGuessTimeZone": "America/Chicago",
      "isUnmappable": false,
      "listCardRecommendation": {
        "flexFieldRecommendations": [
          {
            "displayString": "Apply instantly",
            "flexFieldType": "unknown",
            "contentType": "frZillowApplication"
          },
          {
            "displayString": "28 days ago",
            "flexFieldType": "unknown",
            "contentType": "timeOnInfo"
          }
        ]
      },
      "bathrooms": 2.0,
      "factsAndFeatures": {
        "fullBathroomCount": 2
      },
      "bedrooms": 3,
      "livingArea": 2253,
      "propertyType": "singleFamily",
      "listing": {
        "listingStatus": "forRent",
        "marketingStatus": "active",
        "palsId": "100066001_a8be5a8f9646e36ebf645c0856841e3a92f092c8052869854262d7a38742dc33",
        "providerListingID": "4ux8tfwuxmywg",
        "listingSubType": {}
      },
      "daysOnZillow": 28,
      "isPreforeclosureAuction": false,
      "price": {
        "value": 2290,
        "pricePerSquareFoot": 1
      },
      "estimates": {
        "zestimate": 390800,
        "rentZestimate": 2284
      },
      "zillowOwnedProperty": {
        "isZillowOwned": false
      },
      "taxAssessment": {
        "taxAssessedValue": 417269,
        "taxAssessmentYear": "2025"
      },
      "hdpView": {
        "listingStatus": "forRent",
        "price": 2290,
        "hdpUrl": "/homedetail/…#zpid=117506944"
      },
      "region": {},
      "personalizedResult": {
        "isViewed": false,
        "userRecommendation": {
          "isRecommendedForYou": false,
          "homeInsight": "Formal dining room"
        }
      },
      "propertyDisplayRules": {
        "canShowAddress": true,
        "canShowOnMap": true,
        "agent": {},
        "mls": {},
        "builder": {},
        "soldByOffice": {},
        "listingCategory": "category2"
      },
      "ssid": 100066,
      "hasFloorPlan": false
    },
    "resultType": "property"
  },
  "scrapedAt": "2025-11-06T11:13:30.918003+00:00",
  "location": "77494"
}
```

#### Output Example - Rental Property (Apartment Complex)

```json
{
  "rawData": {
    "property": {
      "zpid": 344571164,
      "location": {
        "latitude": 29.761017,
        "longitude": -95.88191
      },
      "address": {
        "streetAddress": "2011 Texas Heritage Pkwy",
        "zipcode": "77494",
        "city": "Katy",
        "state": "TX",
        "buildingId": 2747705420
      },
      "media": {
        "propertyPhotoLinks": {
          "highResolutionLink": "https://photos.zillowstatic.com/fp/80ed47c4da42c813fe0e43391e8ac485-p_f.jpg"
        },
        "hasVRModel": false,
        "hasVideos": false,
        "hasIMX": false,
        "hasApprovedThirdPartyVirtualTour": false,
        "allPropertyPhotos": {
          "highResolution": [
            "https://photos.zillowstatic.com/fp/80ed47c4da42c813fe0e43391e8ac485-p_f.jpg",
            "https://photos.zillowstatic.com/fp/fef34c2667fb8643014fd2935c8fb87f-p_f.jpg"
          ]
        }
      },
      "title": "The Vic at Jordan Ranch",
      "isFeatured": true,
      "isShowcaseListing": false,
      "rental": {
        "areApplicationsAccepted": false,
        "isRoomForRent": false,
        "isBuildToRent": false,
        "marketingTreatments": [
          "trustedListing",
          "paid",
          "multiFamilySalesListing",
          "paidMultifamily",
          "multifamilyPremium"
        ]
      },
      "currency": "usd",
      "country": "usa",
      "groupType": "apartmentComplex",
      "listingDateTimeOnZillow": 1762363709562,
      "bestGuessTimeZone": "America/Chicago",
      "isUnmappable": false,
      "listCardRecommendation": {
        "flexFieldRecommendations": [
          {
            "displayString": "22 available units",
            "flexFieldType": "unknown",
            "contentType": "frUnitsAvailable"
          }
        ]
      },
      "matchingHomeCount": 22,
      "listingStatus": "forRent",
      "providerListingID": "3bbwshytbu75j",
      "minPrice": 1246.0,
      "maxPrice": 2294.0,
      "unitsGroup": [
        {
          "bedrooms": 0,
          "minPrice": 1246,
          "isRoomForRent": false
        },
        {
          "bedrooms": 1,
          "minPrice": 1299,
          "isRoomForRent": false
        },
        {
          "bedrooms": 2,
          "minPrice": 1902,
          "isRoomForRent": false
        }
      ],
      "minBaseRent": 1246.0,
      "maxBaseRent": 2294.0
    },
    "resultType": "propertyGroup"
  },
  "scrapedAt": "2025-11-06T11:13:30.918003+00:00",
  "location": "77494"
}
```

*Note: Apartment complexes return `resultType: "propertyGroup"` with multiple units, while individual properties return `resultType: "property"`. The structure differs slightly - property groups have `minPrice`/`maxPrice` and `unitsGroup` arrays instead of single `price` values.*

#### Output Example - For Sale Property

```json
{
  "rawData": {
    "property": {
      "zpid": 245008087,
      "location": {
        "latitude": 40.68856,
        "longitude": -73.99047
      },
      "address": {
        "streetAddress": "251 Pacific St APT 17",
        "zipcode": "11201",
        "city": "Brooklyn",
        "state": "NY",
        "buildingId": 135520
      },
      "media": {
        "propertyPhotoLinks": {
          "highResolutionLink": "https://photos.zillowstatic.com/fp/7639f4703e7be99316f1ec99684f843d-p_f.jpg"
        },
        "thirdPartyPhotoLinks": {
          "streetViewLink": "https://maps.googleapis.com/maps/api/streetview?size=1440x448&location=...",
          "satelliteLink": "https://maps.googleapis.com/maps/api/staticmap?...",
          "streetViewMetadataLink": "https://maps.googleapis.com/maps/api/streetview/metadata?..."
        },
        "hasVRModel": false,
        "hasVideos": false,
        "hasIMX": false,
        "hasApprovedThirdPartyVirtualTour": false,
        "allPropertyPhotos": {
          "highResolution": [
            "https://photos.zillowstatic.com/fp/7639f4703e7be99316f1ec99684f843d-p_f.jpg",
            "https://photos.zillowstatic.com/fp/baafda5dd67d9a248d5844da17990d6b-p_f.jpg",
            "https://photos.zillowstatic.com/fp/802dc45863f191b35f2a264718046700-p_f.jpg"
          ]
        }
      },
      "isFeatured": false,
      "isShowcaseListing": false,
      "rental": {
        "areApplicationsAccepted": false,
        "hasVirtualTour": false
      },
      "currency": "usd",
      "country": "usa",
      "listingDateTimeOnZillow": 1756771200000,
      "bestGuessTimeZone": "America/New_York",
      "isUnmappable": false,
      "listCardRecommendation": {
        "flexFieldRecommendations": [
          {
            "displayString": "Open: Sun 2:30-3:30pm (11/9)",
            "flexFieldType": "openHouse",
            "contentType": "openHouse"
          },
          {
            "displayString": "Price cut: $26,000 (11/4)",
            "flexFieldType": "priceCut",
            "contentType": "priceCut"
          },
          {
            "displayString": "Modern fixtures",
            "flexFieldType": "homeInsight",
            "contentType": "homeInsight"
          }
        ]
      },
      "bathrooms": 1.0,
      "factsAndFeatures": {
        "halfBathroomCount": 0,
        "fullBathroomCount": 1
      },
      "bedrooms": 1,
      "livingArea": 0,
      "yearBuilt": 1914,
      "propertyType": "condo",
      "listing": {
        "listingStatus": "forSale",
        "marketingStatus": "active",
        "palsId": "6955001_S1787428",
        "listingSubType": {
          "isOpenHouse": true,
          "isFSBA": true
        }
      },
      "daysOnZillow": 65,
      "isPreforeclosureAuction": false,
      "openHouseShowingList": [
        {
          "startTime": 1762716600000,
          "endTime": 1762720200000
        }
      ],
      "price": {
        "value": 899000,
        "changedDate": 1762232400000,
        "priceChange": -26000
      },
      "estimates": {
        "rentZestimate": 4210
      },
      "zillowOwnedProperty": {
        "isZillowOwned": false
      },
      "taxAssessment": {
        "taxAssessedValue": 2406000,
        "taxAssessmentYear": "2018"
      },
      "hdpView": {
        "listingStatus": "forSale",
        "price": 899000,
        "hdpUrl": "/homedetail/…#zpid=245008087"
      },
      "region": {},
      "personalizedResult": {
        "isViewed": false
      },
      "propertyDisplayRules": {
        "canShowAddress": true,
        "canShowOnMap": true,
        "agent": {},
        "mls": {
          "brokerName": "Listing by: Corcoran",
          "mustDisplayBrokerName": true
        },
        "builder": {},
        "soldByOffice": {},
        "listingCategory": "category1"
      },
      "ssid": 6955,
      "hasFloorPlan": false
    },
    "resultType": "property"
  },
  "scrapedAt": "2025-11-06T11:27:16.812270+00:00",
  "location": "New York NY"
}
```

#### Output Example - Sold Property

*Note: Sold properties have similar structure to For Sale properties, with additional fields like `dateSold`, `listPrice`, and `priceChange` showing the sales history.*

```json
{
  "rawData": {
    "property": {
      "zpid": 456789123,
      "location": {
        "latitude": 25.7907,
        "longitude": -80.1300
      },
      "address": {
        "streetAddress": "321 Ocean Boulevard",
        "city": "Miami Beach",
        "state": "FL",
        "zipcode": "33139"
      },
      "media": {
        "propertyPhotoLinks": {
          "highResolutionLink": "https://photos.zillowstatic.com/fp/example-photo.jpg"
        },
        "hasVRModel": false,
        "hasVideos": false,
        "allPropertyPhotos": {
          "highResolution": [
            "https://photos.zillowstatic.com/fp/example-photo-1.jpg",
            "https://photos.zillowstatic.com/fp/example-photo-2.jpg"
          ]
        }
      },
      "bedrooms": 3,
      "bathrooms": 3.0,
      "livingArea": 2200,
      "yearBuilt": 2018,
      "propertyType": "condo",
      "listing": {
        "listingStatus": "sold",
        "marketingStatus": "sold"
      },
      "daysOnZillow": 67,
      "price": {
        "value": 1250000,
        "listPrice": 1395000,
        "priceChange": -145000,
        "dateSold": 1733961600000
      },
      "estimates": {
        "zestimate": 1265000
      },
      "hdpView": {
        "listingStatus": "sold",
        "price": 1250000,
        "hdpUrl": "/homedetail/…#zpid=456789123"
      },
      "propertyDisplayRules": {
        "canShowAddress": true,
        "canShowOnMap": true
      }
    },
    "resultType": "property"
  },
  "scrapedAt": "2025-11-06T11:27:16.812270+00:00",
  "location": "Miami FL"
}
```

***

### 💡 Advanced Usage

#### Price Drop Monitoring for Investment Opportunities

Track properties with recent price reductions to identify motivated sellers:

```json
{
  "locations": ["Los Angeles CA", "San Diego CA", "San Francisco CA"],
  "propertyType": "forSale",
  "showOnlyPriceReductions": true,
  "minLivingAreaSqft": 1500,
  "maxPrice": 800000,
  "daysOnZillow": "3_months",
  "sortBy": "recentlyChanged"
}
```

#### Foreclosure & Auction Discovery

Find distressed properties for investment:

```json
{
  "locations": ["Phoenix AZ", "Las Vegas NV", "Tucson AZ"],
  "propertyType": "forSale",
  "listingTypes": ["foreclosure", "foreclosed", "auction", "preforeclosure"],
  "homeTypes": ["singleFamily", "multiFamily"],
  "maxPrice": 350000,
  "sortBy": "price_low"
}
```

#### Luxury Rental Market Analysis

Research high-end rental inventory:

```json
{
  "locations": ["90210", "90211", "90077"],
  "propertyType": "forRent",
  "homeTypes": ["singleFamily"],
  "minPrice": 10000,
  "minBedrooms": 4,
  "minLivingAreaSqft": 4000,
  "includeRoomForRent": false,
  "sortBy": "price_high",
  "maxResultsPerLocation": 500
}
```

#### Recently Sold Comparative Market Analysis

Analyze recent sales for pricing insights:

```json
{
  "locations": ["Seattle WA", "Bellevue WA"],
  "propertyType": "sold",
  "homeTypes": ["singleFamily", "townhome"],
  "minBedrooms": 3,
  "maxBedrooms": 5,
  "daysOnZillow": "6_months",
  "sortBy": "price_low"
}
```

#### New Construction Tracker

Monitor new developments and coming-soon listings:

```json
{
  "locations": ["Austin TX", "Round Rock TX", "Cedar Park TX"],
  "propertyType": "forSale",
  "listingTypes": ["newConstruction", "comingSoon"],
  "minBedrooms": 3,
  "sortBy": "newest"
}
```

***

### 🔌 API Integration

#### Python

```python
from apify_client import ApifyClient

## Initialize the Apify client
client = ApifyClient("your_apify_token")

## Prepare actor input
run_input = {
    "locations": ["77494", "90210", "Miami FL"],
    "propertyType": "forRent",
    "homeTypes": ["singleFamily", "townhome"],
    "minPrice": 2000,
    "maxPrice": 4000,
    "minBedrooms": 3,
    "sortBy": "price_low"
}

## Run the actor
print("Starting Zillow scraper...")
run = client.actor("your-actor-id").call(run_input=run_input)

## Fetch results from the dataset
print("Fetching results...")
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    prop = item["rawData"]["property"]

    # Handle both individual properties and apartment complexes
    if item["rawData"].get("resultType") == "propertyGroup":
        print(f"Complex: {prop.get('title', 'N/A')}")
        print(f"Address: {prop['address']['streetAddress']}")
        print(f"Price Range: ${prop['minPrice']} - ${prop['maxPrice']}")
        print(f"Available Units: {prop['matchingHomeCount']}")
    else:
        print(f"Address: {prop['address']['streetAddress']}")
        print(f"Price: ${prop['price']['value']}")
        print(f"Beds/Baths: {prop['bedrooms']}/{prop['bathrooms']}")
        print(f"Sqft: {prop.get('livingArea', 'N/A')}")
        print(f"Days on Zillow: {prop['daysOnZillow']}")

    print(f"Location: {prop['address']['city']}, {prop['address']['state']}")
    print(f"Scraped: {item['scrapedAt']}")
    print("-" * 50)
```

#### JavaScript/TypeScript

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

// Initialize the Apify client
const client = new ApifyClient({
    token: 'your_apify_token',
});

// Prepare actor input
const input = {
    locations: ['77494', '90210', 'Miami FL'],
    propertyType: 'forSale',
    listingTypes: ['foreclosure', 'auction'],
    maxPrice: 300000,
    homeTypes: ['singleFamily'],
    daysOnZillow: '1_week',
    sortBy: 'price_low'
};

// Run the actor
console.log('Starting Zillow scraper...');
const run = await client.actor('your-actor-id').call(input);

// Fetch results from the dataset
console.log('Fetching results...');
const { items } = await client.dataset(run.defaultDatasetId).listItems();

items.forEach((item) => {
    const prop = item.rawData.property;

    // Handle both individual properties and apartment complexes
    if (item.rawData.resultType === "propertyGroup") {
        console.log(`Complex: ${prop.title || 'N/A'}`);
        console.log(`Address: ${prop.address.streetAddress}`);
        console.log(`Price Range: $${prop.minPrice} - $${prop.maxPrice}`);
        console.log(`Available Units: ${prop.matchingHomeCount}`);
    } else {
        console.log(`Address: ${prop.address.streetAddress}`);
        console.log(`Price: $${prop.price.value}`);
        console.log(`Beds/Baths: ${prop.bedrooms}/${prop.bathrooms}`);
        console.log(`Sqft: ${prop.livingArea || 'N/A'}`);
        console.log(`Days on Zillow: ${prop.daysOnZillow}`);
    }

    console.log(`Location: ${prop.address.city}, ${prop.address.state}`);
    console.log(`Scraped: ${item.scrapedAt}`);
    console.log('-'.repeat(50));
});
```

#### Node.js with Scheduled Runs

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

const client = new ApifyClient({ token: 'your_apify_token' });

// Create a scheduled run (daily at 9 AM)
const schedule = await client.schedules().create({
    name: 'Daily Zillow Market Monitor',
    actorId: 'your-actor-id',
    cronExpression: '0 9 * * *', // Daily at 9 AM
    timezone: 'America/New_York',
    input: {
        locations: ['New York NY', 'Brooklyn NY'],
        propertyType: 'forRent',
        minPrice: 2500,
        maxPrice: 5000,
        sortBy: 'recentlyChanged'
    }
});

console.log(`Schedule created: ${schedule.id}`);
```

***

### 📊 Data Export

Export your scraped property data in multiple formats:

- **JSON** - Perfect for programmatic analysis, API integration, and data pipelines
- **CSV** - Import directly into spreadsheets for sorting, filtering, and reporting
- **Excel** - Create professional reports with formatting and formulas
- **RSS** - Set up real-time feeds for monitoring new listings

***

### 🤖 Automation

#### Scheduled Runs

Set up automated scraping on your schedule:

- **Daily monitoring** - Track new listings and price changes every morning
- **Weekly reports** - Generate comprehensive market reports every Monday
- **Monthly analysis** - Deep-dive market trends on the 1st of each month

#### Webhooks

Receive real-time notifications when scraping completes:

- **Integration endpoints** - Send data directly to your business intelligence tools
- **Slack notifications** - Get alerts in your team channels
- **Email reports** - Automated delivery of scraped data

#### API Access

Build custom workflows and integrations:

- **Pipeline integration** - Feed data into your analytics platforms
- **CRM sync** - Automatically update your customer relationship management system
- **Dashboard updates** - Power real-time property market dashboards

***

### 🎯 Best Practices

#### Performance Optimization

- Use specific zip codes instead of broad city names for more specific results
- Batch similar locations together in a single run for efficiency
- Use time-based filters (`daysOnZillow`) to focus on recent listings

#### Real Estate Investment

- Combine `showOnlyPriceReductions` with `daysOnZillow` filters to find motivated sellers
- Track foreclosures and auctions with `listingTypes` filters
- Use `sold` property type to analyze recent comparables for valuation
- Monitor multiple zip codes in target investment areas
- Set up scheduled runs to catch new opportunities immediately

#### Market Research & Analysis

- Scrape both `forRent` and `forSale` to understand market dynamics
- Use bedroom and sqft filters to segment property classes
- Export data to CSV/Excel for statistical analysis
- Compare multiple cities or neighborhoods in parallel
- Track price changes over time with scheduled runs

#### Rental Property Management

- Filter for entire places only with `includeRoomForRent: false`
- Use price ranges to find properties in your target demographic
- Monitor competitor listings with `recentlyChanged` sort order
- Track days on market to identify pricing issues
- Set up alerts for new listings in your service area

***

### ❓ FAQ

**Q: What data does the Zillow ZIP Code Search Scraper Pro extract?**
A: The actor extracts complete property information including zpid, address, price, bedrooms, bathrooms, square footage, lot size, property type, listing status, days on Zillow, photos, agent details, and much more.

**Q: How many properties can I scrape?**
A: Set `maxResultsPerLocation` to control how many listings you collect. This actor has a per-location search ceiling; use [Zillow Bulk Search](https://apify.com/clearpath/zillow-bulk-search-unlimited-scraper) for larger searches. Available inventory and your filters determine the final count.

**Q: Do I need a Zillow account?**
A: No Zillow account or login is required. The actor extracts publicly available listing data.

**Q: What's the cost?**
A: See the [Pricing tab](https://apify.com/clearpath/zillow-zip-code-search-scraper/pricing) for current rates and billing terms.

**Q: How current is the data?**
A: Data is extracted in real-time from Zillow's live listings. Properties reflect the current state at the time of scraping.

**Q: Are there rate limits?**
A: Temporary issues are handled automatically, so runs complete without manual intervention.

**Q: Can I filter by specific criteria?**
A: Yes! The actor supports 15+ filter parameters including price ranges, home types, bedrooms, square footage, listing types, days on market, and more. See the Input Parameters section for complete details.

**Q: What's the difference between home types for rentals vs. sales?**
A: Rentals support 4 home types (Houses, Condos, Apartments, Townhomes), while For Sale and Sold properties support all 7 types (adds Multi-family, Manufactured, Lots/Land). Invalid types are automatically filtered based on your property type selection.

**Q: Can I search multiple locations at once?**
A: Absolutely! The `locations` parameter accepts arrays of zip codes and city names. The actor processes them in parallel for maximum efficiency.

**Q: How long does scraping take?**
A: Run duration depends on the number of locations and matching listings. Start with a small result limit, then increase it for larger searches.

**Q: Can I track price reductions?**
A: Yes! Use the `showOnlyPriceReductions` parameter (For Sale only) to filter exclusively for listings with recent price drops - perfect for finding motivated sellers.

**Q: What formats can I export data in?**
A: You can export in JSON, CSV, Excel, and RSS formats directly from the Apify platform.

**Q: Can I schedule automated runs?**
A: Yes! Set up scheduled runs (daily, weekly, monthly) through the Apify platform to automatically monitor markets and track changes over time.

**Q: Is proxy support included?**
A: Yes, the actor includes built-in Apify proxy support for reliable access.

**Q: How do I access the property data from the results?**
A: All property data is nested under `rawData.property`. Here's how to access common fields:

```javascript
// JavaScript/TypeScript
const property = item.rawData.property;
const address = property.address.streetAddress;
const price = property.price.value;
const zpid = property.zpid;
```

```python
## Python
property_data = item["rawData"]["property"]
address = property_data["address"]["streetAddress"]
price = property_data["price"]["value"]
zpid = property_data["zpid"]
```

See the "Understanding the Data Structure" section above for a complete overview.

***

### 🚀 Getting Started

#### 1. Account Setup

1. [Sign up for Apify](https://console.apify.com/sign-up) (free tier available, no credit card required)
2. Set your maximum run budget in Apify Console
3. Get your API token from account settings

#### 2. Configure Your First Run

1. **Add locations** - Enter zip codes or city names (e.g., "77494", "New York NY")
2. **Select property type** - Choose For Rent, For Sale, or Recently Sold
3. **Apply filters** - Set price ranges, home types, bedrooms, square footage, etc.
4. **Set limits** - Define `maxResultsPerLocation` (default: 1000)

#### 3. Run & Monitor

1. Click "Start" to begin extraction
2. Monitor progress in real-time through the run log
3. Download results in your preferred format (JSON, CSV, Excel)
4. Review data quality and adjust filters as needed

#### 4. Integrate & Automate

1. Use the Apify API to integrate with your applications
2. Set up webhooks for real-time notifications
3. Create scheduled runs for automated monitoring
4. Build custom dashboards with exported data
5. Scale to multiple locations and property types

***

### 📧 Support

- **Email**: max@mapa.slmail.me
- **Feature Requests**: Email or submit via issues
- **Response Time**: Typically within 24 hours

***

### ⚖️ Legal Compliance

This actor extracts publicly available property listing data from Zillow. Users are responsible for complying with Zillow's Terms of Service and applicable data protection regulations (GDPR in the EU, CCPA in the US).

**Responsible Use**: This tool is intended for legitimate real estate research, market analysis, and investment purposes. Do not use scraped data for spam, harassment, or any activities that violate privacy laws or platform terms of service.

***

[🚀 **Start Extracting Zillow Property Data Now**](https://console.apify.com/actors/qEF4wZM7dQpm1ebJ3)

***

*Find price cuts and compare property estimates across your target ZIP codes.*

# Actor input Schema

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

Accepted: ZIP codes ('77494', '90210'), city + state ('New York NY', 'Los Angeles CA'), counties ('Travis County, TX') and neighborhoods written as 'Neighborhood, City, ST' ('Mission District, San Francisco, CA'). <b>Street addresses and zillow.com links are NOT supported</b> — only region-level places resolve. Paste the place itself, not a search link: a link's price, beds and rooms-for-rent choices do not carry over, so set them with the fields below. If you have an address, use its ZIP code instead.

## `propertyType` (type: `string`):

Type of property listings to search. Use these exact values: <code>forRent</code>, <code>forSale</code>, or <code>sold</code>.

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

Filter by property types. Use these exact values: <code>singleFamily</code>, <code>condo</code>, <code>apartment</code>, <code>townhome</code>, <code>multiFamily</code>, <code>manufactured</code>, <code>land</code>. Rentals support only the first four. Leave empty for 'Any'.

## `listingTypes` (type: `array`):

Choose which listing types to include (applies to For Sale searches). Leave empty to include all standard listing types. Ignored for Rentals and Sold.

## `showOnlyPriceReductions` (type: `boolean`):

Only show listings with price drops (For Sale only). Ignored for rentals.

## `includePendingAndUnderContract` (type: `boolean`):

Include listings that are pending or under contract. By default, Zillow excludes these.

## `includeAcceptingBackupOffers` (type: `boolean`):

Include listings accepting backup offers. By default, Zillow excludes these.

## `minLivingAreaSqft` (type: `integer`):

Minimum living area in square feet

## `maxLivingAreaSqft` (type: `integer`):

Maximum living area in square feet

## `minBedrooms` (type: `integer`):

Minimum number of bedrooms

## `maxBedrooms` (type: `integer`):

Maximum number of bedrooms

## `includeRoomForRent` (type: `boolean`):

Include room-for-rent listings in rental searches. When off, only entire places are included.

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

Minimum price (monthly rent for rentals, total price for sales/sold)

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

Maximum price (monthly rent for rentals, total price for sales/sold)

## `daysOnZillow` (type: `string`):

Filter by how long listings have been on Zillow (optional)

## `sortBy` (type: `string`):

How to sort the results. Note: 'Recommended (Priority Score)' is only available for rental searches.

## `maxResultsPerLocation` (type: `integer`):

Maximum number of results to scrape per location

## Actor input object example

```json
{
  "locations": [
    "77494",
    "New York NY",
    "Travis County, TX",
    "Capitol Hill, Seattle, WA"
  ],
  "propertyType": "forRent",
  "homeTypes": [
    "singleFamily",
    "townhome"
  ],
  "showOnlyPriceReductions": false,
  "includePendingAndUnderContract": false,
  "includeAcceptingBackupOffers": false,
  "includeRoomForRent": false,
  "minPrice": 2500,
  "maxPrice": 5000,
  "maxResultsPerLocation": 1000
}
```

# Actor output Schema

## `results` (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": [
        "90210"
    ],
    "maxResultsPerLocation": 1000
};

// Run the Actor and wait for it to finish
const run = await client.actor("clearpath/zillow-zip-code-search-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": ["90210"],
    "maxResultsPerLocation": 1000,
}

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

```

## MCP server setup

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