# Realtor.com API: Search homes > 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. Unofficial. Not affiliated with or endorsed by Realtor.com. - Page: https://fous.com/methods/realtor.com/search-homes - Method: `realtor.com/search_homes`, version 1 - Website: realtor.com - Returns: address, price, status, beds, baths, square feet, lot size, listed or sold date, brokerage, photo, link, property ID, 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 | |---|---|---|---|---| | `page` | integer | no | | Starting search page (42 homes per page), for example 2. Default 1. | | `sort` | string | no | | Result order, for example newest. One of "relevant", "newest", "price_low_to_high", "price_high_to_low". Default "relevant". | | `location` | string | yes | `"Austin, TX"` | City and state, neighborhood and city, or ZIP code, for example Austin, TX. | | `min_beds` | integer | no | | Minimum bedrooms, for example 3. | | `home_type` | string | no | | Type of home, for example condo. One of "any", "house", "condo", "townhome", "multi_family", "land", "mobile". Default "any". | | `max_price` | integer | no | | Maximum price in USD, or monthly USD rent for rentals, for example 500000. | | `min_baths` | integer | no | | Minimum bathrooms, for example 2. | | `min_price` | integer | no | | Minimum price in USD, or monthly USD rent for rentals, for example 300000. | | `max_results` | integer | no | `3` | Maximum homes to return, for example 20. Default 20. | | `listing_type` | string | no | | Choose for_sale, for_rent, or recently_sold; for example for_rent. One of "for_sale", "for_rent", "recently_sold". Default "for_sale". | ## Output From a run on Oct 31, 2026. Its input: ```json { "location": "Austin, TX", "max_results": 3 } ``` Its output: ```json { "homes": [ { "beds": 2, "baths": 2.5, "price": 199999, "status": "For sale", "address": "1310 W Parmer Ln Apt 1902, Austin, TX 78727", "latitude": 30.40966, "longitude": -97.68223, "photo_link": "https://ap.rdcpix.com/fb65b28716bd0dfd7293f04c43964440l-m3657393145s.jpg", "property_id": "8578997241", "square_feet": 1334, "listing_link": "https://www.realtor.com/realestateandhomes-detail/1310-W-Parmer-Ln-Apt-1902_Austin_TX_78727_M85789-97241", "price_currency": "USD", "listing_brokerage": "Keller Williams Realty", "listed_or_sold_date": "2026-06-05", "lot_size_square_feet": null }, { "beds": 3, "baths": 2, "price": 395000, "status": "For sale", "address": "1704 Shelbourne Dr, Austin, TX 78752", "latitude": 30.327864, "longitude": -97.683779, "photo_link": "https://ap.rdcpix.com/d35f307687bd662693dfc1958f2a9e63l-m4003346858s.jpg", "property_id": "8102930727", "square_feet": 1556, "listing_link": "https://www.realtor.com/realestateandhomes-detail/1704-Shelbourne-Dr_Austin_TX_78752_M81029-30727", "price_currency": "USD", "listing_brokerage": "eXp Realty, LLC", "listed_or_sold_date": "2026-02-21", "lot_size_square_feet": 9561 }, { "beds": 4, "baths": 3, "price": 520000, "status": "For sale", "address": "7901 Gilwice Ln, Austin, TX 78744", "latitude": 30.146281, "longitude": -97.721567, "photo_link": "https://ap.rdcpix.com/8768f9e9dabb2575b60f3afd0e3f6d69l-m2556554654s.jpg", "property_id": "7449323665", "square_feet": 2290, "listing_link": "https://www.realtor.com/realestateandhomes-detail/7901-Gilwice-Ln_Austin_TX_78744_M74493-23665", "price_currency": "USD", "listing_brokerage": "All City Real Estate", "listed_or_sold_date": "2026-07-03", "lot_size_square_feet": 8350 } ] } ``` ## 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":"realtor.com/search_homes","input":{"location":"Austin, TX","max_results":3}}' ``` 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 $450,000, newest listings first - What condos are for rent in Hoboken, NJ between $2,500 and $3,800 a month with at least 2 bathrooms? - Pull up homes that recently sold in ZIP code 78704 on Realtor.com, I want sold prices, square footage and sold dates - Show me townhomes for sale in Capitol Hill, Seattle, WA sorted cheapest first, up to 40 results - Search realtor.com for land listings for sale near Bozeman, MT priced over $200k, page 2 of results ## Input schema ```json { "type": "object", "required": [ "location" ], "properties": { "page": { "type": "integer", "default": 1, "minimum": 1, "description": "Starting search page (42 homes per page), for example 2." }, "sort": { "enum": [ "relevant", "newest", "price_low_to_high", "price_high_to_low" ], "type": "string", "default": "relevant", "description": "Result order, for example newest." }, "location": { "type": "string", "minLength": 1, "description": "City and state, neighborhood and city, or ZIP code, for example Austin, TX." }, "min_beds": { "type": "integer", "minimum": 0, "description": "Minimum bedrooms, for example 3." }, "home_type": { "enum": [ "any", "house", "condo", "townhome", "multi_family", "land", "mobile" ], "type": "string", "default": "any", "description": "Type of home, for example condo." }, "max_price": { "type": "integer", "minimum": 0, "description": "Maximum price in USD, or monthly USD rent for rentals, for example 500000." }, "min_baths": { "type": "integer", "minimum": 0, "description": "Minimum bathrooms, for example 2." }, "min_price": { "type": "integer", "minimum": 0, "description": "Minimum price in USD, or monthly USD rent for rentals, for example 300000." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum homes to return, for example 20." }, "listing_type": { "enum": [ "for_sale", "for_rent", "recently_sold" ], "type": "string", "default": "for_sale", "description": "Choose for_sale, for_rent, or recently_sold; for example for_rent." } } } ``` ## Output schema ```json { "type": "object", "required": [ "homes" ], "properties": { "homes": { "type": "array", "items": { "type": "object", "required": [ "address", "price", "price_currency", "status", "beds", "baths", "square_feet", "lot_size_square_feet", "listed_or_sold_date", "listing_brokerage", "photo_link", "listing_link", "property_id", "latitude", "longitude" ], "properties": { "beds": { "type": [ "number", "null" ], "description": "Bedrooms." }, "baths": { "type": [ "number", "null" ], "description": "Bathrooms." }, "price": { "type": [ "number", "null" ], "description": "Price in USD; monthly rent for rental listings." }, "status": { "type": "string", "description": "Listing status." }, "address": { "type": [ "string", "null" ], "description": "Full street address." }, "latitude": { "type": [ "number", "null" ], "description": "Property latitude." }, "longitude": { "type": [ "number", "null" ], "description": "Property longitude." }, "photo_link": { "type": [ "string", "null" ], "description": "Primary listing photo URL." }, "property_id": { "type": [ "string", "null" ], "description": "Realtor.com property identifier." }, "square_feet": { "type": [ "number", "null" ], "description": "Home area in square feet." }, "listing_link": { "type": [ "string", "null" ], "description": "Realtor.com home page link." }, "price_currency": { "type": "string", "description": "Price currency." }, "listing_brokerage": { "type": [ "string", "null" ], "description": "Listing brokerage or rental manager." }, "listed_or_sold_date": { "type": [ "string", "null" ], "description": "Listing date, or sold date when available, in YYYY-MM-DD." }, "lot_size_square_feet": { "type": [ "number", "null" ], "description": "Lot size in square feet." } } }, "description": "Homes in requested search order." } } } ``` ## See more - [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. - [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. - [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). - [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. - [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. - [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. - [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. - [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. - [All Realtor.com methods](https://fous.com/methods/realtor.com.md)