Real Estate Aggregator - Zillow + Redfin + Realtor

Search all major real estate platforms at once. Automatically deduplicates listings that appear on multiple sites. Get unified data from Zillow, Redfin, and Realtor.com in a single run.

Features

• Automated data collection
• Structured output format
• Error handling
• Pay-per-event billing

Quick Start

{
  "input": "your input here"
}

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)
platforms	array	No	all	Which platforms to search: zillow, redfin, realtor
city	string	No*	-	City to search (e.g., "San Francisco, CA")
zipCode	string	No*	-	ZIP code to search
address	string	No*	-	Address to search around
searchRadius	integer	No	5	Radius in miles
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, multi_family, land
listingStatus	string	No	for_sale	Status: for_sale, pending, recently_sold, for_rent
maxResultsPerPlatform	integer	No	50	Max listings from each platform
deduplicationStrategy	string	No	keep_all_merged	How to handle duplicates

*At least one location parameter required

Deduplication Strategies

Strategy	Description
keep_all_merged	Merge data from all sources (default)
keep_lowest_price	Keep the listing with the lowest price
keep_highest_price	Keep the listing with the highest price
keep_zillow	Prefer Zillow data when available

---

Output Format

Each aggregated listing includes:

{
  "platform": "aggregated",
  "listingId": "AGG-ZL-12345678",
  "addressNormalized": "123 MAIN ST, SAN FRANCISCO, CA 94102",
  "price": 1350000,
  "zestimate": 1380000,
  "rentZestimate": 5200,
  "beds": 3,
  "baths": 2,
  "sqft": 1850,
  "sources": ["zillow.com", "redfin.com", "realtor.com"],
  "pricesByPlatform": {
    "zillow.com": 1350000,
    "redfin.com": 1349000,
    "realtor.com": 1355000
  },
  "priceVariance": "$6,000 (0.45%)",
  "allUrls": [
    "https://www.zillow.com/homedetails/...",
    "https://www.redfin.com/CA/...",
    "https://www.realtor.com/..."
  ],
  "bestPhotos": ["https://..."],
  "agent": {...},
  "features": [...],
  "priceHistory": [...],
  "taxHistory": [...],
  "scrapedAt": "2025-12-24T12:00:00Z"
}

Key Aggregation Fields

Field	Description
sources	Array of platforms that have this listing
pricesByPlatform	Price on each platform
priceVariance	Difference between highest and lowest price
allUrls	URLs on all platforms
bestPhotos	Deduplicated photos from all sources

---

Pricing

This actor uses pay-per-event billing:

Event	Cost
Per aggregated listing	$0.10
Demo mode	Free

Why More Than Single-Platform Scrapers?

The aggregator runs 3 separate scrapers (Zillow, Redfin, Realtor) and then performs deduplication and enrichment. The $0.10 per unique property includes:

• Running 3 platform scrapers ($0.05 × 3 = $0.15 potential)
• Deduplication (often 40-60% overlap = savings)
• Cross-platform enrichment
• Price variance analysis

Typical savings: 30-50% vs running platforms separately!

---

Use Cases

Investment Property Pipeline

{
  "city": "Atlanta, GA",
  "propertyTypes": ["multi_family"],
  "priceMax": 500000,
  "maxResultsPerPlatform": 100,
  "deduplicationStrategy": "keep_lowest_price"
}

Find multi-family properties across all platforms, keeping the lowest listed price for each.

Luxury Home Search

{
  "city": "Beverly Hills, CA",
  "priceMin": 5000000,
  "bedsMin": 5,
  "platforms": ["zillow", "redfin"]
}

High-end properties with maximum data coverage.

Rental Market Analysis

{
  "zipCode": "78701",
  "listingStatus": "for_rent",
  "maxResultsPerPlatform": 200
}

Comprehensive rental inventory in downtown Austin.

---

---

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