# Zillow Property Scraper (`crawlerbros/zillow-scraper`) Actor Scrape property listings from Zillow. Get prices, descriptions, photos, agent details, schools, tax history, price history, and 30+ fields per property. - **URL**: https://apify.com/crawlerbros/zillow-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Real estate, Other, Developer tools - **Stats:** 1 total users, 0 monthly users, 75.0% runs succeeded, 16 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Zillow Property Scraper Scrape property listings from Zillow.com. Get prices, Zestimates, descriptions, photos, agent details, schools, price and tax history, HOA fees, and 30+ fields per property. Search for sale, rent, or recently sold properties across the United States. ### What is Zillow Property Scraper? Zillow Property Scraper is an Apify actor that extracts property listing data from Zillow.com. Enter a city and state, choose a search mode (buy, rent, or sold), and receive structured data for every property found. Each listing includes everything from basic details like price and square footage to enriched data such as nearby schools, tax history, price history, and property features. ### Features - **Search by location** — Find properties in any US city or state (e.g., "Houston, TX", "San Francisco, CA") - **Three search modes** — For sale (BUY), for rent (RENT), or recently sold (SOLD) - **Comprehensive property data** — Price, Zestimate, rent Zestimate, beds, baths, sqft, lot size, year built, stories, parking - **Full descriptions** — Complete property marketing text and listing details - **Photo URLs** — All listing photos with direct image links - **Agent and broker info** — Agent name, phone number, and brokerage name - **Nearby schools** — School name, rating, distance, grades, and type - **Price history** — Price changes, listing events, and price-per-sqft trends over time - **Tax history** — Assessment values, tax amounts, and year-over-year changes - **Property features** — Heating, cooling, flooring, roofing, pool, fireplace, construction materials, and more - **HOA fees** — Monthly homeowner association fees when applicable - **Direct URL support** — Paste Zillow property or search page URLs for targeted scraping - **Automatic deduplication** — No duplicate listings when combining search and direct URLs ### Use Cases - **Real estate investment analysis** — Compare listing prices, Zestimates, and price history to find undervalued properties - **Market research** — Track listing prices, sold prices, and days on market across neighborhoods - **Property comparison** — Build side-by-side comparison sheets for multiple properties in a target area - **Rental market analysis** — Compare rental prices, rent Zestimates, and availability by location - **School district research** — Find properties near top-rated schools with rating and distance data - **Agent and broker research** — Identify active listing agents and brokerages in your target market - **Tax assessment tracking** — Monitor property tax changes and assessment values over time - **Price trend monitoring** — Track price reductions, relists, and sold prices for market timing - **HOA cost analysis** — Factor in monthly HOA fees when comparing investment opportunities - **Data enrichment** — Augment your existing property database with fresh Zillow listing data ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | Search Location | String | — | City and state to search (e.g., "Houston, TX", "Miami, FL") | | Search Mode | Select | BUY | BUY (for sale), RENT (for rent), or SOLD (recently sold) | | Maximum Properties | Integer | 50 | Max property listings to scrape (1-500) | | Maximum Pages | Integer | 5 | Max search result pages to scrape (1-20). Each page returns approximately 40 properties. | | Scrape Full Details | Boolean | true | Fetch full detail pages for enriched data (schools, history, features, etc.). Disable for faster runs. | | Start URLs | URL List | — | Direct Zillow property detail URLs or search page URLs | **Note:** At least one of **Search Location** or **Start URLs** must be provided. #### Example input — Buy properties ```json { "search": "Houston, TX", "mode": "BUY", "maxItems": 50, "scrapeDetails": true } ```` #### Example input — Rental search ```json { "search": "Miami, FL", "mode": "RENT", "maxItems": 25 } ``` #### Example input — Recently sold ```json { "search": "Denver, CO", "mode": "SOLD", "maxItems": 30, "endPage": 3 } ``` #### Example input — Direct property URLs ```json { "startUrls": [ { "url": "https://www.zillow.com/homedetails/123-Main-St-Houston-TX-77001/12345678_zpid/" } ], "scrapeDetails": true } ``` ### Output Each property produces one item in the output dataset. Fields with no available data are automatically excluded from the output. #### Core Property Data | Field | Type | Description | |-------|------|-------------| | url | String | Property detail URL on Zillow.com | | zpid | String | Zillow property ID | | status | String | Listing status (e.g., for\_sale, for\_rent, sold) | | price | Number | Current listing price | | zestimate | Number | Zillow's estimated market value | | rentZestimate | Number | Zillow's estimated monthly rent value | | beds | Number | Number of bedrooms | | baths | Number | Number of bathrooms | | sqft | Number | Living area in square feet | | lotSize | String | Lot size (e.g., "8,000 sqft") | | yearBuilt | Number | Year the property was constructed | | propertyType | String | Property type (e.g., SINGLE\_FAMILY, CONDO, TOWNHOUSE) | | stories | Number | Number of stories | | parking | String | Parking details (e.g., "2 garage spaces") | | hoaFee | Number | Monthly HOA fee | | pricePerSqft | Number | Price per square foot | | daysOnZillow | Number | Days the property has been listed on Zillow | #### Location | Field | Type | Description | |-------|------|-------------| | address | String | Street address | | city | String | City name | | state | String | State code (e.g., "TX") | | zipCode | String | ZIP code | | latitude | Number | Latitude coordinate | | longitude | Number | Longitude coordinate | #### Agent and Broker | Field | Type | Description | |-------|------|-------------| | brokerName | String | Brokerage company name | | agentName | String | Listing agent name | | agentPhone | String | Listing agent phone number | #### Rich Data (from detail pages) | Field | Type | Description | |-------|------|-------------| | description | String | Full property description text | | photos | Array | Photo URLs for the property listing | | priceHistory | Array | Price change events — date, event type, price, price per sqft, source | | taxHistory | Array | Tax records — year, tax paid, assessed value, change rate | | schools | Array | Nearby schools — name, level, grades, distance, rating, type | | features | Object | Property features — heating, cooling, flooring, roofing, pool, fireplace, construction, and more | | scrapedAt | String | ISO timestamp when data was collected | #### Sample output ```json { "url": "https://www.zillow.com/homedetails/46-Kingwood-Greens-Dr-Kingwood-TX-77339/28065573_zpid/", "zpid": "28065573", "status": "for_sale", "price": 318000, "zestimate": 325000, "rentZestimate": 2400, "beds": 5, "baths": 4, "sqft": 5526, "lotSize": "22,346 sqft", "yearBuilt": 2000, "propertyType": "SINGLE_FAMILY", "stories": 2, "parking": "3 garage spaces", "hoaFee": 150, "pricePerSqft": 58, "daysOnZillow": 14, "address": "46 Kingwood Greens Dr", "city": "Kingwood", "state": "TX", "zipCode": "77339", "latitude": 30.033194, "longitude": -95.180402, "brokerName": "REALHome Services and Solutions, Inc.", "agentName": "Lori Brown", "agentPhone": "(979) 255-0702", "description": "Spacious 5 bedroom home in Kingwood with pool and 3-car garage. Updated kitchen, hardwood floors throughout, and large backyard with mature trees...", "photos": [ "https://photos.zillowstatic.com/fp/example1.jpg", "https://photos.zillowstatic.com/fp/example2.jpg" ], "priceHistory": [ { "date": "2026-03-01", "event": "Listed", "price": 318000, "pricePerSqft": 58, "priceChangeRate": 0, "source": "HAR" }, { "date": "2002-01-03", "event": "Sold", "price": 215000, "pricePerSqft": 39, "priceChangeRate": 0, "source": "Public Record" } ], "taxHistory": [ { "year": 2025, "taxPaid": 8500, "value": 310000, "taxIncreaseRate": 0.02, "valueIncreaseRate": 0.03 } ], "schools": [ { "name": "Kingwood Park High School", "level": "High", "grades": "9-12", "distance": 1.2, "rating": 7, "type": "public" } ], "features": { "heating": ["Central"], "cooling": ["Central Air"], "flooring": ["Hardwood", "Tile"], "roofType": "Composition", "poolFeatures": ["In Ground"], "parkingFeatures": ["Attached Garage"] }, "scrapedAt": "2026-03-25T12:00:00.000000+00:00" } ``` ### FAQ **Do I need a proxy to scrape Zillow?** No configuration is needed on your part. The scraper automatically uses a residential proxy to access Zillow.com reliably. **What is the difference between BUY, RENT, and SOLD modes?** BUY searches active for-sale listings, RENT searches rental apartments and homes, and SOLD returns recently sold properties with their final sale prices. **What is a Zestimate?** A Zestimate is Zillow's proprietary estimated market value for a property. The rent Zestimate is a similar estimate for what a property could rent for monthly. Both are included in the output when available. **How many properties can I scrape per run?** You can scrape up to 500 properties per run. Each search page returns approximately 40 listings, and you can configure up to 20 pages per search. **Why are some fields missing from certain properties?** The scraper automatically removes empty fields from the output. Not all Zillow listings have complete data — some may lack Zestimates, tax history, school data, or HOA fees depending on the property and location. **What happens if I set Scrape Full Details to false?** Disabling detail enrichment produces a significantly faster run. You will still receive core listing data (price, beds, baths, sqft, address, Zestimate) from search results, but you will not get schools, tax history, price history, full descriptions, or property features. **Can I scrape a specific ZIP code or neighborhood?** Yes. Enter the location in the Search Location field using formats like "77339" (ZIP code), "Kingwood, TX" (neighborhood and state), or any location Zillow recognizes. **Can I scrape specific Zillow URLs directly?** Yes. Paste any Zillow property detail URL or search results page URL into the Start URLs field. You can combine direct URLs with a location search in the same run. **How fast is the scraper?** Speed depends on whether detail enrichment is enabled. With details enabled, expect approximately 5-10 properties per minute. With details disabled, each search page (approximately 40 properties) loads in a few seconds. **How current is the data?** The scraper extracts live data directly from Zillow.com at the time of each run. Every output item includes a scrapedAt timestamp so you know exactly when the data was collected. # Actor input Schema ## `search` (type: `string`): City and state to search for properties (e.g., 'Houston, TX', 'San Francisco, CA', 'Miami, FL'). ## `mode` (type: `string`): Type of property search — for sale, for rent, or recently sold. ## `maxItems` (type: `integer`): Maximum number of property listings to scrape (1-500). ## `endPage` (type: `integer`): Maximum search result pages to scrape per search (1-20). Each page has up to 40 properties. ## `scrapeDetails` (type: `boolean`): Fetch each property's detail page for full description, schools, tax history, price history, and more. Disable for faster runs with only search-level data. ## `startUrls` (type: `array`): Direct Zillow property detail URLs or search page URLs. Paste URLs from your browser. ## Actor input object example ```json { "search": "Houston, TX", "mode": "BUY", "maxItems": 5, "endPage": 1, "scrapeDetails": true } ``` # Actor output Schema ## `properties` (type: `string`): Dataset containing scraped property listings # 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 = { "search": "Houston, TX", "maxItems": 5, "endPage": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/zillow-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 = { "search": "Houston, TX", "maxItems": 5, "endPage": 1, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/zillow-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 '{ "search": "Houston, TX", "maxItems": 5, "endPage": 1 }' | apify call crawlerbros/zillow-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/zillow-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow Property Scraper", "description": "Scrape property listings from Zillow. Get prices, descriptions, photos, agent details, schools, tax history, price history, and 30+ fields per property.", "version": "1.0", "x-build-id": "bgn0Hfj5rtH7fbBnN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~zillow-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-zillow-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/crawlerbros~zillow-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-zillow-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/crawlerbros~zillow-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-zillow-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "search": { "title": "Search Location", "type": "string", "description": "City and state to search for properties (e.g., 'Houston, TX', 'San Francisco, CA', 'Miami, FL')." }, "mode": { "title": "Search Mode", "enum": [ "BUY", "RENT", "SOLD" ], "type": "string", "description": "Type of property search — for sale, for rent, or recently sold.", "default": "BUY" }, "maxItems": { "title": "Maximum Properties", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of property listings to scrape (1-500).", "default": 50 }, "endPage": { "title": "Maximum Pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum search result pages to scrape per search (1-20). Each page has up to 40 properties.", "default": 5 }, "scrapeDetails": { "title": "Scrape Full Details", "type": "boolean", "description": "Fetch each property's detail page for full description, schools, tax history, price history, and more. Disable for faster runs with only search-level data.", "default": true }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct Zillow property detail URLs or search page URLs. Paste URLs from your browser.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } } ```