# Zillow Property Details Scraper (`fetch_cat/zillow-property-details-scraper`) Actor Scrape public Zillow property detail pages for price, status, facts, history, schools, photos, agent/broker data, and diagnostics. - **URL**: https://apify.com/fetch\_cat/zillow-property-details-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.60 / 1,000 item processeds 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Details Scraper Scrape public Zillow property detail pages into structured records with prices, facts, photos, schools, price history, tax history, agent/broker data, and diagnostics. Use this Actor to enrich Zillow search results, monitor selected homes, audit comparable properties, or export detail-page data to CSV, JSON, Excel, API, and automation workflows. ### At a glance - **Primary job**: Turn Zillow detail URLs or ZPIDs into normalized property detail rows. - **Input**: Provide `propertyUrls`, `zpids`, or `searchResultsDatasetId`, then set `maxItems`. - **Output**: One row per property with `status`, `source`, `zpid`, `canonicalUrl`, `address`, `price`, facts, history, photos, and diagnostics. - **Best for**: Real estate research, listing enrichment, lead qualification, portfolio monitoring, and downstream automations. ### Who is it for? - **Real estate investors and analysts** who need repeatable property facts, pricing signals, and comparable-home exports. - **Brokerages and agents** enriching lead lists or saved searches with current public detail-page fields. - **Proptech and data teams** chaining Zillow search/listing datasets into normalized property-detail records. - **Automation builders** feeding Zillow detail data into CRMs, alerts, spreadsheets, dashboards, or AI agents. ### Common workflows - **Enrich listing results**: Pass a dataset from a Zillow listings/search workflow with URL or ZPID columns. - **Analyze property details**: Submit a curated list of `/homedetails/` URLs for price, facts, schools, and history. - **Monitor homes or rentals**: Schedule repeat runs on the same `zpids` and compare fresh dataset exports. - **Audit failures cleanly**: Blocked or missing properties are saved with `status`, `errorCode`, `errorMessage`, and `diagnostics`. Diagnostic rows are not charged as items. ### Ready-to-run examples - **[Export Zillow Property Details by URL](https://apify.com/fetch_cat/zillow-property-details-scraper/examples/export-zillow-property-details-by-url)**: Fetch one public Zillow detail URL with bounded spend. - **[Look Up Zillow Home Details by ZPID](https://apify.com/fetch_cat/zillow-property-details-scraper/examples/zillow-home-details-by-zpid)**: Look up one home from its Zillow property ID. - **[Export Zillow Property Photos and Facts](https://apify.com/fetch_cat/zillow-property-details-scraper/examples/zillow-property-photos-and-facts)**: Fetch one home with its available photo array enabled. For larger enrichments, pass 3-10 `propertyUrls`, or set `searchResultsDatasetId` to a dataset containing `url`, `detailUrl`, `hdpUrl`, `canonicalUrl`, or `zpid` fields. Keep the first run small before scheduling a recurring monitor. ### What data can you extract? | Field | Description | | --- | --- | | `input`, `inputType`, `workKey` | Original input, its origin, and a stable deduplication/resume key. | | `status` | `success`, `blocked`, `not_found`, `fetch_error`, or `parse_error`. | | `source` | Structured live source, or `persistent_cache` when a recent successful public record is used after all live routes are blocked. | | `zpid`, `canonicalUrl` | Zillow property ID and normalized detail URL. | | `homeStatus`, `propertyType` | Listing status and property type when available. | | `address` | Structured address object from Zillow payloads. | | `price`, `zestimate`, `rentZestimate` | Listing and estimate values when exposed. | | `beds`, `baths`, `livingArea`, `lotSize`, `yearBuilt` | Core home facts. | | `description`, `facts` | Listing description and detailed facts object. | | `agent`, `broker` | Listing attribution data when present. | | `priceHistory`, `taxHistory` | Optional history arrays controlled by `includeHistory`. | | `schools`, `photos`, `nearbyHomes` | Optional public detail-page arrays. | | `missingFields`, `warnings`, `errorCode`, `errorMessage`, `diagnostics`, `scrapedAt` | Quality and troubleshooting metadata. | ### Input configuration | Setting | JSON key | Use it for | Example | | --- | --- | --- | --- | | Zillow property URLs | `propertyUrls` | Direct `/homedetails/` pages to scrape. | `[{"url":"https://www.zillow.com/homedetails/17199-Park-Ave-Sonoma-CA-95476/15800416_zpid/"}]` | | ZPIDs | `zpids` | Zillow property IDs collected elsewhere. | `["15800416"]` | | Search results dataset ID | `searchResultsDatasetId` | Enrich rows from another Zillow listing/search dataset. | `abc123DatasetId` | | Maximum properties | `maxItems` | Cap unique properties and control spend. | `10` | | Include photos | `includePhotos` | Save photo arrays when exposed. | `true` | | Include price and tax history | `includeHistory` | Save `priceHistory` and `taxHistory`. | `true` | | Maximum retries per source | `maxRetries` | Retry temporary blocks, rate limits, and server errors. | `2` | | Request timeout | `requestTimeoutSecs` | Bound each source request while preserving cleanup time. | `30` | | Proxy configuration | `proxyConfiguration` | Use Apify Proxy; US residential proxy is recommended for Zillow. | `{ "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" }` | ### Example input ```json { "propertyUrls": [ { "url": "https://www.zillow.com/homedetails/17199-Park-Ave-Sonoma-CA-95476/15800416_zpid/" } ], "maxItems": 1, "includePhotos": false, "includeHistory": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ```` ### Example output ```json { "input": "https://www.zillow.com/homedetails/17199-Park-Ave-Sonoma-CA-95476/15800416_zpid/", "inputType": "url", "workKey": "zpid:15800416", "status": "success", "source": "html_cache", "zpid": "15800416", "canonicalUrl": "https://www.zillow.com/homedetails/15800416_zpid/", "homeStatus": "FOR_SALE", "address": { "streetAddress": "17199 Park Ave", "city": "Sonoma", "state": "CA", "zipcode": "95476" }, "price": 995000, "beds": 3, "baths": 2, "livingArea": 1520, "priceHistory": [], "errorCode": null, "scrapedAt": "2026-07-13T00:00:00.000Z" } ``` ### Pricing This Actor uses pay-per-event pricing: `$0.005` per run start plus a tiered per-item event for each complete successful property row (`FREE: $0.00115`, `BRONZE: $0.001`, `SILVER: $0.00078`, `GOLD: $0.0006`, `PLATINUM: $0.0004`, `DIAMOND: $0.00028`). Blocked, missing, and parse-error diagnostic rows are saved without an item charge. Check the Apify pricing panel for your current tier before running large jobs. ### Tips for best results - **Start small**: Use `maxItems: 1` until the selected URLs produce the fields you need. - **Use detail pages**: Search result pages are better handled by a Zillow listings actor; this Actor is for property details. - **Keep inputs focused**: Split very broad enrichment jobs into smaller runs. - **Expect diagnostics**: Zillow may return access-denied pages; those are saved as free diagnostic rows for review. - **Understand cached fallbacks**: If every live route is blocked, the Actor may return a successful public record cached within the previous six hours. The row uses `source: "persistent_cache"`, preserves its original `scrapedAt`, and includes a warning and cache age. - **Use retries deliberately**: The default retries temporary failures twice per source. Lower `maxRetries` for quick probes or raise it for small reliability-focused jobs. ### API usage Node.js: ```js import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor("fetch_cat/zillow-property-details-scraper").call({ propertyUrls: [{ url: "https://www.zillow.com/homedetails/17199-Park-Ave-Sonoma-CA-95476/15800416_zpid/" }], maxItems: 1, }); console.log(run.defaultDatasetId); ``` Python: ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("fetch_cat/zillow-property-details-scraper").call(run_input={ "zpids": ["15800416"], "maxItems": 1, }) print(run["defaultDatasetId"]) ``` cURL: ```bash curl -X POST "https://api.apify.com/v2/acts/fetch_cat~zillow-property-details-scraper/runs?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"zpids":["15800416"],"maxItems":1}' ``` ### MCP and AI agents Use this Actor from MCP-compatible tools through the official Apify MCP Server. ```bash claude mcp add --transport http apify "https://mcp.apify.com?tools=fetch_cat/zillow-property-details-scraper" ``` ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=fetch_cat/zillow-property-details-scraper" } } } ``` Example prompt: "Run Zillow Property Details Scraper for these three ZPIDs and summarize price, beds, baths, and any diagnostic errors." ### Limits and caveats - **Coverage**: Zillow may vary detail-page payloads by property type, geography, and access controls. - **Freshness**: Source data can change after a run finishes. - **Access controls**: Zillow can return anti-bot pages. The Actor detects HTML and JSON challenges, rotates proxy sessions between retries, and tries bounded structured fallbacks before saving a diagnostic. - **Partial runs**: The Actor reserves shutdown time, saves unfinished normalized inputs in `PENDING_WORK`, and writes aggregate counters to `RUN_SUMMARY`. - **Success contract**: A row is only marked and charged as successful when it contains a ZPID, a usable address, and multiple core property facts. ### Legality and responsible use Process only data that users are allowed to access. Follow website terms, Apify's terms, and applicable laws. ### Related actors - [Zillow Property Listings Scraper](https://apify.com/fetch_cat/zillow-property-listings-scraper) - [Website Change Monitor](https://apify.com/fetch_cat/website-change-monitor) ### FAQ #### Can I export results? Yes. Apify datasets support JSON, CSV, Excel, XML, RSS, and API access. #### Why are some fields empty? Some properties do not expose every field publicly. The Actor leaves unavailable fields empty and lists important gaps in `missingFields`. ### Support Open an issue from the Actor page if a run fails or output looks wrong. Include the run ID or run URL, input JSON, expected output, actual output, and one reproducible public URL. # Actor input Schema ## `propertyUrls` (type: `array`): Public Zillow /homedetails/ URLs to enrich. ## `zpids` (type: `array`): Zillow property IDs. Use this when you already have ZPIDs from another workflow. ## `searchResultsDatasetId` (type: `string`): Optional dataset ID from Zillow Property Listings Scraper or another Zillow search actor. Rows should contain url, detailUrl, hdpUrl, canonicalUrl, or zpid. ## `maxItems` (type: `integer`): Maximum number of unique properties to process. ## `includePhotos` (type: `boolean`): Include photo URL arrays when Zillow exposes them in the page payload. ## `includeHistory` (type: `boolean`): Include priceHistory and taxHistory arrays when available. ## `maxRetries` (type: `integer`): Retry temporary blocks, rate limits, and server errors before moving to the next structured source. ## `requestTimeoutSecs` (type: `integer`): Maximum time for an individual source request. The Actor also reserves time to save partial output and pending work. ## `proxyConfiguration` (type: `object`): Residential Apify Proxy is recommended for Zillow. ## Actor input object example ```json { "propertyUrls": [ { "url": "https://www.zillow.com/homedetails/17199-Park-Ave-Sonoma-CA-95476/15800416_zpid/" } ], "zpids": [ "15800416" ], "maxItems": 10, "includePhotos": true, "includeHistory": true, "maxRetries": 2, "requestTimeoutSecs": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `runSummary` (type: `string`): No description ## `pendingWork` (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 = { "propertyUrls": [ { "url": "https://www.zillow.com/homedetails/17199-Park-Ave-Sonoma-CA-95476/15800416_zpid/" } ], "zpids": [ "15800416" ] }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/zillow-property-details-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 = { "propertyUrls": [{ "url": "https://www.zillow.com/homedetails/17199-Park-Ave-Sonoma-CA-95476/15800416_zpid/" }], "zpids": ["15800416"], } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/zillow-property-details-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 '{ "propertyUrls": [ { "url": "https://www.zillow.com/homedetails/17199-Park-Ave-Sonoma-CA-95476/15800416_zpid/" } ], "zpids": [ "15800416" ] }' | apify call fetch_cat/zillow-property-details-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/zillow-property-details-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow Property Details Scraper", "description": "Scrape public Zillow property detail pages for price, status, facts, history, schools, photos, agent/broker data, and diagnostics.", "version": "0.1", "x-build-id": "lhdb5yYcK9duTqPTx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~zillow-property-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-zillow-property-details-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/fetch_cat~zillow-property-details-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-zillow-property-details-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/fetch_cat~zillow-property-details-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-zillow-property-details-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": { "propertyUrls": { "title": "Zillow property URLs", "type": "array", "description": "Public Zillow /homedetails/ URLs to enrich.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "zpids": { "title": "ZPIDs", "type": "array", "description": "Zillow property IDs. Use this when you already have ZPIDs from another workflow.", "items": { "type": "string" } }, "searchResultsDatasetId": { "title": "Search results dataset ID", "type": "string", "description": "Optional dataset ID from Zillow Property Listings Scraper or another Zillow search actor. Rows should contain url, detailUrl, hdpUrl, canonicalUrl, or zpid." }, "maxItems": { "title": "Maximum properties", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of unique properties to process.", "default": 10 }, "includePhotos": { "title": "Include photos", "type": "boolean", "description": "Include photo URL arrays when Zillow exposes them in the page payload.", "default": true }, "includeHistory": { "title": "Include price and tax history", "type": "boolean", "description": "Include priceHistory and taxHistory arrays when available.", "default": true }, "maxRetries": { "title": "Maximum retries per source", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retry temporary blocks, rate limits, and server errors before moving to the next structured source.", "default": 2 }, "requestTimeoutSecs": { "title": "Request timeout in seconds", "minimum": 5, "maximum": 60, "type": "integer", "description": "Maximum time for an individual source request. The Actor also reserves time to save partial output and pending work.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential Apify Proxy is recommended for Zillow.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } } ```