# Zillow All-in-One Scraper (`xtracto/zillow-all-in-one-scraper`) Actor Scrape Zillow listings, property details, photos, agents, price history, and tax history - all in one actor. Search by URL, map area, or filter state. - **URL**: https://apify.com/xtracto/zillow-all-in-one-scraper.md - **Developed by:** [Xtractoo](https://apify.com/xtracto) (community) - **Categories:** Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 All-in-One Scraper **Listings, full property details, photos, agents, price history, and tax history -- in one actor.** Point it at a city, a neighborhood, a map area, or a Zillow search URL. The actor returns a clean, normalized dataset row for every property: address, geo coordinates, price, beds, baths, square footage, lot size, year built, home type, full-resolution photo URLs, the listing agent's name and phone, multi-year price history, and multi-decade tax history. ### What it can do - **Search by location** -- paste any Zillow search URL or supply a map bounding box. The actor follows the same pagination Zillow's own UI uses. - **Full property details** -- every listing is enriched with the data from its detail page, not just the search-results summary. No second pass needed. - **Large areas, no truncation** -- when an area exceeds Zillow's per-query result ceiling, the actor automatically subdivides the map into smaller tiles and stitches the results back together. - **Price + tax history** -- the actor pulls the same multi-year financial history Zillow shows on each listing page (commonly 5-20+ years of tax data and the full list-of-events timeline). - **Listing agent contact** -- name, phone number, brokerage for every active listing. - **High-resolution photos** -- up to ~40 photo URLs per listing at 1152px width, ready to download. ### Use cases - Real-estate market analytics, comparable-sales modelling. - Investor lead lists -- agents, brokerages, price-change signals. - AVM training data with historical assessment values. - Neighborhood-level inventory tracking, price-drop alerts. - Building competing listing portals or filtered home-search products. ### Why use this actor - **One run, complete data.** You don't need a separate "details" scraper. Every row is fully enriched. - **Map-aware.** Drop in a bounding box and the actor handles the per-tile ceilings transparently. No "missing 60% of listings" because of pagination limits. - **Normalized output.** The dataset schema matches the [Realtor.com All-in-One Scraper](https://apify.com/xtracto/realtor-all-in-one-scraper) so the two sources can be unioned into one table downstream. - **Production-tested for Apify.** Built and verified on Apify cloud with residential proxy. The starter input below was the actual test run. ### Sample input ```json { "boundingBoxes": [ { "north": 30.31, "south": 30.27, "east": -97.72, "west": -97.78 } ], "useMapResults": true, "maxItems": 5, "maxConcurrency": 2, "maxRetries": 8, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ```` Other ways to seed: ```json { "searchUrls": [{ "url": "https://www.zillow.com/austin-tx/" }] } ``` ```json { "boundingBoxes": [{ "north": 30.45, "south": 30.15, "east": -97.55, "west": -97.95 }], "filterState": { "price": { "min": 400000, "max": 900000 }, "beds": { "min": 2 } }, "useMapResults": false } ``` ### Sample output (real data from the live Apify test run above) Three real Austin TX listings emitted from the Apify run on 2026-05-14 against bounding box `30.27/30.31, -97.78/-97.72` (East Austin / UT neighborhood): ```json { "source": "zillow", "sourceId": "29397590", "url": "https://www.zillow.com/homedetails/809-E-38th-St-Austin-TX-78705/29397590_zpid/", "address": { "line": "809 E 38th St", "city": "Austin", "state": "TX", "zip": "78705", "lat": 30.296783, "lng": -97.72628 }, "status": "FOR_SALE", "price": 950000, "currency": "USD", "beds": 4, "baths": 3, "sqft": 1765, "lotSqft": 11830, "yearBuilt": 1953, "propertyType": "SINGLE_FAMILY", "photos": [ "https://photos.zillowstatic.com/fp/c184eaedca0e0c1d671cb7aca341d9c6-cc_ft_1152.jpg", "https://photos.zillowstatic.com/fp/a12a162e0d6724c1e88cabdab47b15d4-cc_ft_1152.jpg", "https://photos.zillowstatic.com/fp/3f1f0c1d904a63966211b8a3292ae9c5-cc_ft_1152.jpg" /* ... 15 more photo URLs ... */ ], "listingAgent": { "name": "Clay Byrne", "phone": "(512) 942-7880", "brokerage": "Keller Williams Realty" }, "priceHistory": [ { "date": "2026-04-07", "event": "Price change", "price": 950000 }, { "date": "2026-03-17", "event": "Price change", "price": 1049900 }, { "date": "2026-02-09", "event": "Listed for sale", "price": 1100000 } ], "taxHistory": [ { "year": 2025, "amount": 11231.14, "value": 680091 }, { "year": 2024, "amount": 11155.90, "value": 674528 }, { "year": 2023, "amount": 15568.63, "value": 860503 }, { "year": 2022, "amount": 7631.93, "value": 696858 }, { "year": 2020, "amount": 7646.81, "value": 575915 }, { "year": 2002, "amount": 5161.45, "value": 223429 } /* ... 17 more years ... */ ], "scrapedAt": "2026-05-14T14:50:54Z" } ``` Two more rows from the same run: | sourceId | Address | Price | Beds | Baths | sqft | Type | Agent | Brokerage | |-----------|-------------------------------|-----------|------|-------|------|----------------|--------------------|----------------------------------| | 29401557 | 4404 Barrow Ave, Austin 78751 | $550,000 | 2 | 1 | 896 | SINGLE\_FAMILY | Vanessa Hadrych | Keller Williams Realty | | 338246448 | 2500 Longview St #518, 78705 | $500,000 | 2 | 2 | 1010 | CONDO | Georgia Spiropoulos| Christie's Int'l Real Estate | ### Tips for best results - **Residential proxy is the default and the right choice.** Datacenter IPs get flagged within a few requests. - **Start small.** Set `maxItems: 5` and `maxRetries: 8` for your first run. Adjust upward once it works for your input. - **Bounding boxes beat city URLs for completeness.** A city URL is bound by Zillow's URL-encoded filter; a bounding box gets every listing in the box regardless. - **Photos are CDN-direct.** Each URL in `photos` is a stable, no-auth zillowstatic.com URL you can store or hot-link. ### Output dataset Each row is pushed to the actor's **default dataset** as a flat JSON object with the schema shown above. Export to CSV, JSON, JSONL, XML, or Excel from the Apify Console. ### Notes & limits - The actor scrapes only publicly visible data -- no login, no agent-only MLS fields, no off-market records. - Some listings (sponsored or partial markers) are intentionally skipped when they lack a property identifier. - For technical / architectural details, see [the repo's root README](https://github.com/) (no-browser HTTP-only stack, TLS impersonation, multi-step warmup, bbox quadtree, full operations playbook). # Actor input Schema ## `searchUrls` (type: `array`): Zillow search-results or map URLs. Map bounds and filters are read straight from the URL when present. ## `boundingBoxes` (type: `array`): Map-area searches as { north, south, east, west } in decimal degrees. Large areas are auto-subdivided into smaller tiles. ## `filterState` (type: `object`): Optional. Zillow filterState object (sort, price range, beds, baths, home type, etc.). Pass-through. ## `useMapResults` (type: `boolean`): When on, pulls up to ~500 markers per map tile in one request, then enriches with full detail. Off: paginates list results (slower, more granular). ## `maxItems` (type: `integer`): Soft cap on the number of dataset rows to emit. Set to 0 for unlimited. ## `maxConcurrency` (type: `integer`): Maximum number of concurrent HTTP requests. 4-6 is the sweet spot; higher values can trigger blocks. ## `maxRetries` (type: `integer`): How many times to retry a request before giving up. ## `proxyConfiguration` (type: `object`): Strongly recommended. Residential proxy minimizes blocks and gives the most reliable results. ## Actor input object example ```json { "searchUrls": [ { "url": "https://www.zillow.com/austin-tx/" } ], "boundingBoxes": [ { "north": 30.4, "south": 30.2, "east": -97.65, "west": -97.85 } ], "filterState": { "sortSelection": { "value": "globalrelevanceex" } }, "useMapResults": true, "maxItems": 0, "maxConcurrency": 4, "maxRetries": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # 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/austin-tx/" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/zillow-all-in-one-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/austin-tx/" }], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("xtracto/zillow-all-in-one-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/austin-tx/" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call xtracto/zillow-all-in-one-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/zillow-all-in-one-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow All-in-One Scraper", "description": "Scrape Zillow listings, property details, photos, agents, price history, and tax history - all in one actor. Search by URL, map area, or filter state.", "version": "0.1", "x-build-id": "aCdggOhenGqetKxdg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~zillow-all-in-one-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-zillow-all-in-one-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/xtracto~zillow-all-in-one-scraper/runs": { "post": { "operationId": "runs-sync-xtracto-zillow-all-in-one-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/xtracto~zillow-all-in-one-scraper/run-sync": { "post": { "operationId": "run-sync-xtracto-zillow-all-in-one-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", "required": [ "proxyConfiguration" ], "properties": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Zillow search-results or map URLs. Map bounds and filters are read straight from the URL when present.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "boundingBoxes": { "title": "Map bounding boxes", "type": "array", "description": "Map-area searches as { north, south, east, west } in decimal degrees. Large areas are auto-subdivided into smaller tiles.", "default": [ { "north": 30.4, "south": 30.2, "east": -97.65, "west": -97.85 } ] }, "filterState": { "title": "Filter state", "type": "object", "description": "Optional. Zillow filterState object (sort, price range, beds, baths, home type, etc.). Pass-through.", "default": { "sortSelection": { "value": "globalrelevanceex" } } }, "useMapResults": { "title": "Use map markers (fastest)", "type": "boolean", "description": "When on, pulls up to ~500 markers per map tile in one request, then enriches with full detail. Off: paginates list results (slower, more granular).", "default": true }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Soft cap on the number of dataset rows to emit. Set to 0 for unlimited.", "default": 0 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of concurrent HTTP requests. 4-6 is the sweet spot; higher values can trigger blocks.", "default": 4 }, "maxRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a request before giving up.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Strongly recommended. Residential proxy minimizes blocks and gives the most reliable results." } } }, "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 } } } } } } } } } } ```