# Homes.com API: Search homes for sale > 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. Unofficial. Not affiliated with or endorsed by Homes.com. - Page: https://fous.com/methods/homes.com/search-homes - Method: `homes.com/search_homes`, version 1 - Website: homes.com - Returns: address, price, beds, baths, square feet, home type, days on market, listing agent, brokerage, photo, listing link, listing id - 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 | |---|---|---|---|---| | `location` | string | yes | `"Nashville, TN"` | City and state, neighborhood, or ZIP code, such as Nashville, TN. | | `min_beds` | integer | no | | Minimum bedrooms, such as 3. Default 0. | | `home_type` | string | no | | Type of home, such as condo; any includes all types. One of "any", "house", "condo", "townhouse", "multi_family", "land". Default "any". | | `max_price` | integer | no | | Maximum listing price in USD; 0 means no maximum, such as 700000. Default 0. | | `min_baths` | integer | no | | Minimum bathrooms, such as 2. Default 0. | | `min_price` | integer | no | | Minimum listing price in USD, such as 300000. Default 0. | | `max_results` | integer | no | `45` | Maximum listings to return, such as 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "location": "Nashville, TN", "max_results": 45 } ``` Its output: ```json { "homes": [ { "beds": 6, "baths": 8, "price": 8995000, "address": "1114 Tyne Blvd, Nashville, TN 37220", "currency": "USD", "brokerage": "Fridrich & Clark Realty", "home_type": "house", "listing_id": "cj8kxr50j746x", "photo_link": "https://images.homes.com/listings/115/8537361584-521842812/1114-tyne-blvd-nashville-tn-primaryphoto.jpg", "square_feet": 9018, "listing_link": "https://www.homes.com/property/1114-tyne-blvd-nashville-tn/wzvj3evd4fzd7/", "listing_agent": "Richard Bryan", "days_on_market": null }, { "beds": 4, "baths": 4, "price": 950000, "address": "2110 Westwood Ave, Nashville, TN 37212", "currency": "USD", "brokerage": "Fridrich & Clark Realty", "home_type": "house", "listing_id": "6bqkf3d8n7dt4", "photo_link": "https://images.homes.com/listings/115/2034383684-895275612/2110-westwood-ave-nashville-tn-primaryphoto.jpg", "square_feet": 2953, "listing_link": "https://www.homes.com/property/2110-westwood-ave-nashville-tn/czd3eynf7v3vp/", "listing_agent": "Richard Bryan", "days_on_market": null }, { "beds": 1, "baths": 1, "price": 529900, "address": "245 Hermitage Ave Unit 401, Nashville, TN 37210", "currency": "USD", "brokerage": "Compass RE", "home_type": "condo", "listing_id": "7f56nbc9bhzbr", "photo_link": "https://images.homes.com/listings/115/3055972105-753679922/245-hermitage-ave-nashville-tn-primaryphoto.jpg", "square_feet": 657, "listing_link": "https://www.homes.com/property/245-hermitage-ave-nashville-tn-unit-401/9zkkwjn6qp4kk/", "listing_agent": "Tammi Weed", "days_on_market": null } ] } ``` ## 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":"homes.com/search_homes","input":{"location":"Nashville, TN","max_results":45}}' ``` 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 3+ bedroom houses for sale in Raleigh, NC under $550,000 on homes.com - What condos are on the market in ZIP 33139 between $400k and $900k? Show me up to 30 with the listing agent and days on market. - Pull townhouses for sale in the Capitol Hill neighborhood of Denver with at least 2 baths, max price 750000 - I'm looking at land parcels for sale around Bend, OR — list what's available with prices and links - Homes.com listings for multi-family properties in Cleveland, OH, minimum 4 beds and 2 baths, priced from $200,000 to $450,000 ## Input schema ```json { "type": "object", "required": [ "location" ], "properties": { "location": { "type": "string", "minLength": 1, "description": "City and state, neighborhood, or ZIP code, such as Nashville, TN." }, "min_beds": { "type": "integer", "default": 0, "minimum": 0, "description": "Minimum bedrooms, such as 3." }, "home_type": { "enum": [ "any", "house", "condo", "townhouse", "multi_family", "land" ], "type": "string", "default": "any", "description": "Type of home, such as condo; any includes all types." }, "max_price": { "type": "integer", "default": 0, "maximum": 2147483647, "minimum": 0, "description": "Maximum listing price in USD; 0 means no maximum, such as 700000." }, "min_baths": { "type": "integer", "default": 0, "minimum": 0, "description": "Minimum bathrooms, such as 2." }, "min_price": { "type": "integer", "default": 0, "maximum": 2147483647, "minimum": 0, "description": "Minimum listing price in USD, such as 300000." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum listings to return, such as 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "homes" ], "properties": { "homes": { "type": "array", "items": { "type": "object", "required": [ "beds", "baths", "price", "address", "currency", "brokerage", "home_type", "listing_id", "photo_link", "square_feet", "listing_link", "listing_agent", "days_on_market" ], "properties": { "beds": { "type": [ "number", "null" ], "description": "Number of bedrooms." }, "baths": { "type": [ "number", "null" ], "description": "Number of bathrooms." }, "price": { "type": [ "number", "null" ], "description": "Listing price in USD." }, "address": { "type": "string", "description": "Full listing address." }, "currency": { "type": "string", "description": "Currency code, USD." }, "brokerage": { "type": [ "string", "null" ], "description": "Listing brokerage name." }, "home_type": { "type": [ "string", "null" ], "description": "Property type shown for this home." }, "listing_id": { "type": "string", "description": "Homes.com listing identifier." }, "photo_link": { "type": [ "string", "null" ], "description": "Primary listing photo link." }, "square_feet": { "type": [ "number", "null" ], "description": "Interior area in square feet." }, "listing_link": { "type": "string", "description": "Homes.com listing page link." }, "listing_agent": { "type": [ "string", "null" ], "description": "Listing agent name." }, "days_on_market": { "type": [ "integer", "null" ], "description": "Days on market when shown." } }, "additionalProperties": false }, "description": "Homes for sale in site order." } }, "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. - [Redfin API: Search homes for sale](https://fous.com/methods/redfin.com/search-homes.md): 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. - [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. - [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. - [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. - [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. - [Realtor.com API: Search agents by location](https://fous.com/methods/realtor.com/search-agents.md): Finds real estate agents working in a city and state or ZIP code on Realtor.com, in Realtor.com's relevance order, with ratings, sales figures, price range, languages and phone number when published.