# Zillow Property Scraper (`h4sh/zillow-scraper`) Actor Scrape Zillow for property listings with prices, Zestimates, tax history, agent info, photos and 30+ data fields. Anti-bot bypass included. - **URL**: https://apify.com/h4sh/zillow-scraper.md - **Developed by:** [Dominique](https://apify.com/h4sh) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results 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/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 Property Scraper 🏠 **The most comprehensive Zillow scraper on Apify** — extract 30+ data fields including prices, Zestimates, price history, tax records, agent info, and photos from any Zillow listing. ### 🏆 Why This Actor? | Feature | This Actor | Competitors | |---------|-----------|-------------| | **Data Fields** | 30+ fields | 10-15 fields | | **Price History** | ✅ Full history | ❌ Not available | | **Tax History** | ✅ Full records | ❌ Not available | | **Agent/Broker Info** | ✅ Name, phone, broker | ❌ Limited | | **Photo URLs** | ✅ Up to 50 photos | ❌ 1 thumbnail | | **Input Modes** | Search URL, ZIP code, direct links | ZIP code only | | **Anti-Bot Bypass** | ✅ Camoufox stealth browser | Basic requests | | **Proxy Support** | ✅ Residential (required) | Datacenter (blocked) | | **Price per 1K** | **$2.00** | $3.00-5.00 | ### ✨ Key Features - 🏠 **30+ Data Fields** — Address, price, Zestimate, beds, baths, sqft, lot size, year built, property type, and more - 💰 **Price & Tax History** — Full price change history and property tax records - 📸 **Photo URLs** — Extract up to 50 high-resolution property photo URLs per listing - 👤 **Agent & Broker Info** — Listing agent name, phone number, and brokerage - 🔍 **Flexible Input** — Search by URL, ZIP code, or paste direct property links - 🛡️ **Anti-Bot Bypass** — Camoufox stealth browser defeats Zillow's Incapsula protection - 📊 **Search + Detail Modes** — Quick search results or full detail scraping with all fields ### 📥 Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchUrls` | Array | — | Zillow search result URLs (go to zillow.com, search, paste URL) | | `zipCodes` | Array | — | US ZIP codes to search (e.g., "10001", "90210") | | `propertyUrls` | Array | — | Direct property detail page URLs | | `listingType` | String | `for_sale` | Listing type: `for_sale`, `for_rent`, or `sold` | | `maxItems` | Integer | `100` | Maximum properties to scrape (0 = unlimited) | | `maxPages` | Integer | `5` | Max search result pages per URL/ZIP | | `scrapeDetails` | Boolean | `true` | Visit each listing for full details (slower but more data) | | `proxyConfiguration` | Object | Residential | Proxy settings (residential proxies REQUIRED) | #### Input Examples **Search by URL** (recommended): ```json { "searchUrls": [ { "url": "https://www.zillow.com/new-york-ny/" } ], "maxItems": 50, "scrapeDetails": true } ```` **Search by ZIP code**: ```json { "zipCodes": ["10001", "10002", "10003"], "listingType": "for_sale", "maxItems": 100 } ``` **Direct property URLs**: ```json { "propertyUrls": [ { "url": "https://www.zillow.com/homedetails/123-Main-St-New-York-NY-10001/12345678_zpid/" } ] } ``` ### 📤 Sample Output ```json { "zpid": "12345678", "url": "https://www.zillow.com/homedetails/123-Main-St-New-York-NY-10001/12345678_zpid/", "address": "123 Main St", "city": "New York", "state": "NY", "zipCode": "10001", "price": 850000, "zestimate": 875000, "rentZestimate": 3500, "bedrooms": 3, "bathrooms": 2.0, "livingArea": 1450, "lotSize": "2,500 sqft", "yearBuilt": 1985, "propertyType": "SingleFamily", "listingStatus": "FOR_SALE", "daysOnZillow": 12, "mlsId": "MLS-12345", "hoaFee": "$150/mo", "description": "Beautifully renovated 3-bedroom home in the heart of Manhattan...", "latitude": 40.7128, "longitude": -74.0060, "listingAgent": "John Smith", "listingBroker": "RE/MAX Premier", "agentPhone": "(212) 555-1234", "priceHistory": [ { "date": "2024-01-15", "event": "Listed for sale", "price": 850000, "source": "MLS" }, { "date": "2023-06-20", "event": "Sold", "price": 780000, "source": "Public Record" } ], "taxHistory": [ { "year": "2023", "taxPaid": 8500, "value": 750000 }, { "year": "2022", "taxPaid": 8200, "value": 720000 } ], "photos": [ "https://photos.zillowstatic.com/fp/abc123.jpg", "https://photos.zillowstatic.com/fp/def456.jpg" ], "parking": "Attached Garage, 2 spaces", "heating": "Forced Air, Gas", "cooling": "Central Air", "appliances": "Dishwasher, Microwave, Refrigerator, Washer, Dryer", "pageViews": 1250, "favoriteCount": 45, "datePosted": "2024-01-15", "scrapedAt": "2024-03-30T12:00:00+00:00" } ``` ### 💡 Use Cases - **🏠 Real Estate Investment** — Analyze property prices, Zestimates, and price trends across ZIP codes to find undervalued properties - **📊 Market Analysis** — Track days on market, price reductions, and listing activity for competitive market reports - **📈 Price Monitoring** — Monitor price changes and new listings in target neighborhoods - **🏗️ Property Research** — Bulk extract property details, tax history, and photos for research databases - **👤 Agent/Broker Data** — Build databases of active real estate agents and brokers in specific markets - **📉 Tax Assessment** — Compare tax history and assessed values across properties for investment decisions ### 💲 Pricing - **$2.00 per 1,000 results** — the most affordable comprehensive Zillow scraper on Apify - Platform usage fees apply (compute + proxy) - Residential proxies required (~$0.50/1K requests) - Estimated cost: ~$3-4 per 1,000 full-detail property extractions ### ⚙️ Technical Notes - **Anti-bot**: Zillow uses Incapsula/Imperva WAF. This actor uses Camoufox stealth browser with residential proxies to bypass it reliably. - **Rate limiting**: The actor includes randomized delays and human-like scrolling to avoid detection. - **Data source**: Extracts from `__NEXT_DATA__` embedded JSON (primary) with HTML selectors as fallback. - **Proxy requirement**: Residential proxies are **required**. Datacenter proxies will be blocked immediately. ### 🔗 Related Actors - [Cars.com Scraper](https://apify.com/h4sh/carscom-scraper) — Scrape vehicle listings from Cars.com - [AutoTrader Scraper](https://apify.com/h4sh/autotrader-scraper) — Extract car listings from AutoTrader - [GoodRx Drug Price Scraper](https://apify.com/h4sh/goodrx-drug-price-scraper) — Compare prescription drug prices - [Etsy Scraper](https://apify.com/h4sh/etsy-scraper) — Scrape product listings from Etsy - [Poshmark Scraper](https://apify.com/h4sh/poshmark-scraper) — Extract fashion listings from Poshmark - [Vinted Scraper](https://apify.com/h4sh/vinted-scraper) — Scrape secondhand clothing from Vinted - [ZocDoc Doctor Finder](https://apify.com/h4sh/zocdoc-doctor-finder) — Find doctors and healthcare providers # Actor input Schema ## `searchUrls` (type: `array`): Zillow search result URLs. Go to zillow.com, perform a search with your filters, and paste the URL here. ## `zipCodes` (type: `array`): List of US ZIP codes to search. The actor will scrape all listings in each ZIP code area. ## `propertyUrls` (type: `array`): Direct Zillow property detail page URLs (e.g., https://www.zillow.com/homedetails/...). ## `listingType` (type: `string`): Type of listings to scrape. ## `maxItems` (type: `integer`): Maximum number of properties to scrape. Set 0 for unlimited. ## `maxPages` (type: `integer`): Maximum number of search result pages to scrape per search URL/ZIP code. ## `scrapeDetails` (type: `boolean`): Visit each property page to extract full details (price history, tax history, description, photos). Slower but more data. ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies are REQUIRED for Zillow (Incapsula anti-bot). ## Actor input object example ```json { "searchUrls": [ { "url": "https://www.zillow.com/new-york-ny/" } ], "zipCodes": [ "10001", "90210", "60601" ], "listingType": "for_sale", "maxItems": 100, "maxPages": 5, "scrapeDetails": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `zillowProperties` (type: `string`): Dataset containing scraped property listings with prices, Zestimates, price history, tax history, agent info, photos, and 30+ data fields. # 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 = { "searchUrls": [ { "url": "https://www.zillow.com/new-york-ny/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("h4sh/zillow-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchUrls": [{ "url": "https://www.zillow.com/new-york-ny/" }] } # Run the Actor and wait for it to finish run = client.actor("h4sh/zillow-scraper").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 '{ "searchUrls": [ { "url": "https://www.zillow.com/new-york-ny/" } ] }' | apify call h4sh/zillow-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=h4sh/zillow-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow Property Scraper", "description": "Scrape Zillow for property listings with prices, Zestimates, tax history, agent info, photos and 30+ data fields. Anti-bot bypass included.", "version": "0.1", "x-build-id": "nhHAcdenkG1up8F4r" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/h4sh~zillow-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-h4sh-zillow-scraper", "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/h4sh~zillow-scraper/runs": { "post": { "operationId": "runs-sync-h4sh-zillow-scraper", "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/h4sh~zillow-scraper/run-sync": { "post": { "operationId": "run-sync-h4sh-zillow-scraper", "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", "properties": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Zillow search result URLs. Go to zillow.com, perform a search with your filters, and paste the URL here.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "zipCodes": { "title": "ZIP Codes", "type": "array", "description": "List of US ZIP codes to search. The actor will scrape all listings in each ZIP code area.", "items": { "type": "string" } }, "propertyUrls": { "title": "Property URLs", "type": "array", "description": "Direct Zillow property detail page URLs (e.g., https://www.zillow.com/homedetails/...).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingType": { "title": "Listing Type", "enum": [ "for_sale", "for_rent", "sold" ], "type": "string", "description": "Type of listings to scrape.", "default": "for_sale" }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of properties to scrape. Set 0 for unlimited.", "default": 100 }, "maxPages": { "title": "Max Pages", "minimum": 1, "type": "integer", "description": "Maximum number of search result pages to scrape per search URL/ZIP code.", "default": 5 }, "scrapeDetails": { "title": "Scrape Full Details", "type": "boolean", "description": "Visit each property page to extract full details (price history, tax history, description, photos). Slower but more data.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are REQUIRED for Zillow (Incapsula anti-bot).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```