Realtor.com API: Get home details
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.
Unofficial. Not affiliated with or endorsed by Realtor.com.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Address, required
address Street address with city and state or ZIP, or a Realtor.com property link; for example, 2000 Wilson St, Austin, TX 78704.
2000 Wilson St, Austin, TX 78704
Input as JSON
{ "address": "2000 Wilson St, Austin, TX 78704"}Output
{ "beds": 4, "baths": 3.5, "status": "For Sale", "latitude": 30.244902, "home_type": "Single Family", "longitude": -97.75484, "flood_risk": "Minimal (1/10)" , "year_built": 1998, "photo_links": [ "https://ap.rdcpix.com/62ba4421561cebdc49316a5cdf288c81l-m3862110017s.jpg" , "https://ap.rdcpix.com/62ba4421561cebdc49316a5cdf288c81l-m589887402s.jpg" , "https://ap.rdcpix.com/62ba4421561cebdc49316a5cdf288c81l-m1459939456s.jpg" ], "property_id": "7835106696", "square_feet": 2508, "tax_history": [ { "year": 2026, "tax_paid_usd": 24733, "assessed_value_usd": 1208572 }, { "year": 2025, "tax_paid_usd": 22435, "assessed_value_usd": 1132053 }, { "year": 2023, "tax_paid_usd": 16926, "assessed_value_usd": 935581 } ], "full_address": "2000 Wilson St, Austin, TX 78704", "currency_code": "USD", "list_price_usd": 1995000, "nearby_schools": [ { "name": "Fulmore Middle School", "distance_miles": 0.3, "rating_out_of_10": 4 }, { "name": "Travis Heights Elementary School", "distance_miles": 0.6, "rating_out_of_10": 6 }, { "name": "Travis High School", "distance_miles": 1, "rating_out_of_10": 1 } ], "property_history": [ { "date": "2026-09-28", "event": "Listed", "price_usd": 1995000 }, { "date": "2019-04-29", "event": "Sold", "price_usd": null }, { "date": "2019-03-28", "event": "Listed", "price_usd": 820000 } ], "property_page_link": "https://www.realtor.com/realestateandhomes-detail/2000-Wilson-St_Austin_TX_78704_M78351-06696" , "estimated_value_usd": 1408376, "lot_size_square_feet": 6316, "hoa_fee_per_month_usd": 0}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"realtor.com/get_home","input":{"address":"2000 Wilson St, Austin, TX 78704"}}' # 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/get_home" , "input": { "address": "2000 Wilson St, Austin, TX 78704" }})# 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/get_home" , "input": { "address": "2000 Wilson St, Austin, TX 78704" } }), 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/get_home# with {"address":"2000 Wilson St, Austin, TX 78704"}"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": [ "address" ], "properties": { "address": { "type": "string", "description": "Street address with city and state or ZIP, or a Realtor.com property link; for example, 2000 Wilson St, Austin, TX 78704." } }}Output schema
{ "type": "object", "required": [ "full_address", "status", "currency_code", "list_price_usd", "estimated_value_usd", "beds", "baths", "square_feet", "lot_size_square_feet", "year_built", "home_type", "hoa_fee_per_month_usd", "property_history", "tax_history", "nearby_schools", "flood_risk", "photo_links", "property_page_link", "property_id", "latitude", "longitude" ], "properties": { "beds": { "type": [ "number", "null" ] }, "baths": { "type": [ "number", "null" ] }, "status": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "home_type": { "type": [ "string", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "flood_risk": { "type": [ "string", "null" ] }, "year_built": { "type": [ "integer", "null" ] }, "photo_links": { "type": "array", "items": { "type": "string" } }, "property_id": { "type": [ "string", "null" ] }, "square_feet": { "type": [ "number", "null" ] }, "tax_history": { "type": "array", "items": { "type": "object", "required": [ "year", "tax_paid_usd", "assessed_value_usd" ], "properties": { "year": { "type": "integer" }, "tax_paid_usd": { "type": [ "number", "null" ] }, "assessed_value_usd": { "type": [ "number", "null" ] } } } }, "full_address": { "type": "string", "description": "Full street address." }, "currency_code": { "type": "string", "description": "Currency for every price, value, tax and fee in this result." }, "list_price_usd": { "type": [ "number", "null" ] }, "nearby_schools": { "type": "array", "items": { "type": "object", "required": [ "name", "rating_out_of_10", "distance_miles" ], "properties": { "name": { "type": "string" }, "distance_miles": { "type": [ "number", "null" ] }, "rating_out_of_10": { "type": [ "number", "null" ] } } } }, "property_history": { "type": "array", "items": { "type": "object", "required": [ "date", "event", "price_usd" ], "properties": { "date": { "type": "string", "format": "date" }, "event": { "type": "string" }, "price_usd": { "type": [ "number", "null" ] } } } }, "property_page_link": { "type": "string" }, "estimated_value_usd": { "type": [ "number", "null" ] }, "lot_size_square_feet": { "type": [ "number", "null" ] }, "hoa_fee_per_month_usd": { "type": [ "number", "null" ] } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
realtor.com/get_home- Returns
- address, status, list price, estimated value, beds, baths, square feet, lot size, year built, home type, HOA fee, property history, tax history, nearby schools, flood risk, photos, link
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/get_home with the inputs above.
Ask your agent
- What's the list price, beds, baths and square footage for 418 Maple Grove Dr, Charlotte, NC 28205?
- Pull up the realtor.com listing for 77 Harbor View Ln, Portland, ME 04101 and tell me the HOA fee, flood risk, and nearby schools.
- I'm thinking about making an offer on 2931 E Camelback Rd, Phoenix, AZ 85016 — can you get its sale history, tax history, and estimated value?
- Check this property for me: https://www.realtor.com/realestateandhomes-detail/1520-Elm-St_Denver_CO_80218_M12345-67890 — when was it built and is it still active?
- How big is the lot at 6 Birchwood Ct, Naperville, IL 60540, what type of home is it, and can I see the photos? Use Realtor.com.
See more
All Realtor.com methodsSearches 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_homesFinds 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 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 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_homesLooks up Zillow housing market figures for a city and state or five-digit ZIP code: typical home value, one-year change, list and sale prices, inventory and listing activity.
zillow.com/get_housing_marketGets the public details of a Craigslist listing from its link. Deleted or expired listings are not returned, and hidden contact details are not included.
craigslist.org/get_listingSearches 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_rentals