Pricing

Rating

Developer

Actor stats

Categories

Share

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

Optional Fields

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

🔧 Data Types & Required Parameters

📝 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