Zillow Property & Agent Data Scraper

Extract detailed property listings and agent contact information from Zillow with flexible search options and cost-effective pricing.

🌟 Key Features

• Two Operation Modes:

  • 🗺️ ZIP Code Search - Find properties in specific areas
  • 🎯 Direct ZPID Processing - Process known property IDs (faster & cheaper)

• Rich Data Extraction:

  • Property details (price, size, year built, lot size)
  • Agent contact information (name, email, phone)
  • Broker information
  • Price history and tax history
  • Days on market
  • Property descriptions

• Advanced Filtering:

  • Property type (single family, condo, townhouse, etc.)
  • Price range, bedrooms, bathrooms
  • Square footage, lot size
  • Days on Zillow
  • Features (pool, new construction, etc.)
  • Listing type (by agent, FSBO, etc.)

• Budget Control:

  • Set spending limits per run
  • Automatic stop when budget is reached
  • Clear cost transparency

💰 Pricing

This actor uses Pay-Per-Result pricing with volume discounts - you only pay for successfully enriched properties:

📊 Pricing Tiers

Subscription	Price per Property	Discount	Best For
No subscription	$0.08	—	Testing & small projects
Bronze 🥉	$0.07	-12.5%	Small businesses (500-2k/month)
Silver 🥈	$0.06	-25%	Growing companies (2k-10k/month)
Gold 🏆	$0.05	-37.5%	Enterprise & high volume (10k+/month)

💡 Volume Savings Calculator

Properties/Month	No Discount	Bronze 🥉	Silver 🥈	Gold 🏆
500	$40	$35 (save $60/yr)	$30	$25
1,000	$80	$70 (save $120/yr)	$60	$50
2,000	$160	$140	$120 (save $480/yr)	$100
5,000	$400	$350	$300 (save $1,200/yr)	$250
10,000	$800	$700	$600	$500 (save $3,600/yr)

Simple & Transparent

• ✅ No search fees - ZIP code searches are included
• ✅ Pay only for results - If a property can't be enriched, it's free
• ✅ Volume discounts - Save up to 37.5% on Gold tier
• ✅ No hidden costs - Clear pricing, no surprises

Cost Examples

Example 1: Small Real Estate Agent (Bronze)

• Input: 100 ZPIDs
• Cost: 100 × $0.07 = $7.00 (vs $8.00 without discount)
• Annual savings: $12 if processing monthly

Example 2: Lead Generation Company (Silver)

• Input: 5 ZIP codes, 300 properties found total
• Cost: 300 × $0.06 = $18.00 (vs $24.00 without discount)
• Annual savings: $72/month = $864/year if processing monthly

Example 3: Enterprise Data Firm (Gold)

• Input: 50 ZIP codes with filters, 10,000 properties match
• Cost: 10,000 × $0.05 = $500 (vs $800 without discount)
• Annual savings: $3,600/year 🎉

Example 4: Filtered Search (Any tier)

• Input: 5 ZIP codes, strict filters, only 20 properties match
• Cost: 20 × $0.05-0.08 = $1.00-1.60
• What you get: 20 highly-targeted leads

Default Budget Limits

• Free users: $5.00 per run (~62-100 properties depending on tier)
• Paying users: $500.00 per run (~6,250-10,000 properties depending on tier)
• Custom limits: Set any amount in the input to control spending

🎯 Which Tier is Right for You?

Choose No Discount if:

• Testing the actor for the first time
• Processing <500 properties per month
• One-time research projects

Choose Bronze 🥉 if:

• You're a real estate agent or small team
• Processing 500-2,000 properties monthly
• Save $60-240/year

Choose Silver 🥈 if:

• You're a lead generation company
• Processing 2,000-10,000 properties monthly
• Save $480-2,400/year

Choose Gold 🏆 if:

• You're an enterprise or data company
• Processing 10,000+ properties monthly
• Save $3,600+/year - best value!

💡 Cost Optimization Tips

Good news: Both modes cost exactly the same per property!

• ZIP mode: Free search + $0.08 per property
• ZPID mode: $0.08 per property
• Total cost = Number of properties × $0.08

Optimization strategies:

1. Use Filters Effectively

   • Apply strict filters to get only relevant properties
   • Example: Price range + bedrooms can reduce 200 results to 30
   • Cost savings: $17 → $2.40 (86% reduction!)

2. Start Small, Then Scale

   • Test with $1-2 budget (~12-25 properties)
   • Verify data quality and filters
   • Scale up once satisfied with results

3. Combine with Your Own Data

   • If you have ZPIDs from another source, use ZPID mode
   • If exploring new areas, use ZIP mode with filters
   • Both cost the same per result!

4. Set Realistic Budgets

   • Estimate: (Expected properties) × $0.08
   • Add 20% buffer for accuracy
   • Example: Expect 100 properties → set $10 budget

🚀 Quick Start

1. Subscribe to a Tier (Optional)

Choose your subscription level based on expected monthly volume:

• No subscription: $0.08/property - great for testing
• Bronze: $0.07/property - save 12.5%
• Silver: $0.06/property - save 25%
• Gold: $0.05/property - save 37.5%

💡 Pro tip: Start without a subscription to test, then upgrade when you know your volume!

2. Choose Operation Mode

Mode 1: Search by ZIP Codes

Use this when you want to discover properties in specific areas.

Example Input:

{
  "mode": "zip",
  "zipCodes": ["90210", "10001", "33139"],
  "status": "forSale",
  "price_min": 500000,
  "price_max": 2000000,
  "beds_min": 3,
  "isSingleFamily": true,
  "maxBudgetUsd": 25
}

Mode 2: Process Direct ZPID List

Use this when you already have Zillow Property IDs. This is more cost-effective.

Example Input:

{
  "mode": "zpid",
  "zpids": ["84074592", "2060321152", "123456789"],
  "maxBudgetUsd": 10
}

4. Apply Filters (Optional)

Add filters to narrow down results:

{
  "mode": "zip",
  "zipCodes": ["90210"],
  "status": "forSale",
  "listing_type": "by_agent",
  "beds_min": 3,
  "beds_max": 5,
  "baths_min": 2,
  "price_min": 800000,
  "price_max": 1500000,
  "hasPool": true,
  "isNewConstruction": false,
  "doz": "30"
}

5. Set Budget Control

{
  "mode": "zip",
  "zipCodes": ["90210", "10001"],
  "maxBudgetUsd": 15
}

The actor will automatically stop when the budget is reached.

📊 Output Format

Results are saved to the dataset in JSON format:

{
  "zpid": "84074592",
  "hdpUrl": "https://www.zillow.com/homedetails/...",
  "price": 1250000,
  "status": "FOR_SALE",
  "yearBuilt": 2015,
  "livingArea": 2500,
  "lotSize": 7500,
  "daysOnZillow": 45,
  "agentName": "John Smith",
  "agentEmail": "john.smith@realty.com",
  "cellPhone": "555-123-4567",
  "businessPhone": "555-987-6543",
  "agentLicenseNumber": "CA-DRE-12345",
  "brokerName": "Premier Realty",
  "brokerPhoneNumber": "555-111-2222",
  "propertyDescription": "Beautiful 4-bedroom home...",
  "zestimate": 1275000,
  "rentZestimate": 4500,
  "priceHistory": [...],
  "taxHistory": [...]
}

🎯 Use Cases

• Real Estate Lead Generation: Find properties and contact listing agents
• Market Research: Analyze pricing trends and inventory in specific areas
• Investment Analysis: Track price history and property details
• Competitive Intelligence: Monitor new listings and price changes
• Agent Prospecting: Build lists of active real estate agents

⚙️ Configuration Options

Search Filters

Filter	Description
status	Property status (forSale, forRent, recentlySold)
listing_type	By agent or by owner
doz	Days on Zillow (1, 7, 30, 90 days, etc.)
beds_min/max	Bedroom range
baths_min/max	Bathroom range
price_min/max	Price range
sqft_min/max	Square footage range

Property Type Filters

• isSingleFamily - Single family homes
• isCondo - Condominiums
• isTownhouse - Townhouses
• isMultiFamily - Multi-family properties
• isLotLand - Lots and land

Additional Filters

• hasPool - Properties with pools
• isNewConstruction - New construction only
• isForSaleByOwner - FSBO properties
• isForSaleByAgent - Agent listings
• isComingSoon - Pre-market properties
• isAuction - Auction properties

💡 Tips for Cost Optimization

Both modes cost the same! The key to saving money is using filters effectively.

1. Master the Filters

• Property type filters (Single Family, Condo, etc.) can cut results by 50%+
• Price range is the most powerful filter for targeting
• Days on Zillow helps find fresh or stale listings
• Bedrooms/bathrooms narrows down size preferences

2. Estimate Before Running

Expected cost = (Estimated properties) × $0.08

Example:
- ZIP code typically has 500 properties
- Your filters (price + beds) reduce to 100
- Budget needed: 100 × $0.08 = $8.00

3. Test Your Filters First

1. Run with $2 budget (~25 properties)
2. Check if results match your needs
3. Adjust filters if needed
4. Scale up with confidence

4. Choose the Right Mode

Use ZIP Mode when:

• Exploring new geographic areas
• Don't have property IDs yet
• Want to discover all matches in an area

Use ZPID Mode when:

• You have a list of specific properties
• Getting ZPIDs from MLS, other scrapers, or APIs
• Processing a targeted list

Both cost $0.08 per property - pick based on your workflow!

5. Batch Processing Strategy

For very large datasets:

• Process 500-1,000 properties per run
• Review results between batches
• Adjust filters based on findings
• Prevents wasting budget on unwanted data

🔧 Technical Details

• Rate Limit: 2 requests per second (built into the actor)
• Concurrency: 2 properties processed simultaneously
• Retry Logic: Automatic retries on rate limits (429 errors)
• Error Handling: Continues processing even if some properties fail

⚠️ Common Issues

Properties returning NULL

• Budget limit reached - check your spending
• Property may be deleted or unavailable
• API rate limit - actor will retry automatically

High costs

• Consider upgrading to Bronze/Silver/Gold for volume discounts
• Apply more restrictive filters to reduce results
• Set a budget limit to control spending

💎 Upgrading Your Subscription

As your needs grow, you can upgrade to save money:

When to Upgrade

Upgrade to Bronze when:

• Processing >500 properties/month
• ROI breakeven: Save $5+/month

Upgrade to Silver when:

• Processing >2,000 properties/month
• ROI breakeven: Save $40+/month

Upgrade to Gold when:

• Processing >10,000 properties/month
• ROI breakeven: Save $300+/month

How to Upgrade

1. Go to Apify Store
2. Find this actor
3. Click "Subscribe" and choose your tier
4. Your new rate applies immediately to all runs

💡 You can downgrade anytime if your volume decreases!

📞 Support

For issues or questions:

• Check the Apify documentation
• Contact support through the Apify Console
• Review the actor logs for detailed error messages

📜 License

This actor is available for use under the standard Apify terms of service.