# Zillow ZIP Code Property Scraper (`afanasenko/zillow-zip-search`) Actor Extract Zillow real estate listings by ZIP code with 70+ filters and 70+ output fields including agent contacts, price history, and property details. Pay-per-event pricing โ€” only pay for properties enriched. Free plan: up to 15 properties per run. - **URL**: https://apify.com/afanasenko/zillow-zip-search.md - **Developed by:** [Andrey Afanasenko](https://apify.com/afanasenko) (community) - **Categories:** Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Zillow ZIP Code Property Scraper [![Apify Actor](https://img.shields.io/badge/Apify-Actor-7B59FF)](https://apify.com) > *Zillow listings and agent contacts in one structured row per property โ€” search by US ZIP codes with 70+ filters and 70+ output fields.* --- ### ๐ŸŽฏ What it does You point the actor at a list of US ZIP codes and get one structured row per property in the dataset. Each row includes: - **Address & location** โ€” street, city, state, ZIP, county, neighborhood, lat/lng - **Listing data** โ€” price, status (For Sale / For Rent / Recently Sold), days on Zillow, page views, favorites, listing type - **Property details** โ€” beds, baths, square footage, lot size, year built, home type, architectural style, flooring, heating/cooling, roof, appliances, fireplaces, garage, pool, basement, view types - **Financial data** โ€” Zestimate, Rent Zestimate, price per sqft, HOA fees, property tax, price history, last sold date - **Agent contacts** โ€” agent name, email, phone, license number, broker name, broker phone - **Optional enrichment** โ€” Walk Score, Transit Score, Bike Score, full photo gallery URLs Filter the output with 70+ knobs: status, price range, beds/baths, square footage, lot size, year built, home type (single family / townhouse / condo / multi-family / manufactured / lot-land), days on Zillow, keyword search, school ratings, listing type (FSBO / agent / new construction / auction / foreclosure), property features (pool, garage, view, basement, 3D tour, waterfront, accessibility), and rental-specific filters (pets, parking, furnished, in-unit laundry, lease length, utilities). --- ### โšก Quick start Minimal input โ€” search Austin TX 78704 for For Sale listings: ```json { "zipCodes": ["78704"], "status_type": "ForSale", "maxPropertiesPerZip": 50 } ```` That run produces ~50 rows, one per property, with the default 70+ output columns. *** ### ๐Ÿ“ฆ Output sample A full row from a real run (Austin TX 78747, For Sale, single-family). All 74 columns shown; only the narrative `propertyDescription` and the long `priceHistory` array are condensed for readability. ```json { "zpid": "119617641", "hdpUrl": "https://www.zillow.com/homedetails/10124-Pinnacle-Crest-Loop-Austin-TX-78747/119617641_zpid/", "price": 375000, "status": "FOR_SALE", "propertyDescription": "Tucked away on a quiet street in popular South Austin, this beautifully upgraded home offers ... (full description ~2000 chars)", "homeType": "SINGLE_FAMILY", "latitude": 30.140326, "longitude": -97.76442, "lotAreaValue": "4,843 sqft", "lotAreaUnit": "sqft", "priceChange": null, "datePriceChanged": null, "has3DModel": false, "hasVideo": false, "pageViewCount": 2172, "favoriteCount": 137, "listingType": "FSBA", "streetAddress": "10124 Pinnacle Crest Loop", "city": "Austin", "state": "TX", "zipcode": "78747", "county": "Travis County", "neighborhood": null, "agentName": "Hillary Smith", "agentEmail": "hillary@homesmithatx.com", "agentEmailSource": "agent_profile_direct", "cellPhone": "512-585-1947", "coAgentName": null, "coAgentNumber": null, "agentLicenseNumber": null, "brokerName": "HOMESMITH REALTY, LLC", "brokerPhoneNumber": "(512) 585-1947", "zestimate": null, "rentZestimate": null, "pricePerSqft": 157, "hoaFee": 47, "propertyTax": 7749, "bedrooms": 5, "bathrooms": 3, "bathroomsFull": 3, "bathroomsHalf": null, "livingArea": 2385, "lotSize": "4,843 sqft", "yearBuilt": 2014, "stories": 2, "architecturalStyle": null, "parcelNumber": "04430309070000", "view": "None", "heating": "Central", "cooling": "Ceiling Fan(s), Central Air", "appliances": "Dishwasher, Dryer, Gas Range, Microwave, Refrigerator, Washer", "flooring": "Carpet, Vinyl", "roofType": "Composition, Shingle", "laundryFeatures": null, "fireplaceFeatures": "None", "communityFeatures": null, "hasPool": true, "hasGarage": true, "garageSpaces": null, "parking": null, "hasBasement": false, "daysOnZillow": "6 days", "openHouseSchedule": "", "lastSoldDate": null, "lastSoldPrice": null, "lastTaxPaid": 7749.95, "lastTaxAssessedValue": 378695, "priceHistory": [ { "date": "2026-04-30", "price": 375000, "event": "Listed for sale", "pricePerSquareFoot": 157, "source": "Unlock MLS", "postingIsRental": false }, { "date": "2022-11-16", "price": 2450, "event": "Listed for rent", "pricePerSquareFoot": 1, "source": "Zillow Rental Manager", "postingIsRental": true }, { "date": "2022-10-01", "price": 500000, "event": "Price change", "pricePerSquareFoot": 210, "source": "Unlock MLS", "postingIsRental": false } /* ... 22 more historical entries (price changes, listings, removals back to 2017) */ ], "schools": [ { "distance": 1.3, "name": "Blazier Elementary School", "rating": 5, "level": "Primary", "studentsPerTeacher": null, "assigned": null, "grades": "PK-6", "link": "https://www.greatschools.org/texas/austin/10788-Blazier-Elementary-School/", "type": "Public", "size": null, "totalCount": null, "isAssigned": null }, { "distance": 3.3, "name": "Paredes Middle School", "rating": 2, "level": "Middle", "studentsPerTeacher": null, "assigned": null, "grades": "6-8", "link": "https://www.greatschools.org/texas/austin/9472-Paredes-Middle-School/", "type": "Public", "size": null, "totalCount": null, "isAssigned": null }, { "distance": 2.2, "name": "Akins High School", "rating": 4, "level": "High", "studentsPerTeacher": null, "assigned": null, "grades": "9-12", "link": "https://www.greatschools.org/texas/austin/9663-Akins-High-School/", "type": "Public", "size": null, "totalCount": null, "isAssigned": null } ], "mainPhoto": "https://photos.zillowstatic.com/fp/b7a661227b8e215ae7cd331817f37a34-p_d.jpg", "photos": ["https://photos.zillowstatic.com/fp/b7a661227b8e215ae7cd331817f37a34-p_d.jpg"], "walkScore": null, "transitScore": null, "bikeScore": null } ``` Notes on the sample above: - **`zestimate` / `rentZestimate` `null`** โ€” Zillow doesn't always publish a Zestimate on every listing. - **`agentLicenseNumber` `null`** โ€” not every brokerage exposes the license number on the listing page. - **`photos` array has 1 entry** โ€” that's because this sample run had `enrichPhotos: false`. With `enrichPhotos: true` you get the full gallery (typically 20โ€“60 URLs). - **`walkScore` / `transitScore` / `bikeScore` `null`** โ€” those populate only when you set `enrichWalkScore: true`. *** ### ๐Ÿงญ When to use it - **Real-estate lead generation** โ€” collect agent emails + phones across a target metro by ZIP-code coverage. - **Market research** โ€” pull all For Sale / Recently Sold properties in a geo for a price/sqft analysis. - **Brokerage outreach** โ€” segment by listing type (FSBO, new construction, auction, foreclosure) and contact the listing agent. - **Rental sourcing** โ€” find For Rent listings with specific filters (pet policy, parking, furnished). - **Price tracking** โ€” re-run weekly across the same ZIPs to track price changes + days on market. *** ### ๐Ÿ›  Input The actor accepts 70+ input fields. The most-used: - **`zipCodes`** *(required, array of strings)* โ€” US ZIP codes to search. Up to 5 ZIPs are bundled per upstream search batch automatically. Free plan: up to 20 ZIPs per run. - **`maxPropertiesPerZip`** *(integer, default 0=unlimited)* โ€” cap properties returned per search batch. - **`status_type`** *(enum, default ForSale)* โ€” `ForSale` / `ForRent` / `RecentlySold`. - **`price_min`** / **`price_max`** *(integer)* โ€” for sale / sold listings. - **`rentMinPrice`** / **`rentMaxPrice`** *(integer)* โ€” for rent only. - **`beds_min`** / **`beds_max`** / **`baths_min`** / **`baths_max`** - **`sqft_min`** / **`sqft_max`** / **`lotSize_min`** / **`lotSize_max`** / **`built_min`** / **`built_max`** - **`doz`** โ€” days on Zillow (`1`, `7`, `14`, `30`, `90`). - **`sort`** โ€” `Newest`, `Highest_Price`, `Lowest_Price`, `Bedrooms`, `Square_Feet`, `Lot_Size`, `Year_Built`, `Days_on_Zillow`. - **`keywords`** *(string)* โ€” free-text keyword filter (`"pool, hardwood floors"`). - **Home types** โ€” `isSingleFamily`, `isTownhouse`, `isMultiFamily`, `isCondo`, `isLotLand`, `isApartment`, `isManufactured`. - **Listing types** โ€” `isForSaleByOwner`, `isForSaleByAgent`, `isNewConstruction`, `isAuction`, `isForSaleForeclosure`, `includeForeclosed`, `includePreForeclosure`. - **Property features** โ€” `hasGarage`, `hoa_max`, `hasPool`, `hasAirConditioning`, `isWaterfront`, `isBasementFinished`, `isCityView`, `isMountainView`, `isParkView`, `isWaterView`, `is3dHome`, `isOpenHousesOnly`. - **Rental features** โ€” `largeDogsAllowed`, `smallDogsAllowed`, `catsAllowed`, `noPets`, `parkingAvailable`, `inUnitLaundry`, `furnished`, `hardwoodFloor`, `utilitiesIncluded`, `disabledAccess`, `shortTermLease`, `outdoorSpace`, `controlledAccess`, `highSpeedInternet`, `elevator`, `acceptsApplications`, `incomeRestricted`. - **Schools** โ€” `schools` (Public/Private/Charter), `schoolsRating` (1โ€“10), `includeUnratedSchools`. - **Enrichment** โ€” `enrichWalkScore` (Walk/Transit/Bike scores), `enrichPhotos` (full photo gallery URLs). See the **Input** tab in Apify Console for the full list with descriptions, types, defaults, and examples. *** ### ๐Ÿ’ฐ Pricing | Event | Tier | Price | |---|---|---| | **Property Data Enriched** *(primary)* | FREE | $0.08 | | | BRONZE | $0.07 | | | SILVER | $0.06 | | | GOLD | $0.05 | | | PLATINUM | $0.05 | | | DIAMOND | $0.05 | | **Actor Start** *(one-time per run)* | all tiers | $0.00005 / GB of memory | You only pay for properties that were successfully enriched (full property + agent + history data fetched). Search-and-skip properties (filtered out by your input filters before enrichment) are free. **Examples (FREE tier):** - 10 properties enriched โ†’ ~$0.80 - 100 properties enriched โ†’ ~$8.00 - 1,000 properties enriched โ†’ ~$80.00 *** ### ๐Ÿ†“ Free vs paid plan | | Free plan | Paid plan | |---|---|---| | Properties per run | up to **15** | unlimited | | ZIP codes per run | up to **20** | unlimited | | Per-run budget ceiling | **$1.20** | unlimited | | Agent email visibility | domain masked (`name@xxx`) | full email | | All other filters + features | โœ… | โœ… | The first paid run unlocks unlimited properties + ZIPs + budgets + full agent emails immediately โ€” no waiting period. *** ### ๐Ÿงช Filter recipes #### Recipe 1 โ€” Single-family For Sale homes in Austin TX, $400kโ€“$900k ```json { "zipCodes": ["78704", "78745", "78751"], "status_type": "ForSale", "isSingleFamily": true, "isCondo": false, "isTownhouse": false, "price_min": 400000, "price_max": 900000, "beds_min": 3, "doz": "30", "sort": "Newest" } ``` #### Recipe 2 โ€” Recently sold luxury condos in Miami FL ```json { "zipCodes": ["33139", "33140", "33141"], "status_type": "RecentlySold", "isCondo": true, "isSingleFamily": false, "isTownhouse": false, "price_min": 1500000, "sort": "Highest_Price" } ``` #### Recipe 3 โ€” Pet-friendly furnished rentals in Brooklyn NY ```json { "zipCodes": ["11201", "11215", "11217"], "status_type": "ForRent", "rentMaxPrice": 4500, "largeDogsAllowed": true, "catsAllowed": true, "furnished": true, "inUnitLaundry": true } ``` *** ### ๐Ÿ“ก Live status & storage records Every run writes a few records to the run's Storage tab: | Key | Type | Description | |---|---|---| | `RUN_SUMMARY` | JSON | Full run statistics โ€” input, properties (found / enriched / skipped), email yield, billing, plan tier, error info if any. | | `status.html` | HTML | Auto-refreshing status page rendered live during the run. View via the **Live View** tab in Apify Console. | | `SKIPPED_ITEMS` | JSON | Per-item list of every ZIP / property skipped during the run, with reason and category (`filter`, `not_found`, `error`, `free_limit`, `not_resolvable`). Useful for debugging and re-running the error cohort. | | `FREE_LIMITS_APPLIED` | JSON | Array of `{id, message}` for every free-tier ceiling hit during this run. Empty/omitted on paid runs. | | `USER_MESSAGE` | JSON | Onboarding banner shown on a paid user's 1st and 3rd paid run. Empty/omitted otherwise. | | `UNKNOWN_INPUT_KEYS` | JSON | Lists any input field names that were not part of the actor's schema (e.g. `mode`, `zpids`, `zillowUrl` โ€” fields from the parent multi-mode actor). Empty/omitted if all input keys are recognized. | *** ### ๐Ÿค– Programmatic / API use ```bash ## Start a synchronous run + read the dataset directly curl -X POST "https://api.apify.com/v2/acts/zillow-zip-search/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"zipCodes":["78704"], "status_type":"ForSale", "maxPropertiesPerZip":20}' ``` The actor also exposes its schema for MCP / agent consumption โ€” `dataset_schema.json` declares every output column with type and description, and `input_schema.json` declares every input field. *** ### โ“ FAQ #### Is it legal to scrape Zillow? Public real-estate listing data has been collected and resold for years; this actor extracts data already publicly visible to any browser visitor. You are responsible for complying with Zillow's Terms of Service and any applicable local laws when using the output (especially for outreach to listing agents). #### Why are some fields null? Not every Zillow listing has every field populated โ€” agent emails are missing on some listings, year-built is missing on new construction, lot size is missing on condos, etc. Null in the dataset means the source listing didn't expose that data. #### Can I schedule runs? Yes โ€” use Apify's built-in **Schedules** feature in the Console. Common pattern: run weekly on the same ZIP cohort to track new listings + price changes. #### What happens when a run is aborted mid-way? Properties already enriched and pushed to the dataset are persisted. The next run starts from scratch (this actor doesn't checkpoint between runs). #### How do I avoid the test-mode 10-property cap? Don't use the default ZIP `90210` with no filters. Any ZIP other than `90210` (or `90210` with at least one filter set) runs at the normal property cap for your plan. #### Why does my paid run still show free-plan limits? Confirm the run was started under your paid plan (the `RUN_SUMMARY.plan` field will say `paid`). API-origin runs sometimes hit a stale auth context โ€” re-running through Console should resolve. #### Can I do ZPID lookups or paste a Zillow search URL? Not in this actor. This is the **single-mode ZIP search** version. For ZPID or URL inputs, use the parent actor [`zillow-property-agent-data-scraper`](https://apify.com/afanasenko/zillow-property-agent-data-scraper) which supports all three modes (ZIP / ZPID / URL). *** ### ๐Ÿ”— Related actors | You want to scrape Zillow byโ€ฆ | Use this actor | |---|---| | Multi-mode (ZIP + ZPID + URL) โ€” full flexibility | [zillow-property-agent-data-scraper](https://apify.com/afanasenko/zillow-property-agent-data-scraper) | | ZIP code only โ€” simpler input, single-mode | **This actor** | | Search URL โ€” paste any Zillow search page | [zillow-url-search](https://apify.com/afanasenko/zillow-url-search) | | MCP server โ€” connect Claude Desktop / Cursor / ChatGPT to Zillow tools | [zillow-mcp-server](https://apify.com/afanasenko/zillow-mcp-server) | *** ### ๐Ÿ›Ÿ Support & feedback - **Bug or unexpected behavior?** Open an Issue in the actor's Issues tab. - **Feature request?** Same place โ€” drop a one-paragraph note describing your use case. - **Star ratings + reviews** in the Apify Store help others find the actor. *** ### โš–๏ธ Disclaimer This actor extracts data already publicly displayed on Zillow's website. It is provided "as-is" without warranty. You are responsible for complying with Zillow's Terms of Service and any applicable laws (including data-protection rules like CAN-SPAM, GDPR, CCPA) when using the extracted data, especially for outreach to agents and brokers. # Actor input Schema ## `zipCodes` (type: `array`): Enter a list of US ZIP codes to search. You can search up to 5 ZIP codes at once per batch (the actor batches automatically). Free plan: up to 20 ZIP codes per run. ## `maxPropertiesPerZip` (type: `integer`): Limit how many properties to process from each search batch. Set to 0 for unlimited. Free plan: maximum 15 properties, 20 ZIP codes per run. ## `status_type` (type: `string`): Filter properties by their listing status. ## `price_min` (type: `integer`): For Sale/Sold properties. ## `price_max` (type: `integer`): For Sale/Sold properties. ## `rentMinPrice` (type: `integer`): For Rent properties. ## `rentMaxPrice` (type: `integer`): For Rent properties. ## `beds_min` (type: `integer`): Minimum number of bedrooms. ## `beds_max` (type: `integer`): Maximum number of bedrooms (0 for any). ## `baths_min` (type: `integer`): Minimum number of bathrooms. ## `baths_max` (type: `integer`): Maximum number of bathrooms (0 for any). ## `doz` (type: `string`): Filter by how recently the property was listed or sold. ## `sort` (type: `string`): Choose how to sort the search results. ## `keywords` (type: `string`): e.g., 'pool, ocean view' ## `isSingleFamily` (type: `boolean`): Include single-family homes. ## `isTownhouse` (type: `boolean`): Include townhouses. ## `isMultiFamily` (type: `boolean`): Include multi-family properties. ## `isCondo` (type: `boolean`): Include condos and co-ops. ## `isLotLand` (type: `boolean`): Include lots and land. ## `isApartment` (type: `boolean`): Include apartments (primarily for rentals). ## `isManufactured` (type: `boolean`): Include manufactured homes. ## `isForSaleByOwner` (type: `boolean`): Include For Sale By Owner listings. ## `isForSaleByAgent` (type: `boolean`): Include agent-listed properties. ## `isNewConstruction` (type: `string`): 'Any' shows all, 'Only' shows only new construction, 'Exclude' hides new construction. ## `isAuction` (type: `string`): 'Any' shows all, 'Only' shows only auctions, 'Exclude' hides auctions. ## `isForSaleForeclosure` (type: `string`): 'Any' shows all, 'Only' shows only foreclosures, 'Exclude' hides foreclosures. ## `includeForeclosed` (type: `boolean`): Add foreclosed properties to results (excluded by default). ## `includePreForeclosure` (type: `boolean`): Add pre-foreclosure properties to results (excluded by default). ## `isPendingUnderContract` (type: `boolean`): Only include properties that are pending or under contract. ## `isAcceptingBackupOffers` (type: `boolean`): Only include properties accepting backup offers. ## `sqft_min` (type: `integer`): Minimum property size in square feet. ## `sqft_max` (type: `integer`): Maximum property size in square feet. ## `lotSize_min` (type: `string`): Minimum lot size. ## `lotSize_max` (type: `string`): Maximum lot size. ## `built_min` (type: `integer`): Earliest year of construction. ## `built_max` (type: `integer`): Latest year of construction. ## `parkingSpots_min` (type: `integer`): Minimum number of parking spots. ## `hasGarage` (type: `boolean`): Only include properties with a garage. ## `hoa_max` (type: `integer`): Maximum monthly HOA fee. ## `hasPool` (type: `boolean`): Only include properties with a pool. ## `hasAirConditioning` (type: `boolean`): Only include properties with air conditioning. ## `isWaterfront` (type: `boolean`): Only include waterfront properties. ## `isBasementFinished` (type: `boolean`): Only include properties with a finished basement. ## `isBasementUnfinished` (type: `boolean`): Only include properties with an unfinished basement. ## `isCityView` (type: `boolean`): Only properties with a city view. ## `isMountainView` (type: `boolean`): Only properties with a mountain view. ## `isParkView` (type: `boolean`): Only properties with a park view. ## `isWaterView` (type: `boolean`): Only properties with a water view. ## `isOpenHousesOnly` (type: `boolean`): Only include properties with scheduled open houses. ## `is3dHome` (type: `boolean`): Only include properties with a 3D tour. ## `largeDogsAllowed` (type: `boolean`): Only rentals that allow large dogs. ## `smallDogsAllowed` (type: `boolean`): Only rentals that allow small dogs. ## `catsAllowed` (type: `boolean`): Only rentals that allow cats. ## `noPets` (type: `boolean`): Only rentals that do not allow pets. ## `inUnitLaundry` (type: `boolean`): Only rentals with in-unit laundry. ## `parkingAvailable` (type: `boolean`): Only rentals with on-site parking. ## `furnished` (type: `boolean`): Only furnished rentals. ## `hardwoodFloor` (type: `boolean`): Only rentals with hardwood floors. ## `utilitiesIncluded` (type: `boolean`): Only rentals with utilities included. ## `disabledAccess` (type: `boolean`): Only rentals with disabled access. ## `shortTermLease` (type: `boolean`): Only rentals with short term lease available. ## `outdoorSpace` (type: `boolean`): Only rentals with outdoor space. ## `controlledAccess` (type: `boolean`): Only rentals with controlled access. ## `highSpeedInternet` (type: `boolean`): Only rentals with high speed internet. ## `elevator` (type: `boolean`): Only rentals with elevator access. ## `acceptsApplications` (type: `boolean`): Only rentals accepting Zillow applications. ## `incomeRestricted` (type: `boolean`): Only income-restricted rentals. ## `schools` (type: `string`): Filter by nearby school types (comma-separated: elementary, middle, high, public, private, charter). ## `schoolsRating` (type: `integer`): Minimum school rating (1-10). ## `includeUnratedSchools` (type: `boolean`): Include schools with no rating in the search. ## `enrichWalkScore` (type: `boolean`): Enrich results with Walk, Transit, and Bike scores for each property. ## `enrichPhotos` (type: `boolean`): Get the complete photo gallery for each property. By default, only the main photo is included. ## Actor input object example ```json { "zipCodes": [ "90210" ], "maxPropertiesPerZip": 0, "status_type": "ForSale", "price_min": 0, "price_max": 0, "rentMinPrice": 0, "rentMaxPrice": 0, "beds_min": 0, "beds_max": 0, "baths_min": 0, "baths_max": 0, "doz": "any", "sort": "Homes_for_You", "keywords": "", "isSingleFamily": true, "isTownhouse": true, "isMultiFamily": false, "isCondo": true, "isLotLand": false, "isApartment": true, "isManufactured": false, "isForSaleByOwner": false, "isForSaleByAgent": true, "isNewConstruction": "any", "isAuction": "any", "isForSaleForeclosure": "any", "includeForeclosed": false, "includePreForeclosure": false, "isPendingUnderContract": false, "isAcceptingBackupOffers": false, "sqft_min": 0, "sqft_max": 0, "lotSize_min": "", "lotSize_max": "", "built_min": 0, "built_max": 0, "parkingSpots_min": 0, "hasGarage": false, "hoa_max": 0, "hasPool": false, "hasAirConditioning": false, "isWaterfront": false, "isBasementFinished": false, "isBasementUnfinished": false, "isCityView": false, "isMountainView": false, "isParkView": false, "isWaterView": false, "isOpenHousesOnly": false, "is3dHome": false, "largeDogsAllowed": false, "smallDogsAllowed": false, "catsAllowed": false, "noPets": false, "inUnitLaundry": false, "parkingAvailable": false, "furnished": false, "hardwoodFloor": false, "utilitiesIncluded": false, "disabledAccess": false, "shortTermLease": false, "outdoorSpace": false, "controlledAccess": false, "highSpeedInternet": false, "elevator": false, "acceptsApplications": false, "incomeRestricted": false, "schools": "", "schoolsRating": 0, "includeUnratedSchools": true, "enrichWalkScore": false, "enrichPhotos": false } ``` # Actor output Schema ## `liveStatus` (type: `string`): No description ## `results` (type: `string`): No description ## `runSummary` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("afanasenko/zillow-zip-search").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("afanasenko/zillow-zip-search").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call afanasenko/zillow-zip-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=afanasenko/zillow-zip-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow ZIP Code Property Scraper", "description": "Extract Zillow real estate listings by ZIP code with 70+ filters and 70+ output fields including agent contacts, price history, and property details. Pay-per-event pricing โ€” only pay for properties enriched. Free plan: up to 15 properties per run.", "version": "0.0", "x-build-id": "AV3QPtoTLye8zV5NL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/afanasenko~zillow-zip-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-afanasenko-zillow-zip-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/afanasenko~zillow-zip-search/runs": { "post": { "operationId": "runs-sync-afanasenko-zillow-zip-search", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/afanasenko~zillow-zip-search/run-sync": { "post": { "operationId": "run-sync-afanasenko-zillow-zip-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "zipCodes" ], "properties": { "zipCodes": { "title": "ZIP Codes", "type": "array", "description": "Enter a list of US ZIP codes to search. You can search up to 5 ZIP codes at once per batch (the actor batches automatically). Free plan: up to 20 ZIP codes per run.", "default": [ "90210" ], "items": { "type": "string" } }, "maxPropertiesPerZip": { "title": "Max Properties per Search", "type": "integer", "description": "Limit how many properties to process from each search batch. Set to 0 for unlimited. Free plan: maximum 15 properties, 20 ZIP codes per run.", "default": 0 }, "status_type": { "title": "Property Status", "enum": [ "ForSale", "ForRent", "RecentlySold" ], "type": "string", "description": "Filter properties by their listing status.", "default": "ForSale" }, "price_min": { "title": "Price: Minimum ($)", "type": "integer", "description": "For Sale/Sold properties.", "default": 0 }, "price_max": { "title": "Price: Maximum ($)", "type": "integer", "description": "For Sale/Sold properties.", "default": 0 }, "rentMinPrice": { "title": "Rent: Minimum ($/mo)", "type": "integer", "description": "For Rent properties.", "default": 0 }, "rentMaxPrice": { "title": "Rent: Maximum ($/mo)", "type": "integer", "description": "For Rent properties.", "default": 0 }, "beds_min": { "title": "Bedrooms: Minimum", "type": "integer", "description": "Minimum number of bedrooms.", "default": 0 }, "beds_max": { "title": "Bedrooms: Maximum", "type": "integer", "description": "Maximum number of bedrooms (0 for any).", "default": 0 }, "baths_min": { "title": "Bathrooms: Minimum", "type": "integer", "description": "Minimum number of bathrooms.", "default": 0 }, "baths_max": { "title": "Bathrooms: Maximum", "type": "integer", "description": "Maximum number of bathrooms (0 for any).", "default": 0 }, "doz": { "title": "Days on Zillow / Sold in Last", "enum": [ "any", "1", "7", "14", "30", "90", "6m", "12m" ], "type": "string", "description": "Filter by how recently the property was listed or sold.", "default": "any" }, "sort": { "title": "Sort Results By", "enum": [ "Homes_for_You", "Price_High_Low", "Price_Low_High", "Newest" ], "type": "string", "description": "Choose how to sort the search results.", "default": "Homes_for_You" }, "keywords": { "title": "Keywords", "type": "string", "description": "e.g., 'pool, ocean view'", "default": "" }, "isSingleFamily": { "title": "Houses", "type": "boolean", "description": "Include single-family homes.", "default": true }, "isTownhouse": { "title": "Townhomes", "type": "boolean", "description": "Include townhouses.", "default": true }, "isMultiFamily": { "title": "Multi-family", "type": "boolean", "description": "Include multi-family properties.", "default": false }, "isCondo": { "title": "Condos/Co-ops", "type": "boolean", "description": "Include condos and co-ops.", "default": true }, "isLotLand": { "title": "Lots/Land", "type": "boolean", "description": "Include lots and land.", "default": false }, "isApartment": { "title": "Apartments", "type": "boolean", "description": "Include apartments (primarily for rentals).", "default": true }, "isManufactured": { "title": "Manufactured", "type": "boolean", "description": "Include manufactured homes.", "default": false }, "isForSaleByOwner": { "title": "Owner Posted (FSBO)", "type": "boolean", "description": "Include For Sale By Owner listings.", "default": false }, "isForSaleByAgent": { "title": "Agent Listed", "type": "boolean", "description": "Include agent-listed properties.", "default": true }, "isNewConstruction": { "title": "New Construction", "enum": [ "any", "only", "exclude" ], "type": "string", "description": "'Any' shows all, 'Only' shows only new construction, 'Exclude' hides new construction.", "default": "any" }, "isAuction": { "title": "Auctions", "enum": [ "any", "only", "exclude" ], "type": "string", "description": "'Any' shows all, 'Only' shows only auctions, 'Exclude' hides auctions.", "default": "any" }, "isForSaleForeclosure": { "title": "Foreclosures", "enum": [ "any", "only", "exclude" ], "type": "string", "description": "'Any' shows all, 'Only' shows only foreclosures, 'Exclude' hides foreclosures.", "default": "any" }, "includeForeclosed": { "title": "Include Foreclosed", "type": "boolean", "description": "Add foreclosed properties to results (excluded by default).", "default": false }, "includePreForeclosure": { "title": "Include Pre-Foreclosure", "type": "boolean", "description": "Add pre-foreclosure properties to results (excluded by default).", "default": false }, "isPendingUnderContract": { "title": "Pending & Under Contract", "type": "boolean", "description": "Only include properties that are pending or under contract.", "default": false }, "isAcceptingBackupOffers": { "title": "Accepting Backup Offers", "type": "boolean", "description": "Only include properties accepting backup offers.", "default": false }, "sqft_min": { "title": "Square Feet: Minimum", "type": "integer", "description": "Minimum property size in square feet.", "default": 0 }, "sqft_max": { "title": "Square Feet: Maximum", "type": "integer", "description": "Maximum property size in square feet.", "default": 0 }, "lotSize_min": { "title": "Lot Size: Minimum", "enum": [ "", "1,000 sqft", "2,000 sqft", "5,000 sqft", "1/4 acre/10,890 sqft", "1/2 acre/21,780 sqft", "1 acre/43,560 sqft" ], "type": "string", "description": "Minimum lot size.", "default": "" }, "lotSize_max": { "title": "Lot Size: Maximum", "enum": [ "", "2,000 sqft", "5,000 sqft", "1/4 acre/10,890 sqft", "1/2 acre/21,780 sqft", "1 acre/43,560 sqft", "5 acres/217,800 sqft" ], "type": "string", "description": "Maximum lot size.", "default": "" }, "built_min": { "title": "Year Built: Minimum", "type": "integer", "description": "Earliest year of construction.", "default": 0 }, "built_max": { "title": "Year Built: Maximum", "type": "integer", "description": "Latest year of construction.", "default": 0 }, "parkingSpots_min": { "title": "Minimum Parking Spots", "type": "integer", "description": "Minimum number of parking spots.", "default": 0 }, "hasGarage": { "title": "Must Have Garage", "type": "boolean", "description": "Only include properties with a garage.", "default": false }, "hoa_max": { "title": "Maximum HOA Fee ($/month)", "type": "integer", "description": "Maximum monthly HOA fee.", "default": 0 }, "hasPool": { "title": "Must Have Pool", "type": "boolean", "description": "Only include properties with a pool.", "default": false }, "hasAirConditioning": { "title": "Must Have A/C", "type": "boolean", "description": "Only include properties with air conditioning.", "default": false }, "isWaterfront": { "title": "Waterfront", "type": "boolean", "description": "Only include waterfront properties.", "default": false }, "isBasementFinished": { "title": "Finished Basement", "type": "boolean", "description": "Only include properties with a finished basement.", "default": false }, "isBasementUnfinished": { "title": "Unfinished Basement", "type": "boolean", "description": "Only include properties with an unfinished basement.", "default": false }, "isCityView": { "title": "City View", "type": "boolean", "description": "Only properties with a city view.", "default": false }, "isMountainView": { "title": "Mountain View", "type": "boolean", "description": "Only properties with a mountain view.", "default": false }, "isParkView": { "title": "Park View", "type": "boolean", "description": "Only properties with a park view.", "default": false }, "isWaterView": { "title": "Water View", "type": "boolean", "description": "Only properties with a water view.", "default": false }, "isOpenHousesOnly": { "title": "Must Have Open House", "type": "boolean", "description": "Only include properties with scheduled open houses.", "default": false }, "is3dHome": { "title": "Must Have 3D Tour", "type": "boolean", "description": "Only include properties with a 3D tour.", "default": false }, "largeDogsAllowed": { "title": "Allows Large Dogs", "type": "boolean", "description": "Only rentals that allow large dogs.", "default": false }, "smallDogsAllowed": { "title": "Allows Small Dogs", "type": "boolean", "description": "Only rentals that allow small dogs.", "default": false }, "catsAllowed": { "title": "Allows Cats", "type": "boolean", "description": "Only rentals that allow cats.", "default": false }, "noPets": { "title": "No Pets", "type": "boolean", "description": "Only rentals that do not allow pets.", "default": false }, "inUnitLaundry": { "title": "In-Unit Laundry", "type": "boolean", "description": "Only rentals with in-unit laundry.", "default": false }, "parkingAvailable": { "title": "On-Site Parking", "type": "boolean", "description": "Only rentals with on-site parking.", "default": false }, "furnished": { "title": "Furnished", "type": "boolean", "description": "Only furnished rentals.", "default": false }, "hardwoodFloor": { "title": "Hardwood Floors", "type": "boolean", "description": "Only rentals with hardwood floors.", "default": false }, "utilitiesIncluded": { "title": "Utilities Included", "type": "boolean", "description": "Only rentals with utilities included.", "default": false }, "disabledAccess": { "title": "Disabled Access", "type": "boolean", "description": "Only rentals with disabled access.", "default": false }, "shortTermLease": { "title": "Short Term Lease", "type": "boolean", "description": "Only rentals with short term lease available.", "default": false }, "outdoorSpace": { "title": "Outdoor Space", "type": "boolean", "description": "Only rentals with outdoor space.", "default": false }, "controlledAccess": { "title": "Controlled Access", "type": "boolean", "description": "Only rentals with controlled access.", "default": false }, "highSpeedInternet": { "title": "High Speed Internet", "type": "boolean", "description": "Only rentals with high speed internet.", "default": false }, "elevator": { "title": "Elevator", "type": "boolean", "description": "Only rentals with elevator access.", "default": false }, "acceptsApplications": { "title": "Accepts Zillow Applications", "type": "boolean", "description": "Only rentals accepting Zillow applications.", "default": false }, "incomeRestricted": { "title": "Income Restricted", "type": "boolean", "description": "Only income-restricted rentals.", "default": false }, "schools": { "title": "School Types", "type": "string", "description": "Filter by nearby school types (comma-separated: elementary, middle, high, public, private, charter).", "default": "" }, "schoolsRating": { "title": "Minimum School Rating", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum school rating (1-10).", "default": 0 }, "includeUnratedSchools": { "title": "Include Unrated Schools", "type": "boolean", "description": "Include schools with no rating in the search.", "default": true }, "enrichWalkScore": { "title": "Fetch Walk/Transit Scores", "type": "boolean", "description": "Enrich results with Walk, Transit, and Bike scores for each property.", "default": false }, "enrichPhotos": { "title": "Fetch All Property Photos", "type": "boolean", "description": "Get the complete photo gallery for each property. By default, only the main photo is included.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```