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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Page optional
page Starting search page (42 homes per page), for example 2.
1 (default)
Whole number 1 or more.
- Sort optional
sort Result order, for example newest.
relevant (default)
One of
relevant,newest,price_low_to_high,price_high_to_low.- Location, required
location City and state, neighborhood and city, or ZIP code, for example Austin, TX.
Austin, TX
- Min Beds optional
min_beds Minimum bedrooms, for example 3.
Not set
Whole number 0 or more.
- Home Type optional
home_type Type of home, for example condo.
any (default)
One of
any,house,condo,townhome,multi_family,land,mobile.- Max Price optional
max_price Maximum price in USD, or monthly USD rent for rentals, for example 500000.
Not set
Whole number 0 or more.
- Min Baths optional
min_baths Minimum bathrooms, for example 2.
Not set
Whole number 0 or more.
- Min Price optional
min_price Minimum price in USD, or monthly USD rent for rentals, for example 300000.
Not set
Whole number 0 or more.
- Max Results optional
max_results Maximum homes to return, for example 20.
3
Whole number from 1 to 100. Default
20.- Listing Type optional
listing_type Choose for_sale, for_rent, or recently_sold; for example for_rent.
for_sale (default)
One of
for_sale,for_rent,recently_sold.
Input as JSON
{ "location": "Austin, TX", "max_results": 3}Output
{ "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 } ]}Code
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}}' # 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": "realtor.com/search_homes" , "input": { "location": "Austin, TX", "max_results": 3 }})# 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": "realtor.com/search_homes" , "input": { "location": "Austin, TX", "max_results": 3 } }), 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 realtor.com/search_homes# with {"location":"Austin, TX","max_results":3}"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": { "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
{ "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." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
realtor.com/search_homes- Returns
- address, price, status, beds, baths, square feet, lot size, listed or sold date, brokerage, photo, link, property ID, 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 realtor.com/search_homes with the inputs above.
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
See more
All Realtor.com methodsGets 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_homeFinds 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.
realtor.com/search_agentsSearches 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 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 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.
redfin.com/search_homesSearches 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_rentalsSearches 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 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_properties