redfin

A Python wrapper around the unofficial Redfin API.

Installation

pip install redfin

Usage

from redfin import Redfin

client = Redfin()

response = client.search('1600 Amphitheatre Pkwy, Mountain View, CA')
url = response['payload']['exactMatch']['url']

initial_info = client.initial_info(url)
property_id = initial_info['payload']['propertyId']

# Get estimated value
avm = client.avm_details(property_id, "")
predicted_value = avm['payload']['predictedValue']
print(f"Estimated value: {predicted_value}")

# Get neighborhood walk/bike/transit scores
stats = client.neighborhood_stats(property_id)
walk_score = stats['payload']['walkScoreInfo']['walkScoreData']['walkScore']['value']
print(f"Walk score: {walk_score}")

Configuration

Custom User-Agent

client = Redfin(user_agent="MyApp/1.0 (contact@example.com)")

Rate Limiting

Add a delay between requests to avoid hitting Redfin's rate limits:

client = Redfin(request_delay=1.0)  # 1 second between requests

The client also automatically handles 429 responses by sleeping the Retry-After header duration and retrying once.

CLI

redfin estimate <property_id>        # print estimate, beds/baths, last sold price
redfin neighborhood <property_id>    # print walk/bike/transit scores

Options:

redfin --user-agent "MyApp/1.0" estimate 12345   # custom User-Agent
redfin --delay 1.5 neighborhood 12345             # delay between requests
redfin estimate --json 12345                      # raw JSON output

All Methods

URL-based

initial_info(url)
page_tags(url)
primary_region(url)
search(query)

Property ID-based

avm_details(property_id, listing_id)
neighborhood_stats(property_id)
below_the_fold(property_id)
hood_photos(property_id)
more_resources(property_id)
page_header(property_id)
property_comments(property_id)
building_details_page(property_id)
owner_estimate(property_id)
claimed_home_seller_data(property_id)
cost_of_home_ownership(property_id)
above_the_fold(property_id, listing_id)
info_panel(property_id, listing_id)
similar_listings(property_id, listing_id)
similar_sold(property_id, listing_id)
nearby_homes(property_id, listing_id)
avm_historical(property_id, listing_id)
descriptive_paragraph(property_id, listing_id)
tour_insights(property_id, listing_id)
stats(property_id, listing_id, region_id)

Listing ID-based

floor_plans(listing_id)
tour_list_date_picker(listing_id)

Table ID-based

shared_region(table_id)

License

MIT — see LICENSE.txt

Redfin

Install / Use

README