# Zillow.com Realtime Scraper (`muhammad_usama/apify-zillow`) Actor Scrapes any data-set from Zillow.com in realtime - **URL**: https://apify.com/muhammad\_usama/apify-zillow.md - **Developed by:** [Muhammad Usama](https://apify.com/muhammad_usama) (community) - **Categories:** Real estate, Automation, Lead generation - **Stats:** 11 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Zillow Scraper (Everything) The **Zillow Scraper Actor** allows you to collect **property, search, agent, lender, builder, and other real estate professional data** from Zillow using a wide range of structured endpoints. It supports filtering, batching, and concurrent execution. --- ### Key Features - Fetch property details by ZPID, URL, or address - Perform search queries by location, URL, MLS ID, polygon, coordinates, or map bounds - Collect agent information, reviews, and property listings - Retrieve property-related data: - Comparable, similar, and nearby homes - Price history, tax history, schools, and photos - Walk, transit, and bike scores - Fetch graph and chart data: - Zestimate history - Rent Zestimate - Listing price trends - Tax assessment and payment history - Collect lender, builder, and other professional details and reviews - Handles rate limits and network issues using retries - Supports concurrent and batched execution --- ### Supported Endpoints #### Search - `search:bylocation` - `search:byurl` - `search:bymlsid` - `search:bypolygon` - `search:bycoordinates` - `search:bymapbounds` - `search:autocomplete` - `property-details:byaddress` #### Property Details - `property-details:byzpid` - `property-details:byurl` #### Property Info - `property-info:comparable-homes` - `property-info:similar-homes` - `property-info:nearby-homes` - `property-info:climate` - `property-info:price-history` - `property-info:tax-history` - `property-info:schools-info` - `property-info:photos` - `property-info:walk-transit-bike` - `property-info:apartment-details` #### Graph Charts - `graph-charts:zestimate-history` - `graph-charts:rent-zestimate-history` - `graph-charts:zestimate-percent-change` - `graph-charts:listing-price` - `graph-charts:tax-assessment-history` - `graph-charts:tax-paid-history` #### Agents - `agents:bylocation` - `agents:agent-info` - `agents:agent-reviews` - `agents:for-sale-properties` - `agents:for-rent-properties` - `agents:sold-properties` #### Market Analysis - `analysis:housing-market` - `analysis:rental-market` #### Lenders - `lenders:search-bylocation` - `lenders:search-byname` - `lenders:details-byscreenName` - `lenders:reviews-bylenderId` #### Builders - `builders:search-bylocation` - `builders:search-byname` - `builders:details` - `builders:community-cards` - `builders:reviews` #### Other Professionals - `other-professionals:search-bylocation` - `other-professionals:search-byname` - `other-professionals:details-byusername` - `other-professionals:reviews-byzuid` #### Mortgage Rates - `mortgage-rates:current` --- ### Input Configuration Select **one endpoint** and provide the corresponding input array. #### Endpoint-Specific Input Fields | Field | Used For | |---------------|----------------------------------| | `zpids` | Property-based endpoints | | `urls` | Property or search by URL | | `addresses` | Property search by address | | `locations` | Location-based searches | | `mlsids` | MLS ID search | | `polygons` | Polygon-based map search | | `coordinates` | Latitude/Longitude search | | `bounds` | Map bounds search | | `queries` | Autocomplete search | | `agentNames` | Agent-related endpoints | | `names` | Lenders, builders, professionals | | `screenNames` | Lender details | | `lenderIds` | Lender reviews | | `builderIds` | Builder details and reviews | | `usernames` | Other professional details | | `zuids` | Other professional reviews | > Only provide fields required for the selected endpoint. --- ### Input Schema - Select one endpoint using the endpointKey dropdown. - Provide the corresponding input array based on the endpoint type. - Optional filters can be provided (price, beds, baths, sqft, HOA, etc.). - Only the fields required for the selected endpoint need to be provided. --- ### Endpoint Reference (with Input & Output Examples) ### Search Endpoints Available Filters: minPrice, maxPrice, beds, baths, minSqft, maxSqft, minLot, maxLot, minBuilt, maxBuilt, maxHOA, parkingSpots, daysOnZillow, isBasementFinished, isBasementUnfinished, isCityView, isMountainView, isParkView, isWaterView, is3dHome, hasPool, hasGarage, isTownhouse, isLotLand, isManufactured, isApartmentOrCondo, isApartment, isCondo, isSingleFamily, isMultiFamily, isOpenHousesOnly, isAuction, isComingSoon, isForSaleForeclosure, singleStory #### 1. Search — By Location #### Input: ```json { "endpointKey": "search:bylocation", "locations": [ "seattle-wa" ], "listType": [ "for-rent" ], "page": "2", "baths": "2", "beds": "2", "daysOnZillow": "10", "hasGarage": false, "hasPool": false, "is3dHome": false, "isApartment": false, "isApartmentOrCondo": false, "isAuction": false, "isBasementFinished": false, "isBasementUnfinished": false, "isCityView": false, "isComingSoon": false, "isCondo": false, "isForSaleForeclosure": false, "isLotLand": false, "isManufactured": false, "isMountainView": false, "isMultiFamily": false, "isOpenHousesOnly": false, "isParkView": false, "isSingleFamily": false, "isTownhouse": false, "isWaterView": false, "maxBuilt": "2020", "maxHOA": "50", "maxLot": "10000", "maxPrice": "30000", "maxSqft": "1000", "minBuilt": "2015", "minLot": "5000", "minPrice": "20000", "minSqft": "500", "parkingSpots": "1", "refinance": false, "singleStory": false } ```` #### Output ```json { "endpoint": "search:bylocation", "totalInputs": 1, "results": [ { "input": "seattle-wa", "success": true, "data": { "success": true, "totalCount": 1084, "currentPage": "2", "regionId": 16037, "results": [ { "id": "342979200", "price": "$2,998,980", "unformattedPrice": 2998980, "beds": 5, "baths": 5, "area": 4300, "livingArea": 4300, "homeType": "SINGLE_FAMILY", "marketingStatus": "New Construction", "homeStatus": "FOR_SALE", "rentZestimate": 7942, "timeOnZillow": 508029000, "taxAssessedValue": 2086000, "lotAreaValue": 5758.632, "lotAreaUnit": "sqft", "has3DModel": true, "address": { "street": "2571 26th Avenue W", "city": "Seattle", "state": "WA", "zipcode": "98199" }, }, ] } } ] } ``` #### 2. Search — By MLSID #### Input ```json { "endpointKey": "search:bymlsid", "mlsids": [ "S1710866" ] } ``` #### Output ```json { "endpoint": "search:bymlsid", "totalInputs": 1, "results": [ { "input": "S1710866", "success": true, "data": { "success": true, "totalCount": 115, "currentPage": 1, "results": [ { "id": "58964495", "price": "$229,900", "unformattedPrice": 229900, "beds": 1, "baths": 1, "area": 844, "livingArea": 844, "homeType": "CONDO", "marketingStatus": "Coming Soon", "homeStatus": "FOR_SALE", "timeOnZillow": 248829000, "taxAssessedValue": 79870, "has3DModel": true, "address": { "street": "75 Crown Knoll Court APT 103", "city": "Groton", "state": "CT", "zipcode": "06340" }, }, ] } } ] } ``` #### 3. Search — By Polygon #### Input ```json { "endpointKey": "search:bypolygon", "polygons": [ "34.05,-118.25;34.07,-118.22;34.06,-118.2" ] } ``` #### Output ```json { "endpoint": "search:bypolygon", "totalInputs": 1, "results": [ { "input": "34.05,-118.25;34.07,-118.22;34.06,-118.2", "success": true, "data": { "success": true, "totalCount": 115, "currentPage": 1, "results": [ { "id": "58964495", "price": "$229,900", "unformattedPrice": 229900, "beds": 1, "baths": 1, "area": 844, "livingArea": 844, "homeType": "CONDO", "marketingStatus": "Coming Soon", "homeStatus": "FOR_SALE", "timeOnZillow": 248982000, "taxAssessedValue": 79870, "has3DModel": true, "address": { "street": "75 Crown Knoll Court APT 103", "city": "Groton", "state": "CT", "zipcode": "06340" }, }, ] } } ] } ``` #### 4. Search — By MapBounds #### Input ```json { "endpointKey": "search:bymapbounds", "mapBounds": [ "40.99288801644816, 40.4015026337193, -73.4399776308594, -74.51938436914065" ] } ``` #### Output ```json { "endpoint": "search:bymapbounds", "totalInputs": 1, "results": [ { "input": "40.99288801644816, 40.4015026337193, -73.4399776308594, -74.51938436914065", "success": true, "data": { "success": true, "totalCount": 28291, "currentPage": 1, "results": [ { "id": "459817653", "price": "$400,000", "unformattedPrice": 400000, "beds": 3, "baths": 2, "area": 1067, "livingArea": 1067, "homeType": "CONDO", "marketingStatus": "For Sale by Agent", "homeStatus": "FOR_SALE", "address": { "street": "749 Saint Anns Avenue #50D", "city": "Bronx", "state": "NY", "zipcode": "10456" }, }, ] } } ] } ``` #### 5. Search — By Coordinates #### Input ```json { "endpointKey": "search:bycoordinates", "coordinates": [ "40.758, -73.985" ] } ``` #### Output ```json { "endpoint": "search:bycoordinates", "totalInputs": 1, "results": [ { "input": "40.758, -73.985", "success": true, "data": { "success": true, "totalCount": 2209, "currentPage": 1, "results": [ { "id": "2068952873", "price": "$128,000,000", "unformattedPrice": 128000000, "beds": 8, "baths": 10, "area": 11535, "livingArea": 11535, "homeType": "CONDO", "marketingStatus": "For Sale by Agent", "homeStatus": "FOR_SALE", "rentZestimate": 7106, "address": { "street": "217 W 57th St #127/128", "city": "New York", "state": "NY", "zipcode": "10019" }, }, ] } } ] } ``` #### 6. Search — By URl #### Input ```json { "endpointKey": "search:byurl", "urls": [ "https://www.zillow.com/new-york-ny/?searchQueryState=%7B%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22north%22%3A40.99288801644816%2C%22south%22%3A40.4015026337193%2C%22east%22%3A-73.4399776308594%2C%22west%22%3A-74.51938436914065%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%22New%20York%2C%20NY%22%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A6181%2C%22regionType%22%3A6%7D%5D%7D" ], "page": "1" } ``` #### Output ```json { "endpoint": "search:byurl", "totalInputs": 1, "results": [ { "input": "https://www.zillow.com/new-york-ny/?searchQueryState=%7B%22isMapVisible%22%3Atrue%2C%22mapBounds%22%3A%7B%22north%22%3A40.99288801644816%2C%22south%22%3A40.4015026337193%2C%22east%22%3A-73.4399776308594%2C%22west%22%3A-74.51938436914065%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%22New%20York%2C%20NY%22%2C%22regionSelection%22%3A%5B%7B%22regionId%22%3A6181%2C%22regionType%22%3A6%7D%5D%7D", "success": true, "data": { "success": true, "totalCount": 19360, "currentPage": "1", "regionId": 6181, "results": [ { "id": "459817653", "price": "$400,000", "unformattedPrice": 400000, "beds": 3, "baths": 2, "area": 1067, "livingArea": 1067, "homeType": "CONDO", "marketingStatus": "For Sale by Agent", "homeStatus": "FOR_SALE", "address": { "street": "749 Saint Anns Avenue #50D", "city": "Bronx", "state": "NY", "zipcode": "10456" }, }, ] } } ] } ``` #### 7. Search — By Autocomplete #### Input ```json { "endpointKey": "search:autocomplete", "queries": [ "london" ] } ``` #### Output ```json { "endpoint": "search:autocomplete", "totalInputs": 1, "results": [ { "input": "london", "success": true, "data": { "success": true, "totalCount": 1098, "currentPage": 1, "regionId": 792613, "results": [ { "id": "454759014", "price": "C$569,900", "unformattedPrice": 569900, "beds": 3, "baths": 2, "homeType": "SINGLE_FAMILY", "marketingStatus": "For Sale by Agent", "homeStatus": "FOR_SALE", "address": { "street": "931 Valetta St", "city": "London", "state": "ON", "zipcode": "N6H2Z4" }, }, ] } } ] } ``` ### Property Details Endpoints #### 1. Property Details — By ZPID #### Input ```json { "endpointKey": "property-details:byzpid", "zpids": [ "58974071", "58972835" ] } ``` #### Output ```json [ { "endpoint": "property-details:byzpid", "totalInputs": 2, "results": [ { "input": "58974071", "success": true, "data": { "success": true, "zpid": "58974071", "property": { "zpid": 58974071, "price": 229000, "currency": "USD", "bedrooms": 3, "bathrooms": 1, "address": { "streetAddress": "188 Shaw Street", "city": "New London", "state": "CT", "zipcode": "06320" }, } } }, ] } ] ``` #### 2. Property Details — By URL #### Input: ```json { "endpointKey": "property-details:byurl", "urls": [ "https://www.zillow.com/homedetails/188-Shaw-St-New-London-CT-06320/58974071_zpid/", "https://www.zillow.com/homedetails/57-Farmington-Ave-New-London-CT-06320/58972835_zpid/" ] } ``` #### Output ```json [ { "endpoint": "property-details:byurl", "totalInputs": 2, "results": [ { "input": "https://www.zillow.com/homedetails/188-Shaw-St-New-London-CT-06320/58974071_zpid/", "success": true, "data": { "success": true, "zpid": "58974071", "property": { "zpid": 58974071, "price": 229000, "currency": "USD", "bedrooms": 3, "bathrooms": 1, "address": { "streetAddress": "188 Shaw Street", "city": "New London", "state": "CT", "zipcode": "06320" }, } } }, ] } ] ``` #### 3. Property Details — By Address #### Input: ```json { "endpointKey": "property-details:byaddress", "addresses": [ "188-Shaw-St-New-London-CT-06320", "57-Farmington-Ave-New-London-CT-06320" ] } ``` #### Output ```json [ { "endpoint": "property-details:byaddress", "totalInputs": 2, "results": [ { "input": "188-Shaw-St-New-London-CT-06320", "success": true, "data": { "success": true, "zpid": "58974071", "property": { "zpid": 58974071, "price": 229000, "currency": "USD", "bedrooms": 3, "bathrooms": 1, "address": { "streetAddress": "188 Shaw Street", "city": "New London", "state": "CT", "zipcode": "06320" }, } } }, ] } ] ``` ### Propert-Info Endpoints Note: For all property-info endpoints (except apartment-details), you must provide one input only: either a zpid, a url, or an address. Only one field is required. #### Example ```json { "endpointKey": "", "urls": [ "https://www.zillow.com/homedetails/188-Shaw-St-New-London-CT-06320/58974071_zpid/" ] } ``` or ```json { "endpointKey": "", "zpids": [ "58974071" ] } ``` or ```json { "endpointKey": "", "addresses": [ "188-Shaw-St-New-London-CT-06320" ] } ``` #### 1. Graph Charts — Zestimate History #### Input ```json { "endpointKey": "graph-charts:zestimate-history", "zpids": [ "58974071" ] } ``` #### Output ```json { "endpoint": "graph-charts:zestimate-history", "totalInputs": 1, "results": [ { "input": "58974071", "success": true, "data": { "success": true, "zpid": "58974071", "timePeriod": "10 years", "metricType": "LOCAL_HOME_VALUES", "forecast": true, "chartData": [ { "label": "This home", "data": [ { "x": "2015-11-30", "y": 83481 }, ] }, { "label": "Sale", "data": [ { "x": "2022-05-12", "y": 130000 }, ] } ] } } ] } ``` #### 2. Graph Charts — Rent Zestimate History #### Input ```json { "endpointKey": "graph-charts:rent-zestimate-history", "zpids": [ "58974071" ] } ``` #### Output ```json { "endpoint": "graph-charts:rent-zestimate-history", "totalInputs": 1, "results": [ { "input": "58974071", "success": true, "data": { "success": true, "zpid": "58974071", "timePeriod": "10 years", "metricType": "LOCAL_RENTAL_RATES", "forecast": true, "chartData": [ { "label": "This home", "data": [ { "x": "2015-11-30", "y": 1250 }, { "x": "2015-12-31", "y": 1250 }, ] } ] } } ] } ``` #### 3. Graph Charts — Zestimate Percent Change #### Input ```json { "endpointKey": "graph-charts:zestimate-percent-change", "zpids": [ "58974071" ] } ``` #### Output ```json { "endpoint": "graph-charts:zestimate-percent-change", "totalInputs": 1, "results": [ { "input": "58974071", "success": true, "data": { "success": true, "zpid": "58974071", "currentZestimate": 225200, "previousZestimate": 220300, "absoluteChange": 4900, "percentChange": 2.22, "trend": "increase", "timeRange": "10+ years", "history": [ { "x": "2015-11-30", "y": 83481 }, { "x": "2015-12-31", "y": 78448 }, ] } } ] } ``` #### 4. Graph Charts — Listing Price #### Input ```json { "endpointKey": "graph-charts:listing-price", "zpids": [ "58974071" ] } ``` #### Output ```json { "endpoint": "graph-charts:listing-price", "totalInputs": 1, "results": [ { "input": "58974071", "success": true, "data": { "success": true, "zpid": "58974071", "totalRecords": 15, "timeRange": "10+ years", "trend": "increase", "graphData": [ { "x": "2005-02-11", "y": 100000, "label": "Sold" }, { "x": "2021-12-16", "y": 155000, "label": "Listed for sale" }, ] } } ] } ``` #### 5. Graph Charts — Tax Assessment History #### Input ```json { "endpointKey": "graph-charts:tax-assessment-history", "zpids": [ "58974071" ] } ``` #### Output ```json { "endpoint": "graph-charts:tax-assessment-history", "totalInputs": 1, "results": [ { "input": "58974071", "success": true, "data": { "success": true, "zpid": "58974071", "totalRecords": 24, "timeRange": "10+ years", "trend": "increase", "graphData": [ { "x": "2001-11-23", "y": 39410, "rate": 0 }, { "x": "2003-11-23", "y": 55090, "rate": 0.39786857 }, ] } } ] } ``` #### 6. Graph Charts — Tax Paid History #### Input ```json { "endpointKey": "graph-charts:tax-paid-history", "zpids": [ "58974071" ] } ``` #### Output ```json { "endpoint": "graph-charts:tax-paid-history", "totalInputs": 1, "results": [ { "input": "58974071", "success": true, "data": { "success": true, "zpid": "58974071", "totalRecords": 24, "timeRange": "10+ years", "trend": "increase", "graphData": [ { "x": "2001-11-23", "y": 1301, "rate": 0 }, { "x": "2003-11-23", "y": 1950, "rate": 0.49884704 }, ] } } ] } ``` ### Agents Endpoints Note: For all agents endpoints (except agents:bylocation), you must provide one input only: either an agentName or agent's profile url. Only one field is required. #### Example ```json { "endpointKey": "", "urls": [ "https://www.zillow.com/profile/TheWagersTeam" ] } ``` #### 1. Agents — By Location #### Input ```json { "endpointKey": "agents:bylocation", "locations": [ "seattle-wa" ] } ``` #### Output ```json { "endpoint": "agents:bylocation", "totalInputs": 1, "results": [ { "input": "seattle-wa", "success": true, "data": { "location": "seattle-wa", "total": 15, "agents": [ { "name": "The Every Door Team", "profileUrl": "https://www.zillow.com/profile/everydoorrealestate", "imageUrl": "https://photos.zillowstatic.com/fp/beb47ba1083d11d31becb6a7c647a8b8-h_l.jpg", "company": "Every Door Real Estate", "priceRange": "$12K - $9.3M", "salesLast12Months": "750", "totalSales": null, "rating": 5, "reviewCount": 2351, "isTopAgent": true, "tag": "TEAM" }, ] } } ] } ``` #### 2. Agents — Info #### Input ```json { "endpointKey": "agents:agent-info", "agentNames": [ "TheWagersTeam" ] } ``` #### Output ```json { "endpoint": "agents:agent-info", "totalInputs": 1, "results": [ { "input": "TheWagersTeam", "success": true, "data": { "source": "zillow", "profileUrl": "https://www.zillow.com/profile/TheWagersTeam/", "name": "The Wagers Team", "username": "TheWagersTeam", "encodedZuid": "X1-ZU1099ad31o87pl_a80zf", "email": "thewagersteam@gmail.com", "cellPhone": "(606) 813-2003", "brokeragePhone": "(606) 767-3284", "company": "Keller Williams Legacy Group", "address": { "address1": "108 Carter Dr", "address2": null, "city": "London", "state": "KY", "postalCode": "40741" }, "listings": { "forSale": 5, "forRent": 0, "pastSales": 5 }, "reviews": 5 } } ] } ``` #### 3. Agents — Reviews #### Input ```json { "endpointKey": "agents:agent-reviews", "agentNames": [ "TheWagersTeam" ] } ``` #### Output ```json { "endpoint": "agents:agent-reviews", "totalInputs": 1, "results": [ { "input": "TheWagersTeam", "success": true, "data": { "agent": "TheWagersTeam", "reviews": [ { "id": "8502503", "rating": 5, "reviewComment": "We have used The Wagers Team twice now and have had a great experience each time, would recommend to anyone. Super fast at everything, if you’re ready to buy or sell they will have you taken care of with ease!", "transactionSummary": "Bought and sold a Single Family home in 2024 in London, KY.", "createdAt": "10/21/2024", "reviewer": "Lindsey Wagers", "reviewerProfile": "https://www.zillow.com/profile/lindseywagers", }, ] } } ] } ``` #### 4. Agents — For Sale Properties #### Input ```json { "endpointKey": "agents:for-sale-properties", "agentNames": [ "TheWagersTeam" ] } ``` #### Output ```json { "endpoint": "agents:for-sale-properties", "totalInputs": 1, "results": [ { "input": "TheWagersTeam", "success": true, "data": { "agentname": "TheWagersTeam", "data": { "listings": [ { "zpid": 458503555, "home_type": "singleFamily", "address": { "line1": "1310 Rl Colyer Rd", "line2": "Somerset, KY 42501", "city": "Somerset", "stateOrProvince": "KY", "postalCode": "42501" }, "bedrooms": 3, "bathrooms": 2, "price": 169900, "latitude": 36.977604, "longitude": -84.49633, "brokerage_name": "Keller Williams Legacy Group", "listing_url": "/homedetails/1310-Rl-Colyer-Rd-Somerset-KY-42501/458503555_zpid/" }, ], "listing_count": 7 } } } ] } ``` #### 5. Agents — For Rent Properties #### Input ```json { "endpointKey": "agents:for-rent-properties", "agentNames": [ "TheWagersTeam" ] } ``` #### Output ```json { "endpoint": "agents:for-rent-properties", "totalInputs": 1, "results": [ { "input": "TheWagersTeam", "success": true, "data": { "agentname": "Matt-Laricy", "data": { "listings": [ { "zpid": 2053597306, "home_type": "apartment", "address": { "line1": "234 W Polk St #3806", "line2": "Chicago, IL 60607", "city": "Chicago", "stateOrProvince": "IL", "postalCode": "60607" }, "bedrooms": 3, "bathrooms": 2, "price": 4999, "status": "forRent", "latitude": 41.872395, "longitude": -87.63466, "brokerage_name": "Americorp", "listing_url": "/homedetails/234-W-Polk-St-3806-Chicago-IL-60607/2053597306_zpid/" }, ], "listing_count": 10 } } } ] } ``` #### 6. Agents — Sold Properties #### Input ```json { "endpointKey": "agents:sold-properties", "agentNames": [ "TheWagersTeam" ] } ``` #### Output ```json { "endpoint": "agents:sold-properties", "totalInputs": 1, "results": [ { "input": "TheWagersTeam", "success": true, "data": { "agentname": "TheWagersTeam", "data": [ { "sold_date": "10/10/2025", "price": "$80,000", "zpid": 449717339, "image_url": "https://photos.zillowstatic.com/fp/ece3a427256bb2df99f2475bba19a896-p_b.jpg", "medium_image_url": "https://photos.zillowstatic.com/fp/ece3a427256bb2df99f2475bba19a896-p_d.jpg", "image_alt": "1615 River Rd, Williamsburg, KY, 40769", "home_details_url": "/homedetails/1615-River-Rd-Williamsburg-KY-40769/449717339_zpid/", "street_address": "1615 River Rd", "city_state_zipcode": "Williamsburg, KY, 40769", "latitude": 36.762665, "longitude": -84.25821, "bathrooms": 1, "bedrooms": 3, "city": "Williamsburg", "state": "KY", "livingAreaValue": 960, "livingAreaUnitsShort": "sqft", "mlsLogoSrc": "https://photos.zillowstatic.com/fp/233923995a9f6451f8d81f4717ca30e6-zillow_web_48_23.jpg" }, ] } } ] } ``` ### Market Analysis Endpoints #### 1. Analysis — Housing Market #### Input ```json { "endpointKey": "analysis:housing-market", "cities": [ "seattle-wa" ] } ``` #### Output ```json { "endpoint": "analysis:housing-market", "totalInputs": 1, "results": [ { "input": "seattle-wa", "success": true, "data": { "success": true, "resultCount": 4, "results": [ { "success": true, "data": { "data": { "odpMarketAnalytics": { "zhviRange": [ { "timePeriodEnd": "2025-12-31", "dataValue": 832857.4759351696, "__typename": "Zhvi" }, { "timePeriodEnd": "2025-11-30", "dataValue": 830157.0337493313, "__typename": "Zhvi" }, ], "__typename": "OdpMarketAnalytics" } } } } ] } } ] } ``` #### 2. Analysis — Rental Market #### Input ```json { "endpointKey": "analysis:rental-market", "cities": [ "new-london-ct" ] } ``` #### Output ```json { "endpoint": "analysis:rental-market", "totalInputs": 1, "results": [ { "input": "new-london-ct", "success": true, "data": { "success": true, "data": { "data": { "marketPage": { "date": "2025-11-21", "zillowRentalsSrpUrl": "https://www.zillow.com/new-london-ct/apartments/", "areaName": "New London, CT", "areaType": "city", "rentHistogram": { "minPrice": 960, "maxPrice": 3700, "priceAndCount": [ { "price": 1000, "count": 5 }, { "price": 1100, "count": 5 }, ] } ] } }, } } } } ] } ``` ### Lenders Endpoints #### 1. Lenders — Search by Location #### Input ```json { "endpointKey": "lenders:search-bylocation", "locations": [ "santa-monica" ], "page": "1", "pageSize": "10" } ``` #### Output ```json { "endpoint": "lenders:search-bylocation", "totalInputs": 1, "results": [ { "input": "santa-monica", "success": true, "data": { "success": true, "currentPage": "1", "pageSize": "10", "data": { "lenders": [ { "companyName": "MORTGAGE CAPITAL PARTNERS, INC.", "confirmedReviews": 2, "id": "ZUwm0wa5qwzpqh_8jmj4", "imageId": "dd078c966f0af305e30fbdad34721893", "nmlsId": 239902, "nmlsType": "Company", "rating": 4.998327759197324, "recentReviews": 2, "screenName": "mortgagecapitalpartners", "totalReviews": 598 }, ], "totalLenders": 3636 } } } ] } ``` #### 2. Lenders — Search by Name #### Input ```json { "endpointKey": "lenders:search-byname", "names": [ "Stuart Carson" ] } ``` #### Output ```json { "endpoint": "lenders:search-byname", "totalInputs": 1, "results": [ { "input": "Stuart Carson", "success": true, "data": { "success": true, "data": { "lenders": [ { "confirmedReviews": 0, "id": "ZUxrwra3me687d_3s95i", "imageId": "8adba890f0e1329811ce7aa8124a34d4", "nmlsId": 377211, "nmlsType": "Individual", "rating": 5, "recentReviews": 0, "screenName": "Stuart Carson", "totalReviews": 4 } ], "totalLenders": 1 } } } ] } ``` #### 3. Lenders — Details by Screen Name #### Input ```json { "endpointKey": "lenders:search-byscreenName", "names": [ "Stuart Carson" ] } ``` #### Output ```json { "endpoint": "lenders:search-byscreenName", "totalInputs": 1, "results": [ { "input": "Stuart Carson", "success": true, "data": { "success": true, "data": { "success": true, "data": { "lender": { "aboutMe": "Born and raised in San Diego, California, I started selling real estate and originating mortgages back in 2003. After moving to Dallas, Texas in 2010, I decided to focus my efforts solely on mortgages. In my free time I love to cook, travel, get outdoors, stay active and spend time with family and friends. When it comes to my clients, they always come first and they can always feel comfortable contacting me any time in order to ensure their questions and concerns are always addressed immediately. Current licenses held: Texas and California. http://www.nmlsconsumeraccess.org/EntityDetails.aspx/COMPANY/135622", "address": { "address": "12698 Sandhill Lane", "city": "Los Angeles", "stateAbbreviation": "CA", "zipCode": "90094" }, "cellPhone": { "areaCode": "760", "number": "0935", "prefix": "586" }, "id": "ZUxrwra3me687d_3s95i", "rating": 5, "screenName": "Stuart Carson", "title": "Mortgage Broker NMLS# 377211 at C2 Financial NMLS# 135622", "totalReviews": 4, "website": "http://www.C2Financialmtg.com" } } } } } ] } ``` #### 4. Lenders — Reviews by Lender ID #### Input ```json { "endpointKey": "lenders:search-bylenderId", "names": [ "ZUwm0wa5qwzpqh_8jmj4" ] } ``` #### Output ```json { "endpoint": "lenders:search-bylenderId", "totalInputs": 1, "results": [ { "input": "ZUwm0wa5qwzpqh_8jmj4", "success": true, "data": { "lenderId": "ZUwm0wa5qwzpqh_8jmj4", "currentPage": 2, "pageSize": 10, "totalReviews": 598, "reviews": [ { "reviewId": "LR-CHDCZZD", "reviewerName": "michael s", "rating": 5, "title": "Hector is simply put- THE BEST!", "content": "I was introduced to Hector about 11 years ago and I have since purchased 5 homes with him. Having worked with other lenders in the past- Hector's attention to detail and advice has been priceless. He is an amazing help navigating the intimidating world of mortgages. It has also been reflected by agents and lawyers how prompt, kind and effective he is. If you have the chance to work with Hector- TAKE IT. There is simply no one else I would trust in the process of acquiring a mortgage.", "companyReviewee": { "companyName": "MORTGAGE CAPITAL PARTNERS, INC.", "id": "ZUwm0wa5qwzpqh_8jmj4", "nmlsId": 239902, "nmlsType": "Company", "screenName": "mortgagecapitalpartners" }, "serviceProvided": "LoanClosed", "updated": "2024-10-17T07:40:53.947000-07:00" }, ] } } ] } ``` ### Builders Endpoints #### 1. Builders — Search by Location #### Input ```json { "endpointKey": "builders:search-bylocation", "locations": [ "austin-tx" ], "page": "1", "pageSize": "20" } ``` #### Output ```json { "endpoint": "builders:search-bylocation", "totalInputs": 1, "results": [ { "input": "austin-tx", "success": true, "data": { "success": true, "currentPage": 1, "pageSize": 20, "totalCount": 33, "builders": [ { "feedId": 7796, "logoUrl": "https://photos.zillowstatic.com/fp/a2468c55cf91db43b9e4955dea38f3de-l_c.jpg", "name": "Meritage Homes", "description": "Not all new homes are created equal. For more than 35 years, Meritage Homes® has been setting a new standard in high-quality, energy-efficient and health-conscious homebuilding. Choose from more than 300 communities in nine states from coast to coast, each with designer-curated homes, clear pricing and a simplified buying process to help you settle into your dream home sooner.", "url": "/home-builder-profile/meritage-homes/7796/", "specCount": 3575, "communitiesCount": 436, "averageRatings": { "overallRating": 4.6, "ratingCount": 42996 } } ] } } ] } ``` #### 2. Builders — Search by Name #### Input ```json { "endpointKey": "builders:search-byname", "names": [ "LGI Homes" ] } ``` #### Output ```json { "endpoint": "builders:search-byname", "totalInputs": 1, "results": [ { "input": "LGI Homes", "success": true, "data": { "success": true, "data": [ { "feedId": 14987, "logoUrl": "https://photos.zillowstatic.com/fp/569c444b6eaa9bb3fcb7fff2eafb546e-l_c.jpg", "name": "LGI Homes", "description": "LGI Homes is one of the nation’s fastest growing homebuilders engaged in the design, construction and sale of high-quality new homes across the United States. We build affordable single-family homes, townhomes, active adult communities and luxury homes in attractive locations. We offer zero down payment options in qualifying communities, and have inventory that is ready for immediate move-in. LGI Homes is committed to serving our customers through the “dream fulfillment” of homeownership by simplifying the homebuying process and standing by our customers every step of the way. Our outstanding quality and customer service is what sets us apart from our competition.", "url": "/home-builder-profile/lgi-homes/14987/", "specCount": 2329, "communitiesCount": 151, "averageRatings": { "overallRating": 4, "ratingCount": 547 } } ] } } ] } ``` #### 3. Builders — Details #### Input ```json { "endpointKey": "builders:details", "builderIds": [ "14587" ] } ``` #### Output ```json { "endpoint": "builders:details", "totalInputs": 1, "results": [ { "input": "14587", "success": true, "data": { "success": true, "data": { "name": "Pacesetter Homes", "url": "/home-builder-profile/pacesetter-homes/14587/", "locations": [ { "name": "Dallas-Ft. Worth, TX", "providerListingIds": [30369293, 30369292], "averageRatings": null } ], "communitiesCount": 33, "averageRatings": { "overallRating": 4.2, "reviewCount": 1565, "wouldRecommendPercentage": 83 }, "specialties": [ "Active Adult", "Communities" ], "reviews": [ { "overallRating": 5, "reviewText": "The sales and construction management team were phenomenal.", "communityName": "Avery Centre East" } ] } } } ] } ``` #### 4. Builders — Community Cards #### Input ```json { "endpointKey": "builders:community-cards", "builderIds": [ "14587" ], "page": "2", } ``` #### Output ```json { "endpoint": "builders:community-cards", "totalInputs": 1, "results": [ { "input": "14587", "success": true, "data": { "success": true, "currentPage": 2, "communityCards": [ { "communityAddress": { "longitude": -96.4448562, "latitude": 32.9540131, "city": "Rockwall", "state": "TX" }, "providerListingId": 29509344, "url": "/community/gideon-grove/29509344_plid/", "style": null, "name": "Gideon Grove", "featuredImage": { "url": "https://photos.zillowstatic.com:443/fp/96826c06bab0cc30773acfbc8b9860a6-p_g.jpg" }, "minPrice": 649970, }, ] } } ] } ``` #### 5. Builders — Reviews #### Input ```json { "endpointKey": "builders:reviews", "builderIds": [ "14587" ], "page": "1", "pageSize": "10" } ``` #### Output ```json { "endpoint": "builders:reviews", "totalInputs": 1, "results": [ { "input": "14587", "success": true, "data": { "success": true, "currentPage": 1, "pageSize": 10, "reviews": [ { "reviewId": 2298271, "reviewerName": null, "overallRating": 5, "reviewText": "They made it easy to get what I wanted and needed.", "reviewDate": "2025-11-09T21:21:00+00:00", "communityName": "Walden Pond", "builderResponse": null, "builderResponseDate": null }, ] } } ] } ``` ### Other Professionals Endpoints #### 1. Other Professionals — Search by Location #### Input ```json { "endpointKey": "other-professionals:search-bylocation", "locations": [ "austin-tx" ], "page": "1", } ``` #### Output ```json { "endpoint": "other-professionals:search-bylocation", "totalInputs": 1, "results": [ { "input": "seattle-wa", "success": true, "data": { "success": true, "currentPage": 1, "result": { "location": "seattle-wa", "totalCount": 851, "data": [ { "businessName": "Pointe3 Real Estate", "encodedZuid": "X1-ZUz8umq0nxz5s9_9od0t", "fullName": "Kimberly Reidy", "location": "Seattle, WA", "phoneNumber": "(206) 237-6391", "profileLink": "/profile/Kim-Reidy", "profilePhotoSrc": "https://photos.zillowstatic.com/fp/3e916a63ffb57e09431a31077d32ad0d-h_g.jpg", "reviewExcerpt": "You'll be glad to have Kim in your corner.", "reviewExcerptDate": "2019-02-24 18:03:00", "reviewLink": "/profile/Kim-Reidy#reviews", "numTotalReviews": 34, "reviews": "34 reviews", "reviewStarsRating": 4.9 }, ] } } } ] } ``` #### 2. Other Professionals — Search by Name #### Input ```json { "endpointKey": "other-professionals:search-byname", "names": [ "Kimberly+Reidy" ], "page": "2", } ``` #### Output ```json { "endpoint": "other-professionals:search-byname", "totalInputs": 1, "results": [ { "input": "Kimberly+Reidy", "success": true, "data": { "success": true, "currentPage": "2", "result": { "name": "Kimberly Reidy", "totalCount": 316, "data": [ { "businessName": "Russell Realty Services", "encodedZuid": "X1-ZUy2g4wi1c3sw9_8mfo2", "fullName": "Kimberly Cole", "location": "Brecksville, OH", "phoneNumber": "(440) 526-9400", "profileLink": "/profile/KimberlyDawnCole", "profilePhotoSrc": "https://photos.zillowstatic.com/fp/865bd40d5425a5cb5001a9bd8367f2c1-h_g.jpg", "reviewLink": "/profile/KimberlyDawnCole#reviews", "numTotalReviews": 0, "reviews": "0 reviews", "reviewStarsRating": 0 }, ] } } } ] } ``` #### 3. Other Professionals — Details by Username #### Input ```json { "endpointKey": "other-professionals:details-byusername", "usernames": [ "InnerLoopHomes" ] } ``` #### Output ```json { "endpoint": "other-professionals:details-byusername", "totalInputs": 1, "results": [ { "input": "InnerLoopHomes", "success": true, "data": { "success": true, "data": { "displayUser": { "name": "Seth D", "screenName": "InnerLoopHomes", "profileTypes": ["consumer", "renter", "propertyManager"], "businessAddress": "Regal Wood Drive, Houston, TX 77038", "phone": "(713) 820-1996", "email": "Bluemtnlake@gmail.com", "ratings": { "average": 3, "count": 2 } }, "specialties": ["Property Management"], "reviews": [ { "rating": 1, "reviewComment": "Seth the landlord will not fix anything in the home...", "reviewer": "tangy12", "rebuttal": "The house was very clean when you rented it 3 years ago..." } ] } } } ] } ``` #### 4. Other Professionals — Reviews by ZUID #### Input ```json { "endpointKey": "other-professionals:reviews-byzuid", "zuids": [ "X1-ZUyhhmr27m6ryh_8gte6" ], "page": "1" } ``` #### Output ```json { "endpoint": "other-professionals:reviews-byzuid", "totalInputs": 1, "results": [ { "input": "X1-ZUyhhmr27m6ryh_8gte6", "success": true, "data": { "success": true, "page": 1, "totalCount": 52, "reviews": [ { "reviewComment": "David has been our property manager for over 4 years, and he's been professional, efficient, and responsive. To be transparent, we are property owners, so this review is from the owner's point of view. Having said that, he's been proactive in making sure the rental house is in a good shape, including regular annual maintenance. This is to ensure tenants get what they pay for. One thing David really stands out is his responsiveness and timely communications. Tips: believe it or not, best way to contact him is via email. He'll call me as soon as he's available whenever I ask him to call me via email. His email responses are mostly cryptic and straight to the point, and some folks may take that differently. But for us, we like his cut-to-the-chase, no-nonsense style. Believe us, we have had a different property manager before, and he may seem courteous, but his responsiveness and professionalism are not even close to David's.", "reviewId": 8938348, "reviewee": { "screenName": "DavidDrakePM", "encodedZuid": "X1-ZUyhhmr27m6ryh_8gte6" }, "reviewer": { "screenName": "awitono", "encodedZuid": "X1-ZUzwgpuia0jnd5_9wsfn" }, "rating": 5, "createDate": "2025-10-25T19:51:00", }, ] } } ] } ``` ### Mortgage Rates — Current #### Input ```json { "endpointKey": "mortgage-rates:current", "programs": ["Fixed10Year"], "loanToValueBucket": ["Normal"], "creditScoreBucket": ["VeryHigh"], "loanType": ["Conventional"], "refinance": false, "state": "NY", "zipcode": "90210", "durationDays": "30" } ``` #### Output ```json { "endpoint": "mortgage-rates:current", "success": true, "data": { "success": true, "mortgageRates": { "rates": { "Fixed10Year": { "query": { "creditScoreBucket": "VeryHigh", "loanAmountBucket": "Conforming", "loanToValueBucket": "Normal", "loanType": "Conventional", "program": "Fixed10Year", "stateAbbreviation": "NY" }, "samples": [ { "apr": 5.5, "rate": 5.5, "time": "2025-12-24T00:00:00-08:00", "volume": 0 }, { "apr": 5.5, "rate": 5.5, "time": "2025-12-25T00:00:00-08:00", "volume": 0 }, ] } } } } } ``` ### How It Works - Reads the selected endpoint and input array - Builds the appropriate Zillow API URL - Processes inputs in concurrent batches - Automatically retries failed requests - Outputs structured JSON results ### Use Cases - Real estate market analysis - Property price and tax history tracking - Agent, lender, and builder lead generation - CRM and data enrichment - Investment and rental analysis - Large-scale Zillow data extraction # Actor input Schema ## `endpointKey` (type: `string`): Choose the endpoint to fetch data. ## `locations` (type: `array`): Used when endpoint requires locations ## `mlsids` (type: `array`): Required for search:bymlsid ## `polygons` (type: `array`): Required for search:bypolygon ## `coordinates` (type: `array`): Required for search:bycoordinates (lat,lng) ## `bounds` (type: `array`): Required for search:bymapbounds (north,south,east,west) ## `queries` (type: `array`): Used when endpoint requires search queries ## `zpids` (type: `array`): Used when endpoint requires ZPIDs ## `urls` (type: `array`): Used when endpoint requires URLs ## `addresses` (type: `array`): Used when endpoint requires addresses ## `agentNames` (type: `array`): Used for agent-related endpoints ## `cities` (type: `array`): Used for market analysis endpoints ## `names` (type: `array`): Used for lender, builder, or other professional endpoints ## `screenNames` (type: `array`): Used for lender details by screen name ## `lenderIds` (type: `array`): Used for lender reviews by ID ## `builderIds` (type: `array`): Used for builder details, reviews, and community cards ## `usernames` (type: `array`): Used for other professional details by username ## `zuids` (type: `array`): Used for other professional reviews by ZUID ## `page` (type: `string`): Optional ## `pageSize` (type: `string`): Optional ## `listType` (type: `array`): Optional ## `baths` (type: `string`): Optional ## `beds` (type: `string`): Optional ## `minPrice` (type: `string`): Optional ## `maxPrice` (type: `string`): Optional ## `minSqft` (type: `string`): Optional ## `maxSqft` (type: `string`): Optional ## `minLot` (type: `string`): Optional ## `maxLot` (type: `string`): Optional ## `minBuilt` (type: `string`): Optional ## `maxBuilt` (type: `string`): Optional ## `maxHOA` (type: `string`): Optional ## `parkingSpots` (type: `string`): Optional ## `daysOnZillow` (type: `string`): Optional ## `isBasementFinished` (type: `boolean`): Optional ## `isBasementUnfinished` (type: `boolean`): Optional ## `isCityView` (type: `boolean`): Optional ## `isMountainView` (type: `boolean`): Optional ## `isParkView` (type: `boolean`): Optional ## `isWaterView` (type: `boolean`): Optional ## `is3dHome` (type: `boolean`): Optional ## `hasPool` (type: `boolean`): Optional ## `hasGarage` (type: `boolean`): Optional ## `isTownhouse` (type: `boolean`): Optional ## `isLotLand` (type: `boolean`): Optional ## `isManufactured` (type: `boolean`): Optional ## `isApartmentOrCondo` (type: `boolean`): Optional ## `isApartment` (type: `boolean`): Optional ## `isCondo` (type: `boolean`): Optional ## `isSingleFamily` (type: `boolean`): Optional ## `isMultiFamily` (type: `boolean`): Optional ## `isOpenHousesOnly` (type: `boolean`): Optional ## `isAuction` (type: `boolean`): Optional ## `isComingSoon` (type: `boolean`): Optional ## `isForSaleForeclosure` (type: `boolean`): Optional ## `singleStory` (type: `boolean`): Optional ## `programs` (type: `array`): Optional ## `refinance` (type: `boolean`): Used for mortgage rates endpoint ## `state` (type: `string`): Used for mortgage rates endpoint ## `zpidcode` (type: `string`): Used for mortgage rates endpoint ## `durationDays` (type: `string`): Used for mortgage rates endpoint ## `creditScoreBucket` (type: `array`): Optional ## `loanToValueBucket` (type: `array`): Optional ## `loanType` (type: `array`): Optional ## Actor input object example ```json {} ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("muhammad_usama/apify-zillow").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 = {} # Run the Actor and wait for it to finish run = client.actor("muhammad_usama/apify-zillow").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 '{}' | apify call muhammad_usama/apify-zillow --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=muhammad_usama/apify-zillow", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow.com Realtime Scraper", "description": "Scrapes any data-set from Zillow.com in realtime", "version": "0.0", "x-build-id": "HXeq2UwmrkPDJG4db" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammad_usama~apify-zillow/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammad_usama-apify-zillow", "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/muhammad_usama~apify-zillow/runs": { "post": { "operationId": "runs-sync-muhammad_usama-apify-zillow", "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/muhammad_usama~apify-zillow/run-sync": { "post": { "operationId": "run-sync-muhammad_usama-apify-zillow", "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": [ "endpointKey" ], "properties": { "endpointKey": { "title": "Select Endpoint", "enum": [ "search:bylocation", "search:byurl", "search:bymlsid", "search:bypolygon", "search:bycoordinates", "search:bymapbounds", "search:autocomplete", "property-details:byzpid", "property-details:byurl", "property-details:byaddress", "property-info:comparable-homes", "property-info:similar-homes", "property-info:nearby-homes", "property-info:climate", "property-info:price-history", "property-info:tax-history", "property-info:schools-info", "property-info:photos", "property-info:walk-transit-bike", "property-info:apartment-details", "graph-charts:zestimate-history", "graph-charts:rent-zestimate-history", "graph-charts:zestimate-percent-change", "graph-charts:listing-price", "graph-charts:tax-assessment-history", "graph-charts:tax-paid-history", "agents:bylocation", "agents:agent-info", "agents:agent-reviews", "agents:for-sale-properties", "agents:for-rent-properties", "agents:sold-properties", "analysis:housing-market", "analysis:rental-market", "lenders:search-bylocation", "lenders:search-byname", "lenders:details-byscreenName", "lenders:reviews-bylenderId", "builders:search-bylocation", "builders:search-byname", "builders:details", "builders:community-cards", "builders:reviews", "other-professionals:search-bylocation", "other-professionals:search-byname", "other-professionals:details-byusername", "other-professionals:reviews-byzuid", "mortgage-rates:current" ], "type": "string", "description": "Choose the endpoint to fetch data." }, "locations": { "title": "Locations", "type": "array", "description": "Used when endpoint requires locations", "items": { "type": "string" } }, "mlsids": { "title": "MLS IDs", "type": "array", "description": "Required for search:bymlsid", "items": { "type": "string" } }, "polygons": { "title": "Polygons", "type": "array", "description": "Required for search:bypolygon", "items": { "type": "string" } }, "coordinates": { "title": "Coordinates", "type": "array", "description": "Required for search:bycoordinates (lat,lng)", "items": { "type": "string" } }, "bounds": { "title": "Map Bounds", "type": "array", "description": "Required for search:bymapbounds (north,south,east,west)", "items": { "type": "string" } }, "queries": { "title": "Autocomplete Queries", "type": "array", "description": "Used when endpoint requires search queries", "items": { "type": "string" } }, "zpids": { "title": "ZPIDs", "type": "array", "description": "Used when endpoint requires ZPIDs", "items": { "type": "string" } }, "urls": { "title": "URLs", "type": "array", "description": "Used when endpoint requires URLs", "items": { "type": "string" } }, "addresses": { "title": "Addresses", "type": "array", "description": "Used when endpoint requires addresses", "items": { "type": "string" } }, "agentNames": { "title": "Agent Names", "type": "array", "description": "Used for agent-related endpoints", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Used for market analysis endpoints", "items": { "type": "string" } }, "names": { "title": "Names", "type": "array", "description": "Used for lender, builder, or other professional endpoints", "items": { "type": "string" } }, "screenNames": { "title": "Screen Names", "type": "array", "description": "Used for lender details by screen name", "items": { "type": "string" } }, "lenderIds": { "title": "Lender IDs", "type": "array", "description": "Used for lender reviews by ID", "items": { "type": "string" } }, "builderIds": { "title": "Builder IDs", "type": "array", "description": "Used for builder details, reviews, and community cards", "items": { "type": "string" } }, "usernames": { "title": "Usernames", "type": "array", "description": "Used for other professional details by username", "items": { "type": "string" } }, "zuids": { "title": "ZUIDs", "type": "array", "description": "Used for other professional reviews by ZUID", "items": { "type": "string" } }, "page": { "title": "Page Number", "type": "string", "description": "Optional" }, "pageSize": { "title": "Page Size", "type": "string", "description": "Optional" }, "listType": { "title": "Listing Type", "type": "array", "description": "Optional", "items": { "type": "string", "enum": [ "for-sale", "for-rent", "sold" ] } }, "baths": { "title": "Bathrooms", "type": "string", "description": "Optional" }, "beds": { "title": "Bedrooms", "type": "string", "description": "Optional" }, "minPrice": { "title": "Min Price", "type": "string", "description": "Optional" }, "maxPrice": { "title": "Max Price", "type": "string", "description": "Optional" }, "minSqft": { "title": "Min Sqft", "type": "string", "description": "Optional" }, "maxSqft": { "title": "Max Sqft", "type": "string", "description": "Optional" }, "minLot": { "title": "Min Lot Size", "type": "string", "description": "Optional" }, "maxLot": { "title": "Max Lot Size", "type": "string", "description": "Optional" }, "minBuilt": { "title": "Min Year Built", "type": "string", "description": "Optional" }, "maxBuilt": { "title": "Max Year Built", "type": "string", "description": "Optional" }, "maxHOA": { "title": "Max HOA Fee", "type": "string", "description": "Optional" }, "parkingSpots": { "title": "Parking Spots", "type": "string", "description": "Optional" }, "daysOnZillow": { "title": "Days on Zillow", "type": "string", "description": "Optional" }, "isBasementFinished": { "title": "Finished Basement", "type": "boolean", "description": "Optional" }, "isBasementUnfinished": { "title": "Unfinished Basement", "type": "boolean", "description": "Optional" }, "isCityView": { "title": "City View", "type": "boolean", "description": "Optional" }, "isMountainView": { "title": "Mountain View", "type": "boolean", "description": "Optional" }, "isParkView": { "title": "Park View", "type": "boolean", "description": "Optional" }, "isWaterView": { "title": "Water View", "type": "boolean", "description": "Optional" }, "is3dHome": { "title": "3D Home Available", "type": "boolean", "description": "Optional" }, "hasPool": { "title": "Pool", "type": "boolean", "description": "Optional" }, "hasGarage": { "title": "Garage", "type": "boolean", "description": "Optional" }, "isTownhouse": { "title": "Townhouse", "type": "boolean", "description": "Optional" }, "isLotLand": { "title": "Lot / Land", "type": "boolean", "description": "Optional" }, "isManufactured": { "title": "Manufactured Home", "type": "boolean", "description": "Optional" }, "isApartmentOrCondo": { "title": "Apartment or Condo", "type": "boolean", "description": "Optional" }, "isApartment": { "title": "Apartment", "type": "boolean", "description": "Optional" }, "isCondo": { "title": "Condo", "type": "boolean", "description": "Optional" }, "isSingleFamily": { "title": "Single Family", "type": "boolean", "description": "Optional" }, "isMultiFamily": { "title": "Multi Family", "type": "boolean", "description": "Optional" }, "isOpenHousesOnly": { "title": "Open Houses Only", "type": "boolean", "description": "Optional" }, "isAuction": { "title": "Auction", "type": "boolean", "description": "Optional" }, "isComingSoon": { "title": "Coming Soon", "type": "boolean", "description": "Optional" }, "isForSaleForeclosure": { "title": "For Sale Foreclosure", "type": "boolean", "description": "Optional" }, "singleStory": { "title": "Single Story", "type": "boolean", "description": "Optional" }, "programs": { "title": "Programs", "type": "array", "description": "Optional", "items": { "type": "string", "enum": [ "ARM3", "ARM5", "ARM7", "Fixed10Year", "Fixed15Year", "Fixed20Year", "Fixed30Year" ] } }, "refinance": { "title": "Refinance", "type": "boolean", "description": "Used for mortgage rates endpoint" }, "state": { "title": "State", "type": "string", "description": "Used for mortgage rates endpoint" }, "zpidcode": { "title": "ZPID Code", "type": "string", "description": "Used for mortgage rates endpoint" }, "durationDays": { "title": "Duration Days", "type": "string", "description": "Used for mortgage rates endpoint" }, "creditScoreBucket": { "title": "Credit Score", "type": "array", "description": "Optional", "items": { "type": "string", "enum": [ "High", "VeryHigh" ] } }, "loanToValueBucket": { "title": "Loan Value", "type": "array", "description": "Optional", "items": { "type": "string", "enum": [ "Normal", "High", "VeryHigh" ] } }, "loanType": { "title": "Loan type", "type": "array", "description": "Optional", "items": { "type": "string", "enum": [ "Conventional", "FHA", "VA", "USDA", "Jumbo" ] } } } }, "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 } } } } } } } } } } ```