# 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. - Page: https://fous.com/methods/redfin.com/search-homes - Method: `redfin.com/search_homes`, version 1 - Website: redfin.com - Returns: homes (address, price, beds, baths, square feet, price per square foot, status, year built, photo, listing link, MLS number, coordinates) - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | `"newest"` | Result order, for example newest. One of "recommended", "newest", "price_low_to_high", "price_high_to_low". Default "recommended". | | `location` | string | yes | `"98103"` | City and state, neighborhood, or ZIP code, for example Seattle, WA. | | `min_beds` | integer | no | | Minimum bedrooms, for example 2. | | `home_type` | string | no | `"condo"` | Kind of home, for example condo. One of "any", "house", "condo", "townhouse", "multi_family", "land". Default "any". | | `max_price` | integer | no | | Maximum listing price in USD, for example 900000. | | `min_baths` | number | no | | Minimum bathrooms, for example 1.5. | | `min_price` | integer | no | | Minimum listing price in USD, for example 500000. | | `max_results` | integer | no | `8` | Maximum number of homes, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "sort": "newest", "location": "98103", "home_type": "condo", "max_results": 8 } ``` Its output: ```json { "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 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash 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}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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 ## Input schema ```json { "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 ```json { "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 } ``` ## See more - [Zillow API: Search homes for sale](https://fous.com/methods/zillow.com/search-homes.md): 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). - [Realtor.com API: Search homes](https://fous.com/methods/realtor.com/search-homes.md): Searches 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. - [Homes.com API: Search homes for sale](https://fous.com/methods/homes.com/search-homes.md): Searches 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. - [Rightmove API: Search properties](https://fous.com/methods/rightmove.co.uk/search-properties.md): Searches 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. - [Zillow API: Search rentals](https://fous.com/methods/zillow.com/search-rentals.md): Searches 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. - [Realtor.com API: Get home details](https://fous.com/methods/realtor.com/get-home.md): Gets 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. - [Zoopla API: Search properties](https://fous.com/methods/zoopla.co.uk/search-properties.md): Searches 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. - [Apartments.com API: Search apartments](https://fous.com/methods/apartments.com/search-apartments.md): Searches 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.