# Zillow Search Scraper (`scrapelabsapi/zillow-search-scraper`) Actor ✨ Zillow Search Scraper to extract property listings from search results fast. Collect prices, locations, features, and listing details with ease. Ideal for real estate research and market analysis. Features: ⚡ fast scraping • 📊 clean output • 🔍 insights • 🌍 scalable automation - **URL**: https://apify.com/scrapelabsapi/zillow-search-scraper.md - **Developed by:** [ScrapeLabs](https://apify.com/scrapelabsapi) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $19.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 Search Scraper The Zillow Search Scraper is a fast, scalable Zillow search results scraper that collects structured property listings from public Zillow pages — a Zillow data scraper and Zillow real estate scraper in one. It solves the pain of manual collection by automating pagination and extraction, so marketers, developers, data analysts, and researchers can extract Zillow data for market analysis, pricing, and lead generation at scale. With dynamic zoom and HTML modes, this Zillow web scraping tool helps you scrape Zillow listings reliably across cities, regions, or ZIP codes. ### What data / output can you get? Below are key fields the actor saves to the Apify dataset. You can export results to JSON, CSV, or Excel. | Data field | Description | Example value | | --- | --- | --- | | zpid | Zillow Property ID (string) | "55826232" | | price | Formatted price string | "$1,000,000" | | unformattedPrice | Numeric price parsed from price | 1000000 | | address | Full address (as shown by Zillow) | "3810 Hawthorne Ave, Dallas, TX 75219" | | addressStreet | Street component of the address | "3810 Hawthorne Ave" | | addressCity | City name | "Dallas" | | beds | Number of bedrooms | 3 | | baths | Number of bathrooms | 3 | | area | Square footage | 2622 | | statusType | Listing status code | "FOR_SALE" | | detailUrl | Absolute URL to the listing page | "https://www.zillow.com/homedetails/..." | | zestimate | Zillow’s estimated value (if present) | 994000 | Note: The dataset also includes additional metadata such as id, imgSrc, statusText, latLong, hdpData, countryCurrency, carouselPhotosComposable, and more. Some fields may be empty or defaulted when Zillow does not provide them. Export your dataset in your preferred format (JSON, CSV, Excel) directly from Apify. ### Key features - ⚡ Dynamic zoom API mode for large result sets Uses “PAGINATION_WITH_DYNAMIC_ZOOM_INCREASE” to split map bounds into quadrants and bypass typical pagination caps (~820), making it ideal when you need to scrape Zillow listings at scale. - 🧭 Reliable HTML pagination fallback “PAGINATION_WITHOUT_ZOOMING_IN” parses public HTML pages and extracts from client-side data, offering a robust alternative when internal endpoints are unavailable. - 🗺️ Map marker mode for quick snapshots “MAP_MARKERS” mode focuses on map-based results (capped to roughly 500 listings per search URL), perfect for lighter or targeted runs. - 🔁 Automatic proxy fallback with locking Starts direct and automatically switches to residential proxies with retry logic on blocks; once a working proxy is found, it’s locked for the remainder of the run for stability. - 📥 Bulk processing of cities, regions, or ZIPs Feed multiple search URLs or keywords/locations and process them in one run — a true Zillow search scraper tool for batch workflows. - 💾 Live dataset saving Results are pushed to the Apify dataset as they’re collected, minimizing data loss and enabling partial exports if a run is stopped. - 🧪 Developer-friendly, automation-ready Built on Apify’s Python runtime. Integrate into pipelines as a Zillow API alternative for data, trigger via Apify API, and automate exports for BI or CRM. - 📊 Clean, structured output Extract Zillow data like prices, beds/baths, area, addresses, listing status, and Zestimate in a schema that’s easy to analyze and export to CSV. ### How to use Zillow Search Scraper - step by step 1. Sign in to your Apify account at https://console.apify.com. 2. Open the “Zillow Search Scraper” actor. 3. Add input data: - Paste one or more Zillow search URLs (with searchQueryState for best results), or simple keywords like “dallas-tx” or “new-york-ny”. 4. Choose the extraction method: - PAGINATION_WITH_DYNAMIC_ZOOM_INCREASE (best for large sets) - PAGINATION_WITHOUT_ZOOMING_IN (HTML parsing) - MAP_MARKERS (snapshot; ~500 cap per URL) 5. Set Maximum Items to control how many listings to collect per search URL. 6. Configure Proxy (optional): - By default, requests start without a proxy; on blocks, the scraper automatically switches to residential proxies with retries. 7. Click “Start” to run. Watch logs for live progress and snapshot messages as items are saved. 8. Download your results from the “Dataset” tab and export to JSON, CSV, or Excel. Pro tip 💡: Run multiple search URLs (e.g., different ZIPs or cities) to build a larger dataset for investment research, price monitoring, or Zillow scraping automation flows. ### Use cases | Use case | Description | | --- | --- | | Real estate market research | Analyze inventory, pricing, and trends by city or ZIP; build dashboards from CSV exports using this Zillow search results scraper. | | Price monitoring & valuation tracking | Track listing price vs. unformattedPrice and zestimate to evaluate changes over time with a Zillow home price scraper workflow. | | Investment property discovery | Filter and rank scraped listings by beds, baths, and area to spot attractive opportunities faster. | | Competitive analysis | Compare listing density and statuses across neighborhoods to benchmark competition. | | Lead generation | Use structured listing data (addresses, URLs) to fuel a Zillow lead scraper pipeline for outreach. | | Data enrichment / API pipelines | Use the actor as a Zillow API alternative for data in ETL jobs; automate exports to your warehouse. | | Academic & policy research | Quantify housing supply and price distributions across regions using clean Zillow data export CSV files. | ### Why choose Zillow Search Scraper? A production-ready Zillow listing scraper focused on accuracy, automation, and scale — without browser extensions. - ✅ Dual extraction modes for resilience: dynamic zoom API scraping + HTML parsing fallback - ✅ Automatic proxy fallback with retries and locking for stable, long runs - ✅ Bulk inputs to scrape Zillow by city or zip for large-scale coverage - ✅ Clean, structured output for easy Zillow data export CSV or JSON - ✅ Developer-friendly and automation-ready with the Apify platform - ✅ Safer alternative to brittle browser add-ons — no Zillow scraper Chrome extension required - ✅ Built for repeatable workflows in research, analytics, and lead generation Bottom line: This Zillow web scraping tool emphasizes reliable extraction and scalable automation over fragile, manual approaches. ### Is it legal / ethical to use Zillow Search Scraper? Yes — when used responsibly. The actor extracts data from publicly available Zillow pages and does not access private or authenticated content. Always: - Scrape only public data and respect website terms of service. - Comply with data protection laws (e.g., GDPR, CCPA) and local regulations. - Use results responsibly and avoid spam or misuse. - Consult your legal team for edge cases or jurisdiction-specific rules. ### Input parameters & output format #### Example input JSON ```json { "searchUrls": [ "https://www.zillow.com/dallas-tx/?category=SEMANTIC&searchQueryState=%7B%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22north%22%3A33.10483509834637%2C%22south%22%3A32.53008985410089%2C%22east%22%3A-96.3544578671875%2C%22west%22%3A-97.2004051328125%7D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22globalrelevanceex%22%7D%7D%2C%22isListVisible%22%3Atrue%2C%22usersSearchTerm%22%3A%22Dallas%2C%20TX%22%2C%22category%22%3A%22cat1%22%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A38128%2C%22regionType%22%3A6%7D%5D%7D", "new-york-ny" ], "extractionMethod": "PAGINATION_WITH_DYNAMIC_ZOOM_INCREASE", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": false } } ```` #### Parameters reference | Field | Type | Required | Default | Description | | --- | --- | --- | --- | --- | | searchUrls | array | Yes | — | List of Zillow search URLs (recommended: with searchQueryState) or keywords/locations like “dallas-tx”, “new-york-ny”. Supports bulk input. | | extractionMethod | string (enum) | No | PAGINATION\_WITH\_DYNAMIC\_ZOOM\_INCREASE | Choose scraping mode: PAGINATION\_WITH\_DYNAMIC\_ZOOM\_INCREASE, PAGINATION\_WITHOUT\_ZOOMING\_IN, MAP\_MARKERS. Dynamic zoom splits large areas to bypass caps; HTML mode parses pages; Map markers caps ~500 results per URL. | | maxItems | integer | No | 20 | Maximum number of property listings to scrape per search URL (1–10000). | | proxyConfiguration | object | No | {"useApifyProxy": false} | Proxy settings. Starts direct by default; on blocks, the actor automatically switches to residential proxies with retries. | #### Example output JSON ```json { "zpid": "55826232", "palsId": null, "id": "55826232", "rawHomeStatusCd": "FOR_SALE", "marketingStatusSimplifiedCd": null, "providerListingId": "*APID55826232*", "imgSrc": "https://photos.zillowstatic.com/fp/abc123-p_e.jpg", "hasImage": true, "detailUrl": "https://www.zillow.com/homedetails/55826232_zpid/", "statusType": "FOR_SALE", "statusText": "House for sale", "countryCurrency": "$", "price": "$1,000,000", "unformattedPrice": 1000000, "address": "3810 Hawthorne Ave, Dallas, TX 75219", "addressStreet": "3810 Hawthorne Ave", "addressCity": "Dallas", "addressState": "TX", "addressZipcode": "75219", "isUndisclosedAddress": false, "streetViewURL": null, "streetViewMetadataURL": null, "shouldShowRequestOnPrice": false, "beds": 3, "baths": 3, "area": 2622, "latLong": { "latitude": 32.822216, "longitude": -96.811325 }, "isZillowOwned": false, "flexFieldText": null, "contentType": "ForSale", "hdpData": {}, "isSaved": false, "isUserClaimingOwner": false, "isUserConfirmedClaim": false, "pgapt": "ForSale", "sgapt": "For Sale", "zestimate": 994000, "shouldShowZestimateAsPrice": false, "has3DModel": false, "hasVideo": false, "isHomeRec": false, "hasAdditionalAttributions": false, "isFeaturedListing": false, "isShowcaseListing": false, "list": true, "relaxed": false, "carouselPhotosComposable": { "baseUrl": "https://photos.zillowstatic.com/fp/{photoKey}-p_e.jpg", "communityBaseUrl": null, "photoData": [ { "photoKey": "abc123" } ], "communityPhotoData": null, "isStaticUrls": false }, "isPaidBuilderNewConstruction": false, "foundOnSearchPage": 1, "foundFromSearchUrl": "https://www.zillow.com/dallas-tx/?category=SEMANTIC&searchQueryState=...", "zoomQuadrantSequence": [] } ``` Notes: - Fields like zestimate, imgSrc, and hdpData may be absent for certain entries; the actor sets sensible defaults (e.g., 0 or empty structures) when Zillow does not provide them. - The actor pushes each listing to the dataset in real time during pagination. ### FAQ #### Which extraction method should I choose? Use PAGINATION\_WITH\_DYNAMIC\_ZOOM\_INCREASE for large result sets because it splits map bounds to bypass normal caps (~820 items). If internal endpoints are unavailable, switch to PAGINATION\_WITHOUT\_ZOOMING\_IN (HTML parsing). Choose MAP\_MARKERS for smaller, faster snapshots (capped to roughly 500 results per URL). #### Can I scrape multiple locations or ZIP codes at once? Yes. Add multiple entries to searchUrls — full Zillow search URLs or keywords like “dallas-tx” — and the actor will process each in bulk. It’s designed to scrape Zillow by city or zip efficiently. #### Do I need to use proxies? Not initially. The actor starts without a proxy and automatically switches to residential proxies with retry logic if requests are blocked. You can also supply proxyConfiguration to control behavior. #### How many results can I extract per run? Set maxItems from 1 to 10,000 per search URL. Dynamic zoom mode helps surpass the typical ~820-result cap for large areas, while MAP\_MARKERS is limited to roughly 500 per URL. #### Is this a Zillow API? It’s a Zillow API alternative for data built on public endpoints and HTML parsing. You run it on Apify, get structured outputs, and export as JSON or CSV without needing a proprietary API. #### Do I need a browser plugin or Chrome extension? No. This is a server-side Zillow scraping automation — you don’t need a Zillow scraper Chrome extension. Everything runs on Apify infrastructure. #### What data types are included in the output? You’ll get identifiers (zpid, id), pricing (price, unformattedPrice), address components (street, city, state, ZIP), beds/baths/area, status and links, images, coordinates, zestimate, and additional metadata like carouselPhotosComposable and hdpData where available. #### How do I export results? Open the run’s Dataset in Apify and export to JSON, CSV, or Excel. This makes Zillow data export CSV workflows simple for downstream BI, CRM, or research tools. ### Closing CTA / Final thoughts Zillow Search Scraper is built for structured, scalable extraction of Zillow search results. It delivers clean listing data, robust modes for both large and small result sets, and live dataset saving for reliability. Whether you’re a researcher, analyst, marketer, or developer, use it to power Zillow data exports, automate pipelines, and accelerate market insights. Trigger it via the Apify platform or API as a dependable Zillow API alternative for data — and start extracting smarter real estate insights today. # Actor input Schema ## `searchUrls` (type: `array`): List of Zillow search URLs (full URLs with searchQueryState) or keywords/locations to search. Supports bulk input. Enter full Zillow URLs (recommended) or keywords like 'dallas-tx', 'new-york-ny'. For PAGINATION\_WITH\_ZOOM\_IN method, full URLs with searchQueryState are recommended. ## `extractionMethod` (type: `string`): Choose the scraping method. Dynamic zoom can go beyond Zillow's normal pagination cap by splitting the map into smaller quadrants (best for large result sets). Pagination without zooming uses HTML pages (good when API is blocked). Map markers is limited to roughly 500 results per search URL. ## `maxItems` (type: `integer`): Maximum number of property listings to scrape (1-10000). ## `proxyConfiguration` (type: `object`): Proxy settings. By default, requests are sent without proxy. If Zillow blocks requests, the actor will automatically fallback to datacenter proxy, then residential proxy with 3 retries. ## Actor input object example ```json { "searchUrls": [ "https://www.zillow.com/dallas-tx/?category=SEMANTIC&searchQueryState=%7B%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22north%22%3A33.10483509834637%2C%22south%22%3A32.53008985410089%2C%22east%22%3A-96.3544578671875%2C%22west%22%3A-97.2004051328125%7D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22globalrelevanceex%22%7D%7D%2C%22isListVisible%22%3Atrue%2C%22usersSearchTerm%22%3A%22Dallas%2C%20TX%22%2C%22category%22%3A%22cat1%22%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A38128%2C%22regionType%22%3A6%7D%5D%7D" ], "extractionMethod": "PAGINATION_WITH_DYNAMIC_ZOOM_INCREASE", "maxItems": 20, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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": [ "https://www.zillow.com/dallas-tx/?category=SEMANTIC&searchQueryState=%7B%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22north%22%3A33.10483509834637%2C%22south%22%3A32.53008985410089%2C%22east%22%3A-96.3544578671875%2C%22west%22%3A-97.2004051328125%7D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22globalrelevanceex%22%7D%7D%2C%22isListVisible%22%3Atrue%2C%22usersSearchTerm%22%3A%22Dallas%2C%20TX%22%2C%22category%22%3A%22cat1%22%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A38128%2C%22regionType%22%3A6%7D%5D%7D" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapelabsapi/zillow-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchUrls": ["https://www.zillow.com/dallas-tx/?category=SEMANTIC&searchQueryState=%7B%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22north%22%3A33.10483509834637%2C%22south%22%3A32.53008985410089%2C%22east%22%3A-96.3544578671875%2C%22west%22%3A-97.2004051328125%7D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22globalrelevanceex%22%7D%7D%2C%22isListVisible%22%3Atrue%2C%22usersSearchTerm%22%3A%22Dallas%2C%20TX%22%2C%22category%22%3A%22cat1%22%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A38128%2C%22regionType%22%3A6%7D%5D%7D"], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("scrapelabsapi/zillow-search-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": [ "https://www.zillow.com/dallas-tx/?category=SEMANTIC&searchQueryState=%7B%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22north%22%3A33.10483509834637%2C%22south%22%3A32.53008985410089%2C%22east%22%3A-96.3544578671875%2C%22west%22%3A-97.2004051328125%7D%2C%22filterState%22%3A%7B%22sort%22%3A%7B%22value%22%3A%22globalrelevanceex%22%7D%7D%2C%22isListVisible%22%3Atrue%2C%22usersSearchTerm%22%3A%22Dallas%2C%20TX%22%2C%22category%22%3A%22cat1%22%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A38128%2C%22regionType%22%3A6%7D%5D%7D" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call scrapelabsapi/zillow-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapelabsapi/zillow-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow Search Scraper", "description": "✨ Zillow Search Scraper to extract property listings from search results fast. Collect prices, locations, features, and listing details with ease. Ideal for real estate research and market analysis. Features: ⚡ fast scraping • 📊 clean output • 🔍 insights • 🌍 scalable automation", "version": "0.1", "x-build-id": "mnxnw6hE81zek895a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapelabsapi~zillow-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapelabsapi-zillow-search-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/scrapelabsapi~zillow-search-scraper/runs": { "post": { "operationId": "runs-sync-scrapelabsapi-zillow-search-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/scrapelabsapi~zillow-search-scraper/run-sync": { "post": { "operationId": "run-sync-scrapelabsapi-zillow-search-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": [ "searchUrls" ], "properties": { "searchUrls": { "title": "Search URLs or Keywords", "type": "array", "description": "List of Zillow search URLs (full URLs with searchQueryState) or keywords/locations to search. Supports bulk input. Enter full Zillow URLs (recommended) or keywords like 'dallas-tx', 'new-york-ny'. For PAGINATION_WITH_ZOOM_IN method, full URLs with searchQueryState are recommended.", "items": { "type": "string" } }, "extractionMethod": { "title": "Items extraction method", "enum": [ "PAGINATION_WITH_DYNAMIC_ZOOM_INCREASE", "PAGINATION_WITHOUT_ZOOMING_IN", "MAP_MARKERS" ], "type": "string", "description": "Choose the scraping method. Dynamic zoom can go beyond Zillow's normal pagination cap by splitting the map into smaller quadrants (best for large result sets). Pagination without zooming uses HTML pages (good when API is blocked). Map markers is limited to roughly 500 results per search URL.", "default": "PAGINATION_WITH_DYNAMIC_ZOOM_INCREASE" }, "maxItems": { "title": "Maximum Items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of property listings to scrape (1-10000).", "default": 20 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. By default, requests are sent without proxy. If Zillow blocks requests, the actor will automatically fallback to datacenter proxy, then residential proxy with 3 retries." } } }, "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 } } } } } } } } } } ```