Redfin API: Search homes for sale
Searches Redfin homes for sale in a city, neighborhood or ZIP code, with price, home type, bed and bath filters and a sort order, returning each listing's price, size, status, photo and links.
Unofficial. Not affiliated with or endorsed by Redfin.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Sort optional
sort Result order, for example newest.
newest
One of
recommended,newest,price_low_to_high,price_high_to_low. Defaultrecommended.- Location, required
location City and state, neighborhood, or ZIP code, for example Seattle, WA.
98103
- Min Beds optional
min_beds Minimum bedrooms, for example 2.
Not set
Whole number 0 or more.
- Home Type optional
home_type Kind of home, for example condo.
condo
One of
any,house,condo,townhouse,multi_family,land. Defaultany.- Max Price optional
max_price Maximum listing price in USD, for example 900000.
Not set
Whole number 0 or more.
- Min Baths optional
min_baths Minimum bathrooms, for example 1.5.
Not set
Number 0 or more.
- Min Price optional
min_price Minimum listing price in USD, for example 500000.
Not set
Whole number 0 or more.
- Max Results optional
max_results Maximum number of homes, for example 20.
8
Whole number from 1 to 100. Default
20.
Input as JSON
{ "sort": "newest", "location": "98103", "home_type": "condo", "max_results": 8}Output
{ "homes": [ { "beds": 2, "baths": 2, "price": 398000, "status": "Active", "address": "9255 Greenwood Ave N #38, Seattle, WA 98103", "currency": "USD", "latitude": 47.6975535, "longitude": -122.3556663, "mls_number": "2586407", "photo_link": "https://ssl.cdn-redfin.com/photo/1/islphoto/407/genIslnoResize.2586407_0.webp" , "year_built": 1979, "square_feet": 927, "listing_link": "https://www.redfin.com/WA/Seattle/9255-Greenwood-Ave-N-98103/unit-38/home/26357" , "days_on_redfin": null, "redfin_property_id": 26357, "price_per_square_foot": 429 }, { "beds": 2, "baths": 2, "price": 619000, "status": "Active", "address": "4511 Greenwood Ave N #4, Seattle, WA 98103", "currency": "USD", "latitude": 47.6618379, "longitude": -122.3557392, "mls_number": "2587300", "photo_link": "https://ssl.cdn-redfin.com/photo/1/islphoto/300/genIslnoResize.2587300_0.webp" , "year_built": 1979, "square_feet": 976, "listing_link": "https://www.redfin.com/WA/Seattle/4511-Greenwood-Ave-N-98103/unit-4/home/49658" , "days_on_redfin": null, "redfin_property_id": 49658, "price_per_square_foot": 634 }, { "beds": 1, "baths": 1, "price": 299500, "status": "Active", "address": "8747 Phinney Ave N #12, Seattle, WA 98103", "currency": "USD", "latitude": 47.6937563, "longitude": -122.354231, "mls_number": "2586373", "photo_link": "https://ssl.cdn-redfin.com/photo/1/islphoto/373/genIslnoResize.2586373_0.webp" , "year_built": 1979, "square_feet": 684, "listing_link": "https://www.redfin.com/WA/Seattle/8747-Phinney-Ave-N-98103/unit-12/home/25622" , "days_on_redfin": null, "redfin_property_id": 25622, "price_per_square_foot": 438 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"redfin.com/search_homes","input":{"sort":"newest","location":"98103","home_type":"condo","max_results":8}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "redfin.com/search_homes" , "input": { "sort": "newest", "location": "98103", "home_type": "condo", "max_results": 8 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "redfin.com/search_homes" , "input": { "sort": "newest", "location": "98103", "home_type": "condo", "max_results": 8 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run redfin.com/search_homes# with {"sort":"newest","location":"98103","home_type":"condo","max_results":8}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "location" ], "properties": { "sort": { "enum": [ "recommended", "newest", "price_low_to_high", "price_high_to_low" ], "type": "string", "default": "recommended", "description": "Result order, for example newest." }, "location": { "type": "string", "minLength": 1, "description": "City and state, neighborhood, or ZIP code, for example Seattle, WA." }, "min_beds": { "type": "integer", "minimum": 0, "description": "Minimum bedrooms, for example 2." }, "home_type": { "enum": [ "any", "house", "condo", "townhouse", "multi_family", "land" ], "type": "string", "default": "any", "description": "Kind of home, for example condo." }, "max_price": { "type": "integer", "minimum": 0, "description": "Maximum listing price in USD, for example 900000." }, "min_baths": { "type": "number", "minimum": 0, "description": "Minimum bathrooms, for example 1.5." }, "min_price": { "type": "integer", "minimum": 0, "description": "Minimum listing price in USD, for example 500000." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of homes, for example 20." } }}Output schema
{ "type": "object", "required": [ "homes" ], "properties": { "homes": { "type": "array", "items": { "type": "object", "required": [ "address", "price", "currency", "beds", "baths", "square_feet", "price_per_square_foot", "days_on_redfin", "status", "year_built", "photo_link", "listing_link", "redfin_property_id", "mls_number", "latitude", "longitude" ], "properties": { "beds": { "type": [ "number", "null" ], "description": "Beds." }, "baths": { "type": [ "number", "null" ], "description": "Baths." }, "price": { "type": [ "number", "null" ], "description": "Price." }, "status": { "type": [ "string", "null" ], "description": "Status." }, "address": { "type": [ "string", "null" ], "description": "Address." }, "currency": { "type": [ "string", "null" ], "description": "Currency." }, "latitude": { "type": [ "number", "null" ], "description": "Latitude.", "x-fous-developer": true }, "longitude": { "type": [ "number", "null" ], "description": "Longitude.", "x-fous-developer": true }, "mls_number": { "type": [ "string", "null" ], "description": "Mls number.", "x-fous-developer": true }, "photo_link": { "type": [ "string", "null" ], "description": "Photo link." }, "year_built": { "type": [ "integer", "null" ], "description": "Year built." }, "square_feet": { "type": [ "number", "null" ], "description": "Square feet." }, "listing_link": { "type": [ "string", "null" ], "description": "Listing link." }, "days_on_redfin": { "type": [ "number", "null" ], "description": "Days on redfin." }, "redfin_property_id": { "type": [ "integer", "null" ], "description": "Redfin property id.", "x-fous-developer": true }, "price_per_square_foot": { "type": [ "number", "null" ], "description": "Price per square foot." } }, "additionalProperties": false } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
redfin.com/search_homes- Returns
- homes (address, price, beds, baths, square feet, price per square foot, status, year built, photo, listing link, MLS number, coordinates)
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method redfin.com/search_homes with the inputs above.
Ask your agent
- Find condos for sale in Austin, TX under $450,000 with at least 2 bedrooms, newest listings first
- Show me the 10 cheapest houses for sale in ZIP 30307 with 3+ beds and 2 baths
- On Redfin, what townhouses are listed in Capitol Hill, Seattle between $600k and $900k?
- Pull up to 50 multi-family properties for sale in Providence, RI sorted by price high to low, with MLS numbers and coordinates
- Search Redfin for 4-bedroom homes in Naperville, IL priced from $700,000 to $1.2 million, at least 2.5 baths
See more
Searches Zillow homes for sale in a city and state, neighborhood or ZIP code, with optional price, bedroom, bathroom and property type filters and sort order, from Zillow's public search pages (up to 100 listings).
zillow.com/search_homesSearches Realtor.com homes for sale, for rent, or recently sold in a city, neighborhood or ZIP code, with optional price, bedroom, bathroom and home type filters and sort order. Rentals with price ranges use the lowest advertised rent; withheld sold prices are blank.
realtor.com/search_homesSearches Homes.com homes for sale in a US city, neighborhood, or ZIP code, with optional price, bedroom, bathroom and home type filters. Returns listings in site order; days on market is null when not shown.
homes.com/search_homesSearches Rightmove homes for sale or to rent around a town, area or postcode, with price, bedroom, property type, radius and under-offer filters, sorted by newest or price.
rightmove.co.uk/search_propertiesSearches Zillow rentals in a city, neighborhood, or ZIP code, with optional rent, bedroom, pet, and home-type filters. Listing details that Zillow does not show are null.
zillow.com/search_rentalsGets a home's details from Realtor.com by street address or Realtor.com property link: status, list price, value estimate, beds, baths, size, year built, HOA fee, property and tax history, nearby schools, flood risk and photos.
realtor.com/get_homeSearches Zoopla homes for sale or to rent in a UK town, area or postcode, with price, bedroom, property type and sort options. Prices are in GBP; rents are monthly.
zoopla.co.uk/search_propertiesSearches Apartments.com rentals by city, neighborhood, or ZIP code, with optional rent, bedroom, pet, and page filters. Rent and availability wording is returned when displayed; missing details are null.
apartments.com/search_apartments