docs / zillow

Zillow

US homes with prices, history and estimates.

base /zillow/v110 endpoints

post/zillow/v1/search2 credits

Search listings by location (for sale / for rent / recently sold).

Parameter		Allowed / range	Description
location	required	—	Where to search — city, ZIP, neighborhood or county ('Austin, TX', '78704', 'Brooklyn, NY').
status = for_sale	optional	for_sale · for_rent · sold	Listing status to search (synonyms rent/rental/recently_sold also accepted).
max_results = 1000	optional	1–10000	Stop after this many listings. Caps across pages — a single page (~41 listings) is always returned in full.
max_pages = 1	optional	1–20	How many result pages to fetch (~41 listings/page).
fetch_all = false	optional	—	Fetch EVERY listing in the area (returns more than Zillow's standard ~860-result cap). Slower; combine with max_results.

Try in playground →

post/zillow/v1/search_by_coordinates2 credits

Search listings inside exact map bounds (returns more than the standard ~860-result cap).

Parameter		Allowed / range	Description
map_bounds	required	—	Map viewport to search: {west, east, south, north} in decimal degrees.
status = for_sale	optional	for_sale · for_rent · sold	Listing status to search (synonyms rent/rental/recently_sold also accepted).
max_results = 1000	optional	1–10000	Stop after this many listings. Caps across pages — a single page (~41 listings) is always returned in full.
max_pages = 1	optional	1–20	How many result pages to fetch (~41 listings/page).
fetch_all = false	optional	—	Fetch EVERY listing in the area (returns more than Zillow's standard ~860-result cap). Slower; combine with max_results.

Try in playground →

post/zillow/v1/search_by_url2 credits

Run any copied Zillow URL: a search URL replays that exact search (with its filters); a property URL routes to the full property detail.

Parameter		Allowed / range	Description
url	required	—	Any Zillow search or property URL, copied from the browser.

Try in playground →

post/zillow/v1/property_detail3 credits

Full property record: Zestimate (+history), price & tax history, schools, agent, photos, RESO facts. Batch several with zpids[].

Parameter		Allowed / range	Description
zpid	optional	—	Zillow property ID. Provide zpid, zpids OR url.
zpids	optional	—	Several property IDs in one call (batch).
url	optional	—	Zillow property URL (alternative to zpid).

Try in playground →

post/zillow/v1/comps2 credits

Comparable homes near a property (synthesized similar-listing search, scored by distance/beds/sqft).

Parameter		Allowed / range	Description
zpid	optional	—	Zillow property ID — the number in the property URL (…/12345678_zpid/) or `zpid` from a search result.
url	optional	—	Zillow property URL (alternative to zpid).
radius_deg = 0.03	optional	0.005–0.5	Search radius in decimal degrees (0.03 ≈ 2 miles).
max_comps = 12	optional	1–100	How many comparables to return (1–100).

Try in playground →

post/zillow/v1/sold2 credits

Recently-sold listings (last 12 months) by location or map bounds.

Parameter		Allowed / range	Description
location	optional	—	Where to search. Provide location OR map_bounds.
map_bounds	optional	—	Exact map viewport {west, east, south, north} (alternative to location).
max_pages = 1	optional	1–20	How many result pages to fetch (~41 listings/page).
fetch_all = false	optional	—	Fetch EVERY listing in the area (returns more than Zillow's standard ~860-result cap). Slower; combine with max_results.

Try in playground →

post/zillow/v1/agent1 credit

Listing agent + broker attribution for one property (agentInfo).

Parameter		Allowed / range	Description
zpid	optional	—	Zillow property ID — the number in the property URL (…/12345678_zpid/) or `zpid` from a search result.
url	optional	—	Zillow property URL (alternative to zpid).

Try in playground →

post/zillow/v1/agent_profile1 credit

An agent's full portfolio: profile info + their for-sale/sold listings + reviews (browser-rendered; slower).

Parameter		Allowed / range	Description
username	optional	—	Agent's Zillow username (the part after /profile/). Provide username, profile_url, zuid OR url.
profile_url	optional	—	Agent profile URL.
zuid	optional	—	Advanced: Zillow user ID.

Try in playground →

post/zillow/v1/agents_by_location1 credit

Real-estate agent directory for a location, with review summaries.

Parameter		Allowed / range	Description
location	required	—	Where to search — city, ZIP, neighborhood or county ('Austin, TX', '78704', 'Brooklyn, NY').

Try in playground →

post/zillow/v1/market_trends1 credit

Region market metrics: ZHVI home-value index, median sale/list price, inventory, days-to-pending, % sold above list, rent index.

Parameter		Allowed / range	Description
location	required	—	Where to search — city, ZIP, neighborhood or county ('Austin, TX', '78704', 'Brooklyn, NY').

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/zillow/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
}