Redfin Real Estate Scraper

Web Scraping

This actor extracts data from websites. It handles JavaScript rendering, pagination, and anti-bot measures automatically.

Note: Always respect the website's terms of service and robots.txt.

---

Web Scraping

This actor extracts data from websites. It handles JavaScript rendering, pagination, and anti-bot measures automatically.

Note: Always respect the website's terms of service and robots.txt.

---

Scrape real estate listings from Redfin by city, ZIP code, address, or school/landmark with radius search. Extract property details, prices, photos, agent info, and price history. Perfect for real estate investors, agents, and market researchers.

Features

• Extracts data from web pages
• Handles pagination automatically
• Exports data to JSON/CSV
• Built-in proxy support
• Pay-per-result billing

Quick Start

{
  "url": "https://example.com",
  "maxResults": 100
}

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)
city	string	No*	-	City to search (e.g., "San Francisco, CA")
zipCode	string	No*	-	ZIP code to search (e.g., "94102")
address	string	No*	-	Address to search around (with radius)
landmark	string	No*	-	Search near a landmark or school
searchRadius	integer	No	5	Radius in miles (for address/landmark)
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, land, multi-family
listedWithin	integer	No	-	Only listings from last N days
maxResults	integer	No	50	Maximum listings to scrape (1-500)

*At least one location parameter required (city, zipCode, address, or landmark)

---

Output Format

Each listing includes:

{
  "platform": "redfin",
  "listingId": "RF-123456",
  "url": "https://www.redfin.com/CA/San-Francisco/123-Main-St-94102/home/123456",
  "address": "123 Main Street",
  "addressNormalized": "123 MAIN ST, SAN FRANCISCO, CA 94102",
  "city": "San Francisco",
  "state": "CA",
  "zipCode": "94102",
  "price": 1250000,
  "priceFormatted": "$1,250,000",
  "beds": 3,
  "baths": 2,
  "sqft": 1850,
  "lotSize": "2,500 sqft",
  "propertyType": "Single Family",
  "yearBuilt": 1925,
  "listingDate": "2025-12-20",
  "daysOnMarket": 4,
  "status": "Active",
  "description": "Stunning Victorian home...",
  "photos": [
    "https://ssl.cdn-redfin.com/photo/1/islphoto/123/genIslnoResize.123_0.jpg"
  ],
  "agent": {
    "name": "Sarah Johnson",
    "phone": "(415) 555-1234",
    "company": "Redfin"
  },
  "features": ["Hardwood Floors", "Fireplace", "Garage", "Updated Kitchen"],
  "coordinates": {
    "lat": 37.7749,
    "lng": -122.4194
  },
  "priceHistory": [
    { "date": "2025-12-20", "price": 1250000, "event": "Listed" },
    { "date": "2020-05-15", "price": 950000, "event": "Sold" }
  ],
  "scrapedAt": "2025-12-24T12:00:00Z"
}

Address Normalization

The addressNormalized field uses USPS-standard formatting for deduplication:

• Uppercase
• Standard abbreviations (Street → ST, Avenue → AVE, Boulevard → BLVD)
• No punctuation
• Format: STREET, CITY, STATE ZIP

Use this field to deduplicate listings across Redfin, Zillow, and Realtor.com.

---

Pricing

This actor uses pay-per-event billing:

Event	Cost
Per listing scraped	$0.05
Demo mode	Free

Cost Examples

Use Case	Listings	Cost
Daily new listings (1 city)	~20	$1.00
Weekly market analysis	~200	$10.00
Full city inventory	~500	$25.00

Compare to PropStream at $99/mo or CoStar at $500+/mo.

---

Use Cases

• Data collection
• Research
• Automation

---

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