Realtor.com API
The Realtor.com API returns US real-estate data — for-sale, sold and rental listings — as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns properties with property id, URL, list price, status, type, beds, baths, square footage, lot size, year built and the RealEstimate value, and you can pull a detail, estimates, sold history, market_trends and comps. It is built for real-estate investors, brokerage tools and property dashboards that need live Realtor.com data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/realtor/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"location": "Austin, TX"
}
}{
"ok": true,
"meta": {
"api": "realtor",
"endpoint": "search",
"mode": "live",
"latency_ms": 1419.4,
"record_count": 42,
"bytes": 109146,
"cache_hit": false,
"stop_reason": "limit_reached",
"method": "frontdoor_graphql",
"total": 7430,
"count": 42,
"filters_applied": {},
"status": "for_sale",
"offset": 0,
"limit": 42
},
"data": {
"results": [
{
"property_id": "[redacted-phone]",
"listing_id": "[redacted-phone]",
"status": "for_sale",
"list_price_usd": 329995,
"list_date": "[redacted-phone]T17:05:[redacted-phone]Z",
"last_sold_price_usd": null,
"last_sold_date": null,
"price_reduced_amount_usd": null,
"realestimate_usd": 367000,
"beds": 4,
"baths": 2,
"baths_full": 2,
"baths_half": null,
"sqft": 1602,
"lot_sqft": 4591,
"year_built": 2019,
"property_type": "single_family",
"sub_type": null,
"garage": 2,
"stories": 1,
"primary_photo_url": "http://ap.rdcpix.com/10e08f5e4766f2e2c3df79c25d2c254fl-m[redacted-phone]s.jpg",
"photo_count": 25,
"flags": {
"is_new_listing": true,
"is_price_reduced": null,
"is_pending": null,
"is_foreclosure": null,
"is_contingent": null
},
"branding": [
"Desai Real Estate, LLC"
],
"url": "https://www.realtor.com/realestateandhomes-detail/1314-Ambler-Dr_Austin_TX_78753_M[redacted-phone]",
"address_line": "1314 Ambler Dr",
"city": "Austin",
"state_code": "TX",
"postal_code": "78753",
"county": "Travis",
"latitude": 30.406333,
"longitude": -97.644653
},
{
"property_id": "[redacted-phone]",
"listing_id": "[redacted-phone]",
"status": "for_sale",
"list_price_usd": 699000,
"list_date": "[redacted-phone]T16:47:[redacted-phone]Z",
"last_sold_price_usd": null,
"last_sold_date": null,
"price_reduced_amount_usd": null,
"realestimate_usd": null,
"beds": 3,
"baths": 4,
"baths_full": 3,
"baths_half": 1,
"sqft": 1726,
"lot_sqft": null,
"year_built": 2026,
"property_type": "condos",
"sub_type": "condo",
"garage": 2,
"stories": 3,
"primary_photo_url": "http://ap.rdcpix.com/261cb265132f4ea6a3c267bfed41dbd7l-m[redacted-phone]s.jpg",
"photo_count": 22,
"flags": {
"is_new_listing": true,
"is_price_reduced": null,
"is_pending": null,
"is_foreclosure": null,
"is_contingent": null
},
"branding": [
"Douglas Elliman Real Estate"
],
"url": "https://www.realtor.com/realestateandhomes-detail/1500-Arid-Way-1014_Austin_TX_78758_M[redacted-phone]",
"address_line": "1500 Arid Way Unit 1014",
"city": "Austin",
"state_code": "TX",
"postal_code": "78758",
"county": "Travis",
"latitude": 30.383896,
"longitude": -97.70192
},
{
"property_id": "[redacted-phone]",
"listing_id": "[redacted-phone]",
"status": "for_sale",
"list_price_usd": 1325000,
"list_date": "[redacted-phone]T15:26:[redacted-phone]Z",
"last_sold_price_usd": null,
"last_sold_date": "[redacted-phone]",
"price_reduced_amount_usd": null,
"realestimate_usd": 1291000,
"beds": 5,
"baths": 5,
"baths_full": 3,
"baths_half": 2,
"sqft": 4479,
"lot_sqft": 28837,
"year_built": 2000,
"property_type": "single_family",
"sub_type": null,
"garage": 3,
"stories": 2,
"primary_photo_url": "http://ap.rdcpix.com/af78d1e37dc6866b9c18be18c3da51efl-m[redacted-phone]s.jpg",
"photo_count": 21,
"flags": {
"is_new_listing": true,
"is_price_reduced": null,
"is_pending": null,
"is_foreclosure": null,
"is_contingent": null
},
"branding": [
"Keller Williams Realty Lone Star"
],
"url": "https://www.realtor.com/realestateandhomes-detail/9902-Brightling-Ln_Austin_TX_78750_M[redacted-phone]",
"address_line": "9902 Brightling Ln",
"city": "Austin",
"state_code": "TX",
"postal_code": "78750",
"county": "Travis",
"latitude": 30.424565,
"longitude": -97.810891
}
],
"total": 7430,
"count": 42,
"filters_applied": {}
}
}What the Realtor.com API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Realtor.com listings by location (for sale / for rent / recently sold), with structured filters: price, beds, baths, property type, sqft, lot size, year built, HOA, days-on-market and keywords. Paginate with offset. | Real-estate investors call search to search Realtor.com listings by location (for sale / for rent / recently sold), with structure…. | location, status, sort, limit, offset, ... |
| detail | Full property record by property_id: RealEstimate value (+ range), price history, tax history, schools (with ratings), photos, interior/exterior feature groups, HOA, status flags, monthly-payment estimate and the listing agent/broker. | Brokerage tools call detail to get full property record by property_id. | property_id |
| estimates | Multi-source home-value estimates (AVMs) for a property — Realtor.com surfaces several independent valuation models (Collateral Analytics, Quantarium, Cotality/CoreLogic), each with its own value and high/low range. Returns the full set plus the best estimate. The valuation surface for pricing a home. | Property dashboards call estimates to get multi-source home-value estimates (AVMs) for a property. | property_id |
| sold | Recently-sold homes by location (or map bounds), with the same structured filters as search — the comparable-sales surface for valuing a home. | Lead-generation teams call sold to get recently-sold homes by location (or map bounds), with the same structured filters as search. | location, sort, limit, offset, map_bounds, ... |
| market_trends | Local housing-market intelligence for a US city or ZIP — median listing price, median sold price, median price per square foot, median days-on-market and median rent. The market-overview surface for a neighborhood or metro. | Real-estate investors call market_trends to get local housing-market intelligence for a US city or ZIP. | location |
| comps | Comparable homes near a property — synthesized from recently-sold and active listings around the subject's coordinates, scored by distance, beds and sqft. | Brokerage tools call comps to get comparable homes near a property. | property_id, radius_miles, max_comps, include_active |
| autocomplete | Location autocomplete — suggest Realtor.com cities, ZIPs, neighborhoods, counties and schools for a free-text query. Resolve a fuzzy term before searching, or power a search box. | Property dashboards call autocomplete to get location autocomplete. | query |
Call search from your stack
curl -X POST https://api.reefapi.com/realtor/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"location":"Austin, TX"}'import requests
r = requests.post(
"https://api.reefapi.com/realtor/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"location": "Austin, TX"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/realtor/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"location": "Austin, TX"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.realtor.search with {"location":"Austin, TX"}.Who uses this API and why
- Real-estate investors call search then comps to find and value properties in a target market.
- Market dashboards use market_trends and estimates to track prices and inventory in an area.
- Lead-gen tools use detail and sold to enrich listings and identify recent transactions.
Questions developers ask before integrating
What is the Realtor.com API?
Realtor.com API is a ReefAPI endpoint group for realtor.com It returns live JSON through POST requests under /realtor/v1.
Is the Realtor.com API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Realtor.com calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Realtor.com login or account?
No login to Realtor.com is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Realtor.com data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Realtor.com API use?
Realtor.com actions currently cost 1-3 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Realtor.com from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call realtor actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Realtor.com API a Realtor.com scraper?
It is the managed alternative to a DIY Realtor.com scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same realtor.com back as clean JSON.
Why does my Realtor.com scraper keep getting blocked?
Most Realtor.com scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.