# Zillow Property Scraper (`scrapyspider/zillow-property-scraper`) Actor Scrapes Zillow property listings across all US states — FSBO, recently sold, and agent listings. Extracts prices, addresses, lot sizes, agent contacts, images, and property history. Filter by state, property type, lot size, and days on market. - **URL**: https://apify.com/scrapyspider/zillow-property-scraper.md - **Developed by:** [ScrapySpider](https://apify.com/scrapyspider) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Scrapes Zillow property listings in bulk across all US states — FSBO, recently sold, and agent listings — and returns structured JSON with prices, addresses, agent contacts, lot sizes, images, and full property history. No Zillow account or cookies required. - No Zillow account or cookies needed - Three scrape modes: FSBO, Recently Sold, and For Sale By Agent - All 50 US states + territories supported with county-level targeting - Extracts 60+ fields per property including agent contact info - Filter by property type, lot size, days on market, and keywords - Outputs clean JSON ready for download as CSV, Excel, or JSON #### What data does it extract? Each result contains: **Property info:** Zillow ID (zpid), address (street, city, state, ZIP, county), latitude, longitude, property type, status, description **Pricing:** listing price, Zestimate, rent Zestimate, last sold price, last sold date, price history **Details:** bedrooms, bathrooms, living area (sqft), lot size, year built, days on Zillow, home type **Agent/broker info:** agency name, agent name, agent email, agent phone, broker phone **Media:** up to 10 property images **Historical data:** complete price history, sold events with dates and prices #### Use cases - **Real estate investing:** Find FSBO properties and off-market deals before they hit the MLS - **Seller outreach:** Identify recently sold properties for expired listing campaigns and agent prospecting - **Land investment:** Target large land parcels in specific states with lot size filters - **Market research:** Analyze property prices, days on market, and inventory across regions - **Lead generation:** Build targeted property owner lists for direct mail or cold outreach campaigns - **Portfolio analysis:** Monitor property values and Zestimates across multiple states #### How to use 1. Click **Try for free** above 2. In the **Input** tab, select your scrape mode (FSBO, Recently Sold, or For Sale By Agent) 3. Choose one or more US states to search 4. Optionally set property type, lot size, and days on market filters 5. Click **Start** and wait for the run to complete 6. Download your results as JSON, CSV, or Excel from the **Dataset** tab #### Input parameters | Parameter | Type | Required | Description | |---|---|---|---| | `runConfig` | Array of strings | Yes | Scrape mode(s): `FSBO` (For Sale By Owner), `AgentSold` (Recently Sold), `FSBA` (For Sale By Agent). You can select multiple. | | `stateCodes` | Array of strings | Yes | US state codes to search. Example: `["ca", "tx", "fl"]` | | `propertyType` | Array of strings | No | Property types to include: `sf` (Houses), `land` (Lots), `mf` (Multi-family), `con` (Condos), `tow` (Townhomes), `apa` (Apartments), `manu` (Manufactured). Default: `["sf"]` | | `daysOnZillow` | String | No | Max days listed. Values: `any`, `1`, `7`, `14`, `30`, `90`, `6m`, `12m`, `24m`, `36m`. Default: `any` | | `daysOnZillowMin` | String | No | Min days listed. Same values as above. Default: `0` (any) | | `lotSizeMin` | String | No | Min lot size in sqft. Example: `43560` = 1 acre. Default: no minimum | | `lotSizeMax` | String | No | Max lot size in sqft. Example: `4356000` = 100 acres. Default: no maximum | | `keywordSearch` | String | No | Keyword to search in property descriptions. Example: `waterfront`, `motivated`, `pool` | | `soldYearsAgo` | Integer | No | For AgentSold mode: only include properties where previous sale was at least this many years ago. `0` = disabled. Default: `0` | #### Output example ```json { "SCRAPE_TYPE": "FSBO", "DETAIL_URL": "https://www.zillow.com/homedetails/123-Main-St-Austin-TX-78701/12345678_zpid/", "STATE_CODE": "tx", "REGION_NAME": "travis-county", "zpid": 12345678, "statusType": "FOR_SALE", "statusText": "For Sale by Owner", "address": { "streetAddress": "123 Main St", "city": "Austin", "state": "TX", "zipcode": "78701", "county": "Travis County" }, "price": 450000, "zestimate": 465000, "bedrooms": 3, "bathrooms": 2, "livingArea": 1850, "lotAreaValue": 8712, "lotAreaString": "0.2 acres", "yearBuilt": 2005, "daysOnZillow": 14, "homeType": "SINGLE_FAMILY", "description": "Beautiful 3-bed, 2-bath home in the heart of Austin...", "latitude": 30.2672, "longitude": -97.7431, "images": [ "https://photos.zillowstatic.com/fp/abc123.jpg", "https://photos.zillowstatic.com/fp/def456.jpg" ] } ```` #### Pricing This Actor is **free to use** — you only pay for Apify platform compute time and proxy usage. A typical run scraping 1 state (FSBO mode) costs approximately **$0.10–$0.50** in Apify platform credits depending on the number of listings found. New Apify accounts receive **$5 in free credits** — enough for dozens of scraping runs. **Note:** This Actor requires Apify Residential proxies for reliable operation. #### Technical notes - **No account needed:** This Actor does not require a Zillow login or cookies - **Residential proxies required:** Uses Apify's residential proxy pool for best success rates. Without residential proxies, requests will likely be blocked. - **Anti-detection:** Built-in TLS fingerprinting mimics Chrome 145 on Windows for stealth - **Rate limits:** Zillow limits results to 20 pages per region (800 properties). Use more specific filters if you need more coverage. - **Pagination:** Automatically handles multi-page results (up to 20 pages per region) - **Deduplication:** Tracks previously scraped property IDs across runs to avoid duplicates - **Concurrency:** Runs with 2 concurrent requests for stability against blocking - **Data freshness:** All data is scraped live — no cached or stale data - **Technology:** BasicCrawler with Cheerio + Impit (no browser required — 10x faster than browser-based scrapers) #### Integrations Outputs are compatible with: - **Make (formerly Integromat):** Use the Apify module to trigger runs and send data to Google Sheets or Airtable - **Zapier:** Connect Actor runs to 5,000+ apps via the Apify Zapier app - **Google Sheets:** Export dataset directly as CSV and import - **REST API:** Run the Actor programmatically and poll results via the [Apify API](https://docs.apify.com/api/v2) - **Python / Node.js:** Use the [Apify Client](https://docs.apify.com/api/client/js) to integrate into your applications #### Support Have questions or found a bug? Reach out: - **Email:** ScrapySpider@protonmail.com - **Website:** [ScrapySpider.com](https://ScrapySpider.com) - **Apify:** Open an issue on this Actor's page - **Response time:** Within 24–48 hours on weekdays # Actor input Schema ## `runConfig` (type: `array`): Select which listing types to scrape. FSBO = For Sale By Owner, AgentSold = Recently Sold (agent listings), FSBA = For Sale By Agent (active MLS listings). ## `stateCodes` (type: `array`): Select US states to scrape properties from. Each state will generate separate search requests by county. ## `propertyType` (type: `array`): Filter by property type. Select one or more types to include in the search results. ## `daysOnZillow` (type: `string`): Filter properties by maximum days they have been listed on Zillow. Select 'Any' for no restriction. ## `daysOnZillowMin` (type: `string`): Filter properties that have been listed for at least this many days. Useful for finding stale listings that may indicate motivated sellers. ## `lotSizeMin` (type: `string`): Minimum lot size filter in square feet. ## `lotSizeMax` (type: `string`): Maximum lot size filter in square feet. ## `keywordSearch` (type: `string`): Optional keyword to search for in property descriptions. Examples: 'motivated', 'fixer-upper', 'waterfront', 'pool', 'acreage'. ## `soldYearsAgo` (type: `integer`): For AgentSold mode: only include properties where the previous sale was at least this many years ago. Set to 0 to disable this filter. ## Actor input object example ```json { "runConfig": [ "FSBO" ], "stateCodes": [ "ca" ], "propertyType": [ "sf" ], "daysOnZillow": "any", "daysOnZillowMin": "0", "lotSizeMin": "", "lotSizeMax": "", "soldYearsAgo": 0 } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `propertyDetails` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "runConfig": [ "FSBO" ], "stateCodes": [ "ca" ], "propertyType": [ "sf" ], "daysOnZillow": "any" }; // Run the Actor and wait for it to finish const run = await client.actor("scrapyspider/zillow-property-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 = { "runConfig": ["FSBO"], "stateCodes": ["ca"], "propertyType": ["sf"], "daysOnZillow": "any", } # Run the Actor and wait for it to finish run = client.actor("scrapyspider/zillow-property-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 '{ "runConfig": [ "FSBO" ], "stateCodes": [ "ca" ], "propertyType": [ "sf" ], "daysOnZillow": "any" }' | apify call scrapyspider/zillow-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapyspider/zillow-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow Property Scraper", "description": "Scrapes Zillow property listings across all US states — FSBO, recently sold, and agent listings. Extracts prices, addresses, lot sizes, agent contacts, images, and property history. Filter by state, property type, lot size, and days on market.", "version": "1.0", "x-build-id": "ybNWgL7wwJHYxemqp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyspider~zillow-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyspider-zillow-property-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/scrapyspider~zillow-property-scraper/runs": { "post": { "operationId": "runs-sync-scrapyspider-zillow-property-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/scrapyspider~zillow-property-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyspider-zillow-property-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": [ "runConfig", "stateCodes" ], "properties": { "runConfig": { "title": "Scrape Mode", "uniqueItems": true, "type": "array", "description": "Select which listing types to scrape. FSBO = For Sale By Owner, AgentSold = Recently Sold (agent listings), FSBA = For Sale By Agent (active MLS listings).", "items": { "type": "string", "enum": [ "FSBO", "AgentSold", "FSBA" ], "enumTitles": [ "For Sale By Owner (FSBO)", "Recently Sold (AgentSold)", "For Sale By Agent (FSBA)" ] }, "default": [ "FSBO" ] }, "stateCodes": { "title": "US States", "uniqueItems": true, "type": "array", "description": "Select US states to scrape properties from. Each state will generate separate search requests by county.", "items": { "type": "string", "enum": [ "ak", "al", "ar", "az", "ca", "co", "ct", "de", "fl", "ga", "hi", "ia", "id", "il", "in", "ks", "ky", "la", "ma", "md", "me", "mi", "mn", "mo", "ms", "mt", "nc", "nd", "ne", "nh", "nj", "nm", "nv", "ny", "oh", "ok", "or", "pa", "ri", "sc", "sd", "tn", "tx", "ut", "va", "vt", "wa", "dc", "wi", "wv", "wy" ], "enumTitles": [ "Alaska", "Alabama", "Arkansas", "Arizona", "California", "Colorado", "Connecticut", "Delaware", "Florida", "Georgia", "Hawaii", "Iowa", "Idaho", "Illinois", "Indiana", "Kansas", "Kentucky", "Louisiana", "Massachusetts", "Maryland", "Maine", "Michigan", "Minnesota", "Missouri", "Mississippi", "Montana", "North Carolina", "North Dakota", "Nebraska", "New Hampshire", "New Jersey", "New Mexico", "Nevada", "New York", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Virginia", "Vermont", "Washington", "Washington DC", "Wisconsin", "West Virginia", "Wyoming" ] }, "default": [ "ca", "tx", "fl" ] }, "propertyType": { "title": "Property Type", "uniqueItems": true, "type": "array", "description": "Filter by property type. Select one or more types to include in the search results.", "items": { "type": "string", "enum": [ "sf", "apa", "land", "tow", "mf", "con", "manu" ], "enumTitles": [ "Houses/Single Family", "Apartments", "Lots/Land", "Townhomes", "Multi-family", "Condos/Co-ops", "Manufactured" ] }, "default": [ "sf" ] }, "daysOnZillow": { "title": "Days on Zillow (Max)", "enum": [ "any", "1", "7", "14", "30", "90", "6m", "12m", "24m", "36m" ], "type": "string", "description": "Filter properties by maximum days they have been listed on Zillow. Select 'Any' for no restriction.", "default": "any" }, "daysOnZillowMin": { "title": "Days on Zillow (Min)", "enum": [ "0", "1", "7", "14", "30", "90", "6m", "12m", "24m", "36m" ], "type": "string", "description": "Filter properties that have been listed for at least this many days. Useful for finding stale listings that may indicate motivated sellers.", "default": "0" }, "lotSizeMin": { "title": "Lot Size (Min)", "enum": [ "", "1000", "2000", "3000", "4000", "5000", "7500", "10890", "21780", "43560", "87120", "217800", "435600", "871200", "2178000" ], "type": "string", "description": "Minimum lot size filter in square feet.", "default": "" }, "lotSizeMax": { "title": "Lot Size (Max)", "enum": [ "1000", "2000", "3000", "4000", "5000", "7500", "10890", "21780", "43560", "87120", "217800", "435600", "871200", "2178000", "4356000", "" ], "type": "string", "description": "Maximum lot size filter in square feet.", "default": "" }, "keywordSearch": { "title": "Keyword Search", "type": "string", "description": "Optional keyword to search for in property descriptions. Examples: 'motivated', 'fixer-upper', 'waterfront', 'pool', 'acreage'." }, "soldYearsAgo": { "title": "Sold Years Ago (Threshold)", "minimum": 0, "maximum": 50, "type": "integer", "description": "For AgentSold mode: only include properties where the previous sale was at least this many years ago. Set to 0 to disable this filter.", "default": 0 } } }, "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 } } } } } } } } } } ```