Redfin Scraper (Apify Actor)

Apify actor that scrapes Redfin US real estate in three modes (any combination):

Input field	What it gets	How
forSaleUrls	Full for-sale property detail	HTML → parsed
forRentUrls	Full rental property detail	HTML → parsed

Output samples

// _type=for_sale (full property detail, HTML-parsed)
{
  "_type": "for_sale",
  "_sourceUrl": "https://www.redfin.com/WA/Seattle/...",
  "address": "...",
  "description": "...",
  "price": ..., "estimatedMonthlyPrice": "...",
  "attachments": [...],
  "details": [...],
  "features": {...}
}

// _type=for_rent (rental detail, HTML-parsed)
{
  "_type": "for_rent",
  "_sourceUrl": "https://www.redfin.com/WA/Seattle/Onni-South-Lake-Union/apartment/147020546",
  // ...rental fields
}

Auto-retry on block

When a request returns 0 results, the actor probes the URL once. Probe checks differ by mode:

• Search API: looks for payload substring in the JSON body
• HTML pages: looks for __NEXT_DATA__ / reactServerState markers, captcha keywords, or HTTP ≥ 400

If the probe says the page is blocked, the actor retries up to maxRetries times with retryDelaySeconds between attempts. Genuinely empty results (valid response with 0 homes) are not retried.

Set maxRetries: 0 to disable.

Proxy

Redfin requires a US-resident IP for full data. The default input pre-configures Apify Proxy → Residential, country US.

Run locally with the Apify CLI

npm install -g apify-cli
apify login
cd redfin-actor
apify run --purge

Deploy:

$apify push

Run on Apify without the CLI

1. Zip the contents of this folder (top of zip = .actor/, src/, Dockerfile, requirements.txt, README.md).
2. https://console.apify.com → Actors → Create new → Upload zip → drop the zip.
3. Build (~3 min, mostly Playwright/Chromium pull — even though Redfin doesn't need a browser, the base image includes Chromium).
4. Start, fill in input, run.

Example input

{
  
  "forSaleUrls": [
    "https://www.redfin.com/WA/Seattle/506-E-Howell-St-98122/unit-W303/home/46456"
  ],
  "forRentUrls": [
    "https://www.redfin.com/WA/Seattle/Onni-South-Lake-Union/apartment/147020546"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  },
  "maxRetries": 2,
  "retryDelaySeconds": 5
}