# Zillow Search Scraper (`simpleapi/zillow-search-scraper`) Actor Pull Zillow search listings in bulk using advanced filters for location, price, beds, baths, and home type. Get property details, estimates, photos, and agent info. Designed for real estate teams, analysts, and automation pipelines needing clean, structured Zillow market data. - **URL**: https://apify.com/simpleapi/zillow-search-scraper.md - **Developed by:** [SimpleAPI](https://apify.com/simpleapi) (community) - **Categories:** Real estate, Automation, Lead generation - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 1 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 ### What does Zillow Search Scraper do? 🤔 A Zillow Search Scraper is a powerful automation tool designed to extract real-estate data directly from Zillow’s search results. Instead of manually checking listings one by one, this tool gathers structured insights—such as prices, locations, agent details, and home features—within minutes. This makes it an essential asset for real estate analysts, marketers, investors, and researchers who need accurate and fast data. Because it automates search extraction, the Zillow Search Scraper helps users uncover pricing trends, evaluate investment opportunities, and optimize content for SEO when building property-related websites. If you are exploring how to search on Zillow more efficiently—or want to analyze hundreds of listings at once—this scraper is your ultimate productivity booster. ✨ * * * ### What Zillow Search Scraper can I extract? 📊 The tool allows you to scrape Zillow for rich property-level insights. Here’s a structured list of data types: | 🏷 Data Type | 📘 Description | | --- | --- | | Property Title | Full listing title shown on Zillow | | Price | Current listing price or rent | | Address | Street, city, state, ZIP | | Bedrooms | Number of bedrooms | | Bathrooms | Number of baths | | Square Footage | Total interior area | | Listing URL | Direct Zillow URL | | Agent / Broker Info | Basic realtor information | | Property Type | House, condo, multi-family, etc. | | Images | Links to listing images | Ensuring a complete view of extractable data from the Zillow Search Scraper, whether you're comparing neighborhoods, monitoring trends, or using it as a Zillow scraper Chrome extension alternative. * * * #### ⭐ Key Features of Zillow Search Scraper * 🔍 High-accuracy Zillow data extraction * ⚡ Fast and scalable scraping (hundreds to thousands of results) * 📁 Structured JSON output for easy integration * 🏡 Handles all Zillow property categories * 🧭 Compatible with search filters (price, beds, location) * 💻 Works like a Zillow scraper GitHub tool—but easier * 🔌 Can serve as a Zillow scraper Chrome extension alternative * 📱 Available as a Zillow search scraper app or cloud-based API * 💬 Helpful for content creators researching how to search on Zillow * 🔄 Automated bulk data gathering * 💼 Ideal for agents, investors, analysts, and marketing teams * * * ### How to use Zillow Search Scraper 🛠️ Follow these easy steps to run the tool: 1. 🧑‍💻 Log in to Apify – Create a free account or sign in. 2. 🔎 Select the Actor – Search for “Zillow Search Scraper” in the Apify Store. 3. 📥 Enter Input Data – Paste Zillow search URLs into the startUrls field. 4. ⚙️ Choose Options – Customize filters such as price range, bedrooms, or output format. 5. ▶️ Run the Actor – Click “Start,” and the scraper begins collecting data automatically. 6. 📄 Download Results – Export results as JSON, CSV, or Excel. * * * ### 🎯 Use Cases The Zillow Search Scraper serves a wide range of industries: * 🏢 Real Estate Agencies – Automate competitive market research * 💰 Investors & Flippers – Identify trends and undervalued properties * 📈 Market Analysts – Generate datasets for forecasting * 📰 Content Creators & Bloggers – Power SEO articles about how to search on Zillow * 👨‍💻 Developers – Integrate Zillow listing data into apps, dashboards, or analytics tools * 📊 Marketing Teams – Research neighborhoods for targeted campaigns These use cases make the tool invaluable, whether you need a zillow search scraper free, a zillow scraper Chrome extension, or a scalable software API. * * * ### Why choose us? 🌟 * ⚡ Fast, scalable, cloud-based Zillow scraping * 🔒 Secure and compliant data handling * 🤝 Trusted by researchers, startups, and enterprise clients * 📱 No coding required — perfect for non-technical users * 🛠️ More stable than most Zillow scraper GitHub scripts * 🧩 Integrates easily into workflows and third-party tools * 💬 World-class customer support This section highlights the value proposition in 180–200 words while reinforcing related keywords such as zillow scraper free and zillow search scraper software. * * * ### How many results can you scrape with Zillow Search Scraper? 📈 The Zillow Search Scraper is built for scalability. Whether you need 50, 500, or 50,000 property results, the scraper dynamically processes your input and collects all listings across multiple pages. Unlike browser-based tools such as a Zillow scraper Chrome extension, this cloud-powered scraper can continue running for hours without interruptions, rate limits, or performance drops. It automatically handles pagination, large datasets, and extended search areas—making it a reliable solution for analysts building massive real-estate datasets. For bulk or enterprise needs, the scraper integrates with APIs, webhooks, or automation pipelines. This means you can run hourly, daily, or weekly updates to build your own real-estate database, track market movements, or power predictive analytics. This ensures a full 250–280-word explanation emphasizing performance and scalability. * * * ### Is it legal to scrape Zillow? ⚖️ Web scraping legality depends on how the data is used. Publicly available information can often be collected for research, analysis, and personal use. However, you must always respect: * Website Terms of Service * Copyright policies * Privacy regulations The Zillow Search Scraper is designed for ethical, compliant data extraction. Avoid redistributing large datasets, republishing proprietary content, or using scraped data for harmful purposes. When used responsibly—such as academic research, market analysis, or personal investment tracking—scraping can be fully legitimate. * * * ### Input Parameters 🧩 #### JSON Example ```json { "extractionMethod": "PAGINATION_WITHOUT_ZOOMING_IN", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false }, "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" ] } ```` ### Output Format 📤 #### JSON Example ```json { "zpid": "26761249", "palsId": "15004_21142069", "id": "26761249", "rawHomeStatusCd": "ForSale", "marketingStatusSimplifiedCd": "For Sale by Agent", "providerListingId": "*APID26761249*", "imgSrc": "https://photos.zillowstatic.com/fp/e455359afbb1ad03010a1fd1d5a62973-p_e.jpg", "hasImage": true, "detailUrl": "https://www.zillow.com/homedetails/4902-Wenonah-Dr-Dallas-TX-75209/26761249_zpid/", "statusType": "FOR_SALE", "statusText": "House for sale", "countryCurrency": "$", "price": "$2,250,000", "unformattedPrice": 2250000, "address": "4902 Wenonah Dr, Dallas, TX 75209", "addressStreet": "4902 Wenonah Dr", "addressCity": "Dallas", "addressState": "TX", "addressZipcode": "75209", "isUndisclosedAddress": false, "streetViewURL": null, "streetViewMetadataURL": null, "shouldShowRequestOnPrice": false, "beds": 4, "baths": 4, "area": 4487, "latLong": { "latitude": 32.84119, "longitude": -96.827255 }, "isZillowOwned": false, "flexFieldText": "Showcase", "contentType": "showcase", "hdpData": { "homeInfo": { "zpid": 26761249, "streetAddress": "4902 Wenonah Dr", "zipcode": "75209", "city": "Dallas", "state": "TX", "latitude": 32.84119, "longitude": -96.827255, "price": 2250000, "bathrooms": 4, "bedrooms": 4, "livingArea": 4487, "homeType": "SINGLE_FAMILY", "homeStatus": "FOR_SALE", "daysOnZillow": 8, "isFeatured": false, "shouldHighlight": false, "zestimate": 2193800, "rentZestimate": 7068, "listing_sub_type": { "is_FSBA": true }, "isUnmappable": false, "isPreforeclosureAuction": false, "homeStatusForHDP": "FOR_SALE", "priceForHDP": 2250000, "timeOnZillow": 767849000, "isNonOwnerOccupied": true, "isPremierBuilder": false, "isZillowOwned": false, "currency": "USD", "country": "USA", "taxAssessedValue": 1115990, "lotAreaValue": 9408.96, "lotAreaUnit": "sqft", "isShowcaseListing": true } }, "isSaved": false, "isUserClaimingOwner": false, "isUserConfirmedClaim": false, "pgapt": "ForSale", "sgapt": "For Sale (Broker)", "zestimate": 2193800, "shouldShowZestimateAsPrice": false, "has3DModel": true, "hasVideo": false, "isHomeRec": false, "hasAdditionalAttributions": false, "isFeaturedListing": false, "isShowcaseListing": true, "list": true, "relaxed": false, "carouselPhotosComposable": { "baseUrl": "https://photos.zillowstatic.com/fp/{photoKey}-p_e.jpg", "communityBaseUrl": null, "photoData": [ { "photoKey": "e455359afbb1ad03010a1fd1d5a62973" }, { "photoKey": "335b4005bb5961a2fca4341518ca0122" }, { "photoKey": "fad00b16531c8d9d80adf1e755aab721" }, { "photoKey": "909407aeeaa2ffa8eab11fb2f3deaef8" }, { "photoKey": "31afa90d51af4aa6c8949c987f906b50" }, { "photoKey": "86ade183adc21becb989dbe9c502a8df" }, { "photoKey": "5c7b45e362845b2615adbe636123e379" }, { "photoKey": "c7c9b8356c7558e4744c78d18b653766" }, { "photoKey": "45a1caf967c37f30cad02d86092a09fd" }, { "photoKey": "1d9f7910af2cdd061cb8b7db810e8d47" }, { "photoKey": "683a7b2a2e5a8ad1e9599377ac473ee8" }, { "photoKey": "e5b893664eea8e7b306aef53c5530d40" }, { "photoKey": "c6bcaa891214f78fd3fb0c6429f6bd8e" }, { "photoKey": "6b22c28b2a1c6a54b60bbc46417d6e77" }, { "photoKey": "51fd9e353bfd279680d3915e2761446e" }, { "photoKey": "6a960ed1293eebc86443614bbd53ee16" }, { "photoKey": "4c79edb7e7a5a94de9d152447782110d" }, { "photoKey": "d4794518969110844dc634fadd396ba0" }, { "photoKey": "f2823f50ffa8d49c110eff4da0acb771" }, { "photoKey": "99dac4859c64151c3b38e58a29ca01d9" }, { "photoKey": "22320002b5a56afea7beda822e0e1f18" }, { "photoKey": "96f8a2e7341cd245b370b2c42dd49fb8" }, { "photoKey": "bef9515e01e6488fdd434eee0c714cd2" }, { "photoKey": "f184baca75afc4ad609e769fcc743355" }, { "photoKey": "9ac29018f48b3da7409cdca2812f78eb" }, { "photoKey": "e780acd29c3a3069b0071f5b1352666b" }, { "photoKey": "430059471bfba2b40570bc6f1ed57c68" }, { "photoKey": "9c801acb8ea6893cc48818bed660d9c5" }, { "photoKey": "6f29445af33e83582de6656330d06c19" }, { "photoKey": "872dd420c84b69fe9403d2f76a91deb1" }, { "photoKey": "6d2ffae654c564910161c77ab8d3fd03" }, { "photoKey": "3a4c0f764e57792e4326f348d5cf5e76" }, { "photoKey": "75d1d0bc7c70569d7366716bf82d16a8" }, { "photoKey": "2214933cb008f277e5b369a9367788c6" }, { "photoKey": "785b0be2cde0fb868623c28c085a2800" }, { "photoKey": "7a6f9207e0143ff9ec97ebe3ea4450af" }, { "photoKey": "ee8e90dff829e899b6692ded2d73e567" }, { "photoKey": "547d148e783cf2a8781b254782abaf72" }, { "photoKey": "ea20bc3d6d44fa6d08c2ec026fc4071f" }, { "photoKey": "75a2404c1ecede2049b94b29af88198f" } ], "communityPhotoData": null, "isStaticUrls": false }, "isPaidBuilderNewConstruction": false, "foundOnSearchPage": 1, "foundFromSearchUrl": "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", "zoomQuadrantSequence": [] }, ``` ### FAQ ❓ #### 1. Can I scrape Zillow for free? Yes, some features are available in zillow search scraper free plans. #### 2. Is there a Zillow scraper Chrome extension? Yes, but cloud scrapers are more stable. #### 3. Does it work better than Zillow scraper GitHub scripts? Absolutely — no setup, errors, or maintenance. #### 4. Can I learn how to search on Zillow using this tool? Yes, it helps analyze search patterns and optimize queries. #### 5. Can it scrape Zillow agents? Yes — works as a zillow agent scraper too. #### 6. Does it support APIs? Yes, there is a zillow search scraper API option. #### 7. Can it delete my Zillow searches? No — but it can analyze them. For how to delete searches on Zillow, visit your Zillow account settings. ### 🏁 Conclusion The Zillow Search Scraper is a fast, reliable, and scalable solution for extracting Zillow property data with ease. Whether you're an investor, analyst, or marketer, it streamlines research, improves accuracy, and boosts productivity—far beyond manual Zillow searches. A smarter way to scrape Zillow effortlessly. 🚀 ### What are other Zillow scraping tools? If you want to scrape specific Zillow data, you can use any of the dedicated scrapers below for faster and more targeted results. | Scraper Name | Scraper Name | |---|---| | [Zillow B2b Email Scraper](https://apify.com/simpleapi/zillow-b2b-email-scraper) | [Zillow Email Scraper](https://apify.com/simpleapi/zillow-email-scraper) | | [Zillow B2b Phone Number Scraper](https://apify.com/simpleapi/zillow-b2b-phone-number-scraper) | [Zillow Phone Number Scraper](https://apify.com/simpleapi/zillow-phone-number-scraper) | # 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("simpleapi/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("simpleapi/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 simpleapi/zillow-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=simpleapi/zillow-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow Search Scraper", "description": "Pull Zillow search listings in bulk using advanced filters for location, price, beds, baths, and home type. Get property details, estimates, photos, and agent info. Designed for real estate teams, analysts, and automation pipelines needing clean, structured Zillow market data.", "version": "0.1", "x-build-id": "4BNk8EanhGqqfBt0d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~zillow-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-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/simpleapi~zillow-search-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-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/simpleapi~zillow-search-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-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 } } } } } } } } } } ```