Zillow Property Scraper

Web Scraping

This actor extracts data from websites. It handles JavaScript rendering, pagination, and anti-bot measures automatically.

Note: Always respect the website's terms of service and robots.txt.

---

Web Scraping

This actor extracts data from websites. It handles JavaScript rendering, pagination, and anti-bot measures automatically.

Note: Always respect the website's terms of service and robots.txt.

---

Scrape real estate listings from Zillow by city, ZIP code, address, or landmark. Extract property details, Zestimate values, tax history, photos, and more. Perfect for real estate investors, agents, and market researchers.

Features

• Extracts data from web pages
• Handles pagination automatically
• Exports data to JSON/CSV
• Built-in proxy support
• Pay-per-result billing

Quick Start

{
  "url": "https://example.com",
  "maxResults": 100
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Required	Default	Description
demoMode	boolean	No	false	Run with sample data (free testing)
city	string	No*	-	City to search (e.g., "San Francisco, CA")
zipCode	string	No*	-	ZIP code to search (e.g., "94102")
address	string	No*	-	Address to search around (with radius)
landmark	string	No*	-	Search near a landmark or school
searchRadius	integer	No	5	Radius in miles (for address/landmark)
priceMin	integer	No	-	Minimum listing price
priceMax	integer	No	-	Maximum listing price
bedsMin	integer	No	-	Minimum bedrooms
bathsMin	integer	No	-	Minimum bathrooms
propertyTypes	array	No	all	Filter: house, condo, townhouse, lot, multi_family, manufactured, apartment
listingStatus	string	No	for_sale	Status: for_sale, pending, recently_sold, for_rent
daysOnZillow	integer	No	-	Only listings on Zillow for up to N days
maxResults	integer	No	50	Maximum listings to scrape (1-500)

*At least one location parameter required (city, zipCode, address, or landmark)

---

Output Format

Each listing includes:

{
  "platform": "zillow.com",
  "listingId": "ZL-12345678",
  "url": "https://www.zillow.com/homedetails/123-Main-St_San-Francisco-CA-94102/12345678_zpid/",
  "address": "123 Main Street",
  "addressNormalized": "123 MAIN ST, SAN FRANCISCO, CA 94102",
  "city": "San Francisco",
  "state": "CA",
  "zipCode": "94102",
  "price": 1350000,
  "priceFormatted": "$1,350,000",
  "zestimate": 1380000,
  "rentZestimate": 5200,
  "beds": 3,
  "baths": 2,
  "sqft": 1850,
  "lotSize": "2,500 sqft",
  "propertyType": "Single Family",
  "yearBuilt": 1920,
  "listingDate": "2025-12-18",
  "daysOnZillow": 6,
  "status": "For Sale",
  "description": "Stunning Victorian home...",
  "photos": [
    "https://photos.zillowstatic.com/fp/12345678-cc_ft_960.webp"
  ],
  "agent": {
    "name": "Michael Chen",
    "phone": "(415) 555-9876",
    "company": "Compass"
  },
  "features": ["Hardwood Floors", "Fireplace", "Garage", "Updated Kitchen"],
  "coordinates": {
    "lat": 37.7749,
    "lng": -122.4194
  },
  "priceHistory": [
    { "date": "2025-12-18", "price": 1350000, "event": "Listed for sale" },
    { "date": "2018-04-20", "price": 980000, "event": "Sold" }
  ],
  "taxHistory": [
    { "year": 2024, "taxPaid": 12500, "assessment": 1050000 },
    { "year": 2023, "taxPaid": 12100, "assessment": 1020000 }
  ],
  "scrapedAt": "2025-12-24T12:00:00Z"
}

Address Normalization

The addressNormalized field uses USPS-standard formatting for deduplication:

• Uppercase
• Standard abbreviations (Street → ST, Avenue → AVE, Boulevard → BLVD)
• No punctuation
• Format: STREET, CITY, STATE ZIP

Use this field to deduplicate listings across Zillow, Redfin, and Realtor.com.

---

Pricing

This actor uses pay-per-event billing:

Event	Cost
Per listing scraped	$0.05
Demo mode	Free

Cost Examples

Use Case	Listings	Cost
Daily new listings (1 city)	~20	$1.00
Weekly market analysis	~200	$10.00
Full city inventory	~500	$25.00

Compare to PropStream at $99/mo or CoStar at $500+/mo.

---

Use Cases

• Data collection
• Research
• Automation

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal