Zillow Property Data Fetcher - Apify Actor

📋 Overview

This Apify Actor fetches property-related data from Zillow using various data types. It supports bulk processing of multiple properties through ZUIDs or URLs.

🚀 Features

• Fetch property listings
• Get property images
• Retrieve price and tax history
• Get transportation scores
• Search properties by URL
• Bulk processing support (multiple ZUIDs/URLs)

📊 Input Schema

Required Fields

Field	Type	Required	Description
data_type	String (select)	✅ Yes	Type of data to fetch

Optional Fields

Field	Type	Required	Description	Default
zuid_list	Array of Strings	Conditional*	List of Zillow Unique IDs (one per line)	-
url_list	Array of Strings	Conditional*	List of Zillow page URLs (one per line)	-
countOfPrice	Integer	No	Number of price history records	10
countOfTax	Integer	No	Number of tax history records	10

* Either zuid_list or url_list is required depending on the data_type selected.

🔧 Data Types & Required Parameters

Data Type	Description	Requires ZUID	Requires URL	Uses Price/Tax Count
propertyList	Get list of properties from a search page	❌	✅	❌
propertyImages	Fetch all images for a property	✅	✅ (optional)	❌
priceAndtaxHistory	Get price and tax history	✅	✅ (optional)	✅
transportScore	Get transportation/walk score	✅	❌	❌
searchByUrl	Search properties by URL	❌	✅	❌

📝 Input Examples

Example 1: Fetch Property Images (Single ZUID)

{
  "data_type": "propertyImages",
  "zuid_list": [
    "20482366"
  ]
}

Example 2: Get Price and Tax History (Multiple ZUIDs)

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

Example 3: Fetch Property List (Multiple URLs)

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

Example 4: Get Transportation Score

{
  "data_type": "transportScore",
  "zuid_list": [
    "20482366",
    "98765432"
  ]
}

Example 5: Search by URL

{
  "data_type": "searchByUrl",
  "url_list": [
    "https://www.zillow.com/homes/for_sale/"
  ]
}

📤 Output Examples

Property Images Output

{
  "zuid": "20482366",
  "images": [
    {
      "url": "https://photos.zillowstatic.com/image1.jpg",
      "caption": "Living Room"
    },
    {
      "url": "https://photos.zillowstatic.com/image2.jpg",
      "caption": "Kitchen"
    }
  ],
  "totalImages": 25
}

Price and Tax History Output

{
  "zuid": "20482366",
  "priceHistory": [
    {
      "date": "2024-01-15",
      "price": 450000,
      "event": "Sold"
    },
    {
      "date": "2023-12-01",
      "price": 445000,
      "event": "Listed"
    }
  ],
  "taxHistory": [
    {
      "year": 2024,
      "taxAmount": 5400,
      "assessedValue": 440000
    },
    {
      "year": 2023,
      "taxAmount": 5200,
      "assessedValue": 425000
    }
  ]
}

Transport Score Output

{
  "zuid": "20482366",
  "walkScore": 78,
  "transitScore": 65,
  "bikeScore": 72,
  "description": "Very Walkable"
}

Property List Output

{
  "url": "https://www.zillow.com/dunwoody-ga-30360/",
  "properties": [
    {
      "zuid": "20482366",
      "address": "123 Main St, Dunwoody, GA 30360",
      "price": 450000,
      "beds": 3,
      "baths": 2,
      "sqft": 1850
    },
    {
      "zuid": "20482367",
      "address": "456 Oak Ave, Dunwoody, GA 30360",
      "price": 525000,
      "beds": 4,
      "baths": 3,
      "sqft": 2200
    }
  ],
  "totalResults": 45
}

💡 Usage Tips

Bulk Processing

• Enter multiple ZUIDs or URLs, one per line in the input fields
• Each entry will be processed separately
• Results will be aggregated in the output

Performance Optimization

• Use countOfPrice and countOfTax to limit the amount of historical data fetched
• Smaller counts = faster processing
• Default values (10 each) work well for most use cases

Common Use Cases

1. Property Research

• Use propertyList to discover properties in an area
• Then use propertyImages and priceAndtaxHistory for detailed information

2. Market Analysis

• Use priceAndtaxHistory with higher counts (20-50) for trend analysis
• Combine with transportScore for location quality assessment

3. Bulk Property Data

• Input multiple ZUIDs in zuid_list for batch processing
• Useful for portfolio analysis or comparative market analysis

⚠️ Error Handling

The actor returns error messages in the following format:

{
  "error": "Invalid data type"
}

Common errors:

• Missing required parameter: Ensure ZUID or URL is provided based on data type
• Invalid ZUID: Check that the ZUID is a valid Zillow property ID
• Invalid URL: Ensure the URL is a valid Zillow page URL

🔗 Field Mapping Guide

You Want To...	Use data_type	Provide	Optional Parameters
Browse listings in an area	propertyList	url_list	-
See photos of properties	propertyImages	zuid_list	-
Check price changes over time	priceAndtaxHistory	zuid_list	countOfPrice, countOfTax
Evaluate walkability	transportScore	zuid_list	-
Search specific URL results	searchByUrl	url_list	-