docs / realtor

Realtor.com API scraper

base /realtor/v15 endpoints

post/realtor/v1/search2 credits

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.

Parameter		Allowed / range	Description
location	required	—	Where to search — a US city, ZIP, neighborhood, county or state ('Austin, TX', '78704', 'Brooklyn, NY', 'TX').
status = for_sale	optional	for_sale · for_rent · sold	Listing status (synonyms rent/sale/recently_sold also accepted).
sort = newest	optional	newest · price_low · price_high · sold_date	Result ordering.
limit = 42	optional	1–200	Listings to return per call (1-200).
offset = 0	optional	0–	Pagination offset — skip this many results (page through with offset += limit).
map_bounds	optional	—	Search an exact map viewport {west, east, south, north} in decimal degrees (alternative/addition to location).
price_min	optional	0–	Minimum price in USD (sale price, or monthly rent for status=for_rent).
price_max	optional	0–	Maximum price in USD.
beds_min	optional	0–10	Minimum bedrooms (3 = 3+).
beds_max	optional	0–10	Maximum bedrooms.
baths_min	optional	0–10	Minimum bathrooms (2 = 2+).
home_type	optional	—	Property type — one or several comma-separated. One of: single_family, condos, townhomes, multi_family, mobile, land, farm (e.g. 'single_family,condos').
sqft_min	optional	0–	Minimum living area in square feet.
sqft_max	optional	0–	Maximum living area in square feet.
lot_min	optional	0–	Minimum lot size in SQUARE FEET (43560 sqft = 1 acre).
lot_max	optional	0–	Maximum lot size in square feet.
year_built_min	optional	1800–2030	Earliest year built.
year_built_max	optional	1800–2030	Latest year built.
max_hoa	optional	0–	Maximum monthly HOA fee in USD.
days_on_max	optional	1–	Only listings on Realtor.com at most this many days (7 = new this week).
keywords	optional	—	Free-text listing keyword filter, comma-separated ('pool', 'waterfront', 'guest house').

Try in playground →

post/realtor/v1/detail3 credits

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.

Parameter		Allowed / range	Description
property_id	required	—	Realtor.com property id (from a search result's property_id, or the M-code in a listing URL).

Try in playground →

post/realtor/v1/sold2 credits

Recently-sold homes by location (or map bounds), with the same structured filters as search — the comparable-sales surface for valuing a home.

Parameter		Allowed / range	Description
location	required	—	Where to search — a US city, ZIP, neighborhood, county or state ('Austin, TX', '78704', 'Brooklyn, NY', 'TX').
sort = newest	optional	newest · price_low · price_high · sold_date	Result ordering.
limit = 42	optional	1–200	Listings to return per call (1-200).
offset = 0	optional	0–	Pagination offset — skip this many results (page through with offset += limit).
map_bounds	optional	—	Search an exact map viewport {west, east, south, north} in decimal degrees (alternative/addition to location).
price_min	optional	0–	Minimum price in USD (sale price, or monthly rent for status=for_rent).
price_max	optional	0–	Maximum price in USD.
beds_min	optional	0–10	Minimum bedrooms (3 = 3+).
beds_max	optional	0–10	Maximum bedrooms.
baths_min	optional	0–10	Minimum bathrooms (2 = 2+).
home_type	optional	—	Property type — one or several comma-separated. One of: single_family, condos, townhomes, multi_family, mobile, land, farm (e.g. 'single_family,condos').
sqft_min	optional	0–	Minimum living area in square feet.
sqft_max	optional	0–	Maximum living area in square feet.
lot_min	optional	0–	Minimum lot size in SQUARE FEET (43560 sqft = 1 acre).
lot_max	optional	0–	Maximum lot size in square feet.
year_built_min	optional	1800–2030	Earliest year built.
year_built_max	optional	1800–2030	Latest year built.
max_hoa	optional	0–	Maximum monthly HOA fee in USD.
days_on_max	optional	1–	Only listings on Realtor.com at most this many days (7 = new this week).
keywords	optional	—	Free-text listing keyword filter, comma-separated ('pool', 'waterfront', 'guest house').

Try in playground →

post/realtor/v1/comps2 credits

Comparable homes near a property — synthesized from recently-sold and active listings around the subject's coordinates, scored by distance, beds and sqft.

Parameter		Allowed / range	Description
property_id	required	—	Realtor.com property id (from a search result's property_id, or the M-code in a listing URL).
radius_miles = 2	optional	0.25–25	Search radius around the subject in miles.
max_comps = 12	optional	1–50	How many comparables to return.
include_active = false	optional	—	Also include currently-active listings as comps (default: recently-sold only).

Try in playground →

post/realtor/v1/autocomplete1 credit

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.

Parameter		Allowed / range	Description
query	required	—	Free-text location to autocomplete — a partial city, ZIP, neighborhood, county or school ('Austi', '787', 'Brookl').
limit = 10	optional	1–25	Max suggestions to return (1-25).

Try in playground →

Example request · search

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"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}