Realtor.com API

Get Realtor.com data with one API

The Realtor.com API returns US real-estate data — for-sale, sold and rental listings — as clean JSON.

R
/realtor/v1

7 active endpoints, on 1, 2 and 3 credit tiers.

  • POST/realtor/v1/search
  • POST/realtor/v1/detail
  • POST/realtor/v1/estimates
  • POST/realtor/v1/sold
  • POST/realtor/v1/market_trends
  • POST/realtor/v1/comps
  • POST/realtor/v1/autocomplete

What Realtor.com endpoints does ReefAPI ship?

7 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

7 endpoints

search

2 cr

Search Realtor.com listings by location (for sale / for rent / recently sold), with structure…

required
location
optional
status, sort, limit, offset, map_bounds, price_min, price_max, beds_min, beds_max, baths_min, home_type, sqft_min, sqft_max, lot_min, lot_max, year_built_min, year_built_max, max_hoa, days_on_max, keywords

detail

3 cr

Full property record by property_id.

required
property_id
optional

estimates

2 cr

Multi-source home-value estimates (AVMs) for a property.

required
property_id
optional

sold

2 cr

Recently-sold homes by location (or map bounds), with the same structured filters as search.

required
location
optional
sort, limit, offset, map_bounds, price_min, price_max, beds_min, beds_max, baths_min, home_type, sqft_min, sqft_max, lot_min, lot_max, year_built_min, year_built_max, max_hoa, days_on_max, keywords

market_trends

1 cr

Local housing-market intelligence for a US city or ZIP.

required
location
optional

comps

2 cr

Comparable homes near a property.

required
property_id
optional
radius_miles, max_comps, include_active

autocomplete

1 cr

Location autocomplete.

required
query
optional

Every parameter, every allowed value →

Realtor.com API

3 of 7 endpoints, ready to run

View docs ↗

Search Realtor.com listings by location (for sale / for rent / recently sold), with structure…

2 credits1 required · 0 optional
POST/realtor/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the Realtor.com API works

Realtor.com is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 185 engines.

02
Call
POST /realtor/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Realtor.com ids, prices and what a non-disclosure state hides

Two things bite people here: the property_id does not look like the code in the URL, and sold prices are missing across a large part of the country by law rather than by any failure to read the page. Measured 2026-08-27 across Austin TX, Miami FL, Sacramento CA, Seattle WA and Denver CO.

FieldWhat it holdsMeasured 2026-08-27
property_id to URL M-codeSplit the 10-digit id after five digits and prefix M8112218355 becomes ..._M81122-18355; the rule held on 25 of 25 Austin rows
listing_idA separate id for the listing, not the property. Do not pass it as property_idproperty_id 8112218355 carried listing_id 3000103553
last_sold_price_usdnull in non-disclosure states, where sale prices are not public record0 of 25 Austin TX sold rows had it; 10 of 10 did in Miami, Sacramento, Seattle and Denver
list_price_usd on for_rentMonthly rent in USD, while realestimate_usd on the same row is still the sale valueAn Austin rental read list_price_usd 3200 next to realestimate_usd 648000
realestimate_usdRealtor.com's own automated valuation, returned on search cards as well as on detailA card listed at 1,879,000 carried realestimate_usd 1,792,400
lot_sqftSquare feet, never acres (43,560 sqft is one acre)lot_sqft 47393 is 1.09 acres
estimates source_typecorelogic (Cotality), quantarium, collateral (Collateral Analytics); one is flagged is_bestThree AVMs for 7211899596: 192,500 / 188,427 / 196,000
property_typesingle_family, condos, townhomes, multi_family, mobile, land, farm, the same words you filter withOne 25-row sold page returned land, condos, mobile, townhomes and single_family
autocomplete id prefixescity:, ps: for a ZIP, county:, school:city:tx_austin, ps:tx_78704, county:tx_travis, school:0758585001
market_trends geo_typeCity for a place name, PostalCode for five digits"Austin, TX" returned geo_type City; "78704" returned PostalCode
detail price_history Sold eventprice_usd 0 where the sale price is not publicThe 2026-07-17 Sold event read price_usd 0 with list_price_usd 185,000

search and sold cap at limit 200 per call and page with offset; meta.total tells you how deep the result set goes, which was 7,100 active and 126,854 sold for Austin on 2026-08-27. An unknown property_id is a clean failure rather than an empty success: detail on 1234567890 returned ok:false with NOT_FOUND.

What people build with Realtor.com

The jobs this data is most often used for.

7

endpoints

1/2/3

credits per call

01

Real-estate investors call search then comps to find and value properties in a target market.

02

Market dashboards use market_trends and estimates to track prices and inventory in an area.

03

Lead-gen tools use detail and sold to enrich listings and identify recent transactions.

What Realtor.com data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 185 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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"}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Realtor.com.

Get a free key →
How do I turn a property_id into a Realtor.com URL?

The id is a 10-digit number and the URL carries it split in half with an M in front. property_id 8112218355 appears in the listing URL as _M81122-18355, 7054144423 as _M70541-44423, and 7871052065 as _M78710-52065. The rule held on all 25 rows of one Austin sold page checked on 2026-08-27. You do not have to build it yourself, because every search and sold row already includes the full url.

Why is last_sold_price_usd null?

Because the property is in a non-disclosure state, where sale prices are not public record. Measured on 2026-08-27: all 25 Austin, Texas sold rows returned null, while Miami FL, Sacramento CA, Seattle WA and Denver CO each returned a price on 10 of 10 rows. The same gap shows up in detail, where the price_history Sold event carries price_usd 0, and in market_trends, where median_sold_price_usd is simply absent for Texas but present for California and Florida. Nothing is being withheld by the API; the number does not exist upstream.

Is list_price_usd the rent or the sale price?

It depends on status. For for_sale and sold it is the asking price. For for_rent it is the monthly rent: one Austin rental returned list_price_usd 3200 alongside realestimate_usd 648000, which is the home's value, not an annual rent. Read status before you compare prices across rows, and never mix realestimate_usd into a rent series.

How does a Realtor.com record differ from a Zillow one?

The identifier and the estimate change name, and the enums change case. Realtor.com identifies a property by a 10-digit property_id, Zillow by a zpid. The valuation here is realestimate_usd from Realtor.com's RealEstimate, not a Zestimate, and the estimates action breaks it into three independent models. Realtor.com's status and property_type values are lowercase and match the words you filter with (single_family, condos, for_sale), whereas Zillow's response enums are uppercase and differ from its filter words. No MLS number is returned on either the card or the detail record.

Which value should I trust, realestimate_usd or the estimates action?

estimates gives you the three models separately, each with its own value, high, low and date, with one flagged is_best. For property 7211899596 on 2026-08-27 that was Cotality 192,500 (range 179,400 to 205,600), Quantarium 188,427 and Collateral Analytics 196,000. detail's realestimate_usd equals the best estimate, but its realestimate_range_usd of 188,427 to 196,000 is the spread between the three models' point values, not the best model's own confidence range. If you want a genuine uncertainty band, read estimate_low_usd and estimate_high_usd from estimates.

Why does autocomplete put an address in the name field?

For type school it does, and the school's actual name is in slug_id. Searching "Lincoln High" returned name "1750 Southwest Salmon Street" with slug_id "Lincoln-High-School-0758585001". A county row is odd in the other direction: name is just the state code ("TX") while slug_id holds "Travis-County_TX". Cities behave normally, with name "Austin, TX". geo_id is a UUID for cities and counties and null for schools.

What does comps actually compare against?

Recently sold homes inside a radius around the subject's coordinates, scored on distance, beds and sqft. Defaults are 2 miles and 12 comps, adjustable to 0.25-25 miles and up to 50 comps. Set include_active to true to mix in current listings. In a non-disclosure state each comp still comes back with last_sold_price_usd null, so a Texas comp set gives you addresses, beds, baths, sqft, distance_miles and the last list price, but no sold prices to average.

Is lot size in acres or square feet?

Square feet, in both directions. lot_sqft in the response and lot_min and lot_max in the filters are all square feet, so 43,560 is one acre and a measured lot_sqft of 47,393 is 1.09 acres. sqft is living area, a separate number: one row had sqft 4,039 inside that 47,393 sqft lot. Filtering with lot_max=43560 means one acre or less, not 43,560 acres.

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.

11 Real Estate APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Realtor.com, you are one call away from the rest of the category — no second contract, no second integration.

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 184 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts.