Redfin CSV and Excel Property Export Parser

This Actor normalizes a Redfin property export that you already have as CSV or XLSX. It reads the supplied file or pasted CSV, maps common property columns into a consistent dataset, applies optional filters, and preserves the original columns for review.

It does not visit Redfin, query Redfin endpoints, or collect current listings. Redfin's terms prohibit automated scraping without prior written permission. Use only files you are authorized to process. Redfin's download options depend on local MLS rules and its support guidance currently describes a 350-home export limit. See Redfin's Terms of Use and Redfin's download instructions.

Input

Supply exactly one of:

• CSV or XLSX export file: upload one file or provide a direct HTTPS file URL. Maximum 10 MB. The Actor follows at most five redirects, rejects Redfin hosts and private-network destinations, and accepts UTF-8 CSV or XLSX.
• Pasted CSV text: up to 250,000 characters. CSV, TSV, semicolon, and pipe delimiters are detected.

If both are supplied, the file takes priority. An empty or missing source is rejected with a message in the run log and OUTPUT summary. The file is never treated as a Redfin page to scrape.

The parser reads the first non-empty row as headers and the first visible non-empty worksheet in an XLSX workbook. It accepts up to 10,000 data rows and 500 columns. Filters are case-insensitive; a requested filter whose source column is missing is rejected instead of silently returning misleading results.

Useful recognized column names include address, city, state/province, ZIP/postal code, price, listing ID, listing URL, property type, status, beds/bedrooms, baths/bathrooms, living area, lot size, price per square foot, and days on market. Unrecognized columns remain in sourceColumns by default. Prices are labeled as USD by default; choose CAD or Unknown when appropriate. Currency is not converted.

The recordId is a SHA-256 fingerprint based on the available listing ID or URL, otherwise on the property facts. Deduplication is enabled by default. Every row is marked as user_supplied_export; this Actor does not verify the source, listing status, freshness, ownership, or data rights.

Output

• Default dataset: one normalized property row per retained source row.
• Key-value store OUTPUT: status (DATA, EMPTY, REJECTED, FAILED, or LIMIT_REACHED), counts, filters, warnings, and event-charge count.

An export with no retained rows is a truthful empty result and does not incur the export-processing event. A free-plan run returns at most five property rows. Paid-plan runs can return up to maxResults (default 100, maximum 1,000).

Pricing

Pay-per-event pricing charges one automatic Actor-start event per run and one redfin-export-processed event after a non-empty export has been written. Empty and rejected exports do not incur the processing event. Platform usage, if any, is separate from event prices.

Tier	Start event	Export processed	Total for a non-empty export
Free	$0.005	$0.01000	$0.01500
Bronze	$0.005	$0.00975	$0.01475
Silver	$0.005	$0.00950	$0.01450
Gold	$0.005	$0.00800	$0.01300
Platinum	$0.005	$0.00800	$0.01300
Diamond	$0.005	$0.00800	$0.01300

Set a run's maxTotalChargeUsd high enough for the start fee and, when expecting rows, the applicable export event. At Free tier, that is at least $0.015 for a non-empty export. The automatic start event is never charged manually. An OUTPUT summary records the processing-event count.

Example input

The sample rows below are fictional. Replace them with your own authorized export:

{
  "csvContent": "ADDRESS,CITY,STATE,PRICE,PROPERTY TYPE,BEDS,BATHS,SQFT,STATUS\n1 Example Way,Sample City,CA,450000,Single-family,3,2,1450,For sale\n2 Demo Lane,Sample City,CA,625000,Condo,2,2,1100,For sale\n3 Fictional Road,Sample City,CA,390000,Single-family,2,1,980,Sold",
  "minPrice": 250000,
  "maxResults": 100,
  "deduplicate": true,
  "currencyCode": "USD"
}

To retain only condos, add "propertyTypes": ["Condo"]. To retain three-bedroom properties or larger, add "minBedrooms": 3.

Privacy and access

The Actor does not request a Redfin proxy, log the file URL or pasted property rows, or send supplied records to a third-party extraction service. HTTPS file URLs are resolved and pinned to public IP addresses, redirects are revalidated, and local or private network destinations are rejected. Apify stores run inputs and outputs according to the platform's storage retention settings.

This Actor is private by default. It includes no Redfin logo, icon, or third-party branding.