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) json { "data_type": "propertyImages", "zuid_list": [ "20482366" ] } ### Example 2: Get Price and Tax History (Multiple ZUIDs) json { "data_type": "priceAndtaxHistory", "zuid_list": [ "20482366", "12345678", "87654321" ], "countOfPrice": 15, "countOfTax": 20 } ### Example 3: Fetch Property List (Multiple URLs) json { "data_type": "propertyList", "url_list": [ "https://www.zillow.com/dunwoody-ga-30360/", "https://www.zillow.com/santa-monica-ca/" ] } ### Example 4: Get Transportation Score json { "data_type": "transportScore", "zuid_list": [ "20482366", "98765432" ] } ### Example 5: Search by URL json { "data_type": "searchByUrl", "url_list": [ "https://www.zillow.com/homes/for_sale/" ] } ## 📤 Output Examples ### Property Images Output json { "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 json { "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 json { "zuid": "20482366", "walkScore": 78, "transitScore": 65, "bikeScore": 72, "description": "Very Walkable" } ### Property List Output json { "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: json { "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 | - |