🏠 Zillow Real Estate Scraper

The ultimate tool for extracting comprehensive real estate data from Zillow.

This actor allows you to scrape detailed property information, market data, and listing details from Zillow with ease. Whether you need investment insights, market analysis, or property details, this scraper handles it all.

---

✨ Key Features

• 🔍 Comprehensive Search: Scrape from Zillow search URLs or direct property URLs.
• 🏡 Detailed Property Data: Get full details including beds, baths, sqft, price, and Zestimate.
• 📸 High-Quality Images: Bulk download property images.
• 📈 Price & Tax History: Access historical pricing and tax assessment data.
• 🚶 Walk & Transit Scores: Get walkability, transit, and bike scores for any property.
• 📍 Address Search: Scrape data simply by providing property addresses.
• 🚀 Bulk Processing: Input lists of ZUIDs, URLs, or Addresses for massive data extraction.

---

🛠️ Input Configuration

The scraper is highly flexible. Use the data_type parameter to control what data you get.

Parameter	Type	Description	Default
data_type	String	Required. The extraction mode (see below).	propertyList
zuid_list	Array	List of Zillow Unique IDs (ZPIDs).	[]
url_list	Array	List of Zillow Search Page URLs.	[]
property_url_list	Array	List of direct Property page URLs.	[]
address	Array	List of full property addresses.	[]
countOfPrice	Integer	Max number of price history records to fetch.	10
countOfTax	Integer	Max number of tax history records to fetch.	10

📊 extraction Modes (data_type)

Select one of the following modes:

Mode	Purpose	Required Input
propertyList	Scrape all listings from a Zillow search page.	url_list
propertyDetail	Get deep details for specific properties.	property_url_list OR zuid_list
propertyImages	Download all images for properties.	zuid_list OR property_url_list
priceAndtaxHistory	Extract historical price and tax data.	zuid_list OR property_url_list
transportScore	Get Walk, Transit, and Bike scores.	zuid_list
searchByUrl	Perform a search using a specific Zillow URL.	url_list

---

📝 Usage Examples

1. Scrape specific properties by URL

Get full details for specific listings.

{
  "data_type": "propertyDetail",
  "property_url_list": [
    "https://www.zillow.com/homedetails/Example-Address-CA-90403/20485717_zpid/"
  ]
}

2. Scrape by Address 🔥 New Feature

Don't have the URL? Just use the address!

{
  "data_type": "propertyDetail",
  "address": [
    "2512 28th St APT 104, Santa Monica, CA 90405",
    "1508 Harvard St #B, Santa Monica, CA 90404"
  ]
}

3. Bulk Price & Tax History for Analysis

Perfect for market trend analysis.

{
  "data_type": "priceAndtaxHistory",
  "zuid_list": ["20482366", "12345678"],
  "countOfPrice": 20,
  "countOfTax": 20
}

4. Scrape Search Results

Gather all listings from a search query (e.g., "Homes for sale in Santa Monica").

{
  "data_type": "propertyList",
  "url_list": [
    "https://www.zillow.com/santa-monica-ca/"
  ]
}

---

📦 Output Format

The actor stores results in a dataset. Each item represents a property or a data point.

Example Item (Property Detail):

{
  "zpid": "20485717",
  "streetAddress": "101 California Ave UNIT 506",
  "city": "Santa Monica",
  "state": "CA",
  "zipcode": "90403",
  "price": 1250000,
  "bedrooms": 2,
  "bathrooms": 2.0,
  "livingArea": 1100,
  "homeStatus": "FOR_SALE",
  "description": "Beautiful condo in the heart of Santa Monica..."
}