# Zillow API — US real estate data: for-sale, rental and sold listings, full property detail with Zestimate, price/tax history, schools, comps, agents, market trends, walk/transit/bike scores and home-value history

> New US inventory straight from Zillow's own published feed — the listings that appeared in the last couple of days, refreshed within the hour. Returns identity and location (zpid, canonical url, address as Zillow writes it, region, postal code, country, changed_at); pass a zpid to `property_detail` for price, beds, sqft, status and Zestimate.
> ReefAPI engine `zillow` · 14 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/zillow/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/zillow/v1/new_listings — 2 credits
New US inventory straight from Zillow's own published feed — the listings that appeared in the last couple of days, refreshed within the hour. Returns identity and location (zpid, canonical url, address as Zillow writes it, region, postal code, country, changed_at); pass a zpid to `property_detail` for price, beds, sqft, status and Zestimate.

**Parameters:**
- `category` (enum, optional, default "for_sale") — Which feed to read. [one of: for_sale, sold, for_rent, new_construction, for_sale_by_owner, auction, pending, other]
- `region` (string, optional) — Two-letter US state or Canadian province, e.g. TX. Pair with `country` — the codes overlap.
- `country` (enum, optional) — Restrict to one country. The feed mixes both. [one of: US, CA]
- `postal_prefix` (string, optional) — Match postal codes starting with this, e.g. 787 for the Austin area.
- `changed_after` (string, optional) — ISO-8601 instant; keep rows changed strictly after it (e.g. 2026-08-20T00:00:00Z). Use the previous call's `window.newest` to poll incrementally.
- `max_results` (integer, optional, default 200) — Rows to return, up to 5000.
- `page` (integer, optional, default 1) — 1-based page over the filtered set.

**Returns:** listings[]{zpid, url, address, region, postal_code, country, changed_at}, category, window{oldest, newest, is_recent_window}, pagination{page, per_page, returned, total_matched, has_more} — MEASURED 2026-08-21: sampling 14 zpids from the for-sale feed and resolving each through property_detail gave days_on_market [0,0,0,0,0,1,1,1,1,2,4] — 10 of 11 at 0-2 days, median 1, five of them day zero, all FOR_SALE. So this is genuinely new inventory. Per category the 50,000-row window covers roughly: for_sale 2 days (~25k/day), sold 3 days (~17k/day, i.e. fresh comps), for_rent 2 days (~25k/day). The smaller categories (for_sale_by_owner, auction, pending, other) are smaller than the window, so their feed is the WHOLE category rather than recent arrivals — `window.is_recent_window` says which you got, per call. ADDRESS is passed through exactly as Zillow writes it and is NOT split into street and city: the slug is `<street>-<City>-<ST>-<zip>` with both halves hyphen-separated, so any split is a guess (a naive one turns '7530-Demona-Dr-Las-Vegas-NV-89123' into street '7530 Demona Dr Las' and city 'Vegas'). `region`, `postal_code` and `country` are parsed from the unambiguous tail and are reliable. COUNTRY MATTERS: Zillow's 'us' feed carries Canada too — 40,943 US to 9,034 CA in one measured leaf — and Canadian provinces are two letters as well, so filtering on `region` alone would serve Ontario as a US state. Filter on `country` when that matters.

**Example request body:**
```json
{
  "category": "for_sale",
  "max_results": 5
}
```

### POST https://api.reefapi.com/zillow/v1/search — 2 credits
Search listings by location (for sale / for rent / recently sold), with structured filters: price, beds, baths, home type, sqft, lot, year built, HOA, days-on-market and keywords. Read `returns` before using status=for_rent (rentals come back as BUILDINGS with a units[] breakdown, not as individual apartments) or status=sold (about a dozen US states publish no sale price at all).

**Parameters:**
- `location` (string, required) — Where to search — city, ZIP, neighborhood or county ('Austin, TX', '78704', 'Brooklyn, NY'), or a street address ('5013 Cortez Way, Severance, CO') to search the blocks around it (about 2 km each way); the matched home comes back as address_match{zpid, address, latitude, longitude, search_box}. A street Zillow cannot match (no house number, or one it has no record of: 'Stonington Drive, Silver Spring, MD 20902') falls back to the ZIP / city in the same string, and meta.warnings names the area actually searched.
- `status` (enum, optional, default "for_sale") — Listing status to search (synonyms rent/rental/recently_sold also accepted). [one of: for_sale, for_rent, sold]
- `max_results` (integer, optional, default 1000) — Stop after this many listings. Caps across pages — a single page (~41 listings) is always returned in full.
- `max_pages` (integer, optional, default 1) — How many result pages to fetch (~41 listings/page).
- `fetch_all` (boolean, optional, default false) — Fetch EVERY listing in the area (returns more than Zillow's standard ~860-result cap). Slower; combine with max_results.
- `price_min` (integer, optional) — Minimum list price in USD (e.g. 300000).
- `price_max` (integer, optional) — Maximum list price in USD (e.g. 700000).
- `beds_min` (integer, optional) — Minimum bedrooms (e.g. 3 = 3+ beds).
- `baths_min` (number, optional) — Minimum bathrooms (e.g. 2 = 2+ baths).
- `home_type` (string, optional) — Property type filter — one or several (comma-separated). One of: house, condo, townhouse, multi_family, land, manufactured, apartment (e.g. 'house,condo').
- `sqft_min` (integer, optional) — Minimum living area in square feet (e.g. 1500).
- `sqft_max` (integer, optional) — Maximum living area in square feet (e.g. 3000).
- `lot_min` (integer, optional) — Minimum lot size in SQUARE FEET (43560 sqft = 1 acre).
- `lot_max` (integer, optional) — Maximum lot size in square feet.
- `year_built_min` (integer, optional) — Earliest year built (e.g. 2010).
- `year_built_max` (integer, optional) — Latest year built (e.g. 2024).
- `max_hoa` (integer, optional) — Maximum monthly HOA fee in USD (e.g. 100; 0 keeps no-HOA only).
- `days_on_max` (integer, optional) — Only listings on Zillow at most this many days (e.g. 7 = new this week).
- `keywords` (string, optional) — Free-text listing keyword filter (e.g. 'pool', 'waterfront', 'guest house').
- `sort` (enum, optional, default "relevance") — Result order (Zillow's own sort). zestimate_desc ranks by Zillow's estimated value, highest first. Rows are re-sorted on the value after fetching, rows without it last. [one of: relevance, price_desc, price_asc, zestimate_desc, zestimate_asc]
- `sold_within` (enum, optional, default "12m") — status=sold only: how far back to look. 36m is the longest Zillow offers (ZIP 20902: 419 homes in 12m, 1,183 in 36m). [one of: 6m, 12m, 24m, 36m]

**Returns:** items[]{zpid, identifier_type, is_building, url, list_price_usd, price_display, status, status_text, property_type, beds, baths, sqft, lot_sqft, zestimate_usd, rent_zestimate_usd, tax_assessed_value_usd, days_on_market, address_line, city, state_code, postal_code, latitude, longitude, photos[]} + count + total_reported + filters_applied (+ address_match{zpid, address, address_type, latitude, longitude, search_box} when location is a street address). STATUS=FOR_RENT RETURNS BUILDINGS, NOT APARTMENTS. Zillow's rental search publishes one card per apartment community. MEASURED 2026-08-28 across five cities, 41 rows each: 193 of 205 rows were buildings (Austin 41/41, Miami 41/41, Chicago 38/41, Seattle 37/41, Boise 36/41). A building row carries NO beds, baths, sqft, property_type or days_on_market: a building has no single value for any of them and Zillow sends none. It carries instead units[]{beds, rent_from_usd, rent_display, is_room_share} - one entry per floor plan, 493 entries over those same five pages - plus rent_min_usd, rent_max_usd, beds_min, beds_max, units_available, building_name and building_id. Its `zpid` is Zillow's BUILDING KEY, a '<lat>--<lng>' string rather than a property id, so it will not resolve in property_detail; `identifier_type` reads 'building_key' or 'zpid' on every row and `is_building` is the boolean. The remaining ~6% of rental rows are single homes or units and do carry beds, baths, sqft and a price. STATUS=SOLD: THE SALE PRICE IS NOT PUBLISHED IN NON-DISCLOSURE STATES. Twelve US states - AK, ID, KS, LA, MS, MO, MT, NM, ND, TX, UT, WY - keep sale prices off the public record and Zillow shows no price for any listing in them. MEASURED 2026-09-24, 41 rows per metro: priced 41/41 in Columbus OH, Charlotte NC, Phoenix AZ and Denver CO; 0/41 Austin TX, 1/41 Houston TX, 1/41 Salt Lake City UT, 1/41 Jackson MS. There sold_price_usd, list_price_usd and price_display are null and property_detail cannot recover them - the number is not on Zillow in any form, so this API returns null rather than guessing. Each unpriced row carries price_unavailable_reason ('non_disclosure_state' = the number does not exist; 'not_published_by_source' = a disclosure state where this card has none). sold_date, tax_assessed_value_usd and zestimate_usd DO fill (the Zestimate is Zillow's estimate of value, NOT the price paid). meta.fields_not_published repeats all of this, with the affected row count and the split by reason and state, on any response where it applies. SORT (optional): price_desc/price_asc/zestimate_desc/zestimate_asc ask Zillow for that order and the rows are re-sorted on the value (rows without it last); meta.sort echoes it. With status=sold, sold_within (6m/12m/24m/36m, default 12m) sets the window. OFF-MARKET HOMES ARE NOT IN ZILLOW'S SEARCH: it lists listings (for sale, for rent, sold within 36 months), not every house; to rank a whole ZIP by Zestimate, combine status=for_sale and status=sold with sold_within=36m, sort=zestimate_desc (ZIP 20902: 91 + 1,183 homes).

**Example request body:**
```json
{
  "location": "Austin, TX"
}
```

### POST https://api.reefapi.com/zillow/v1/search_by_coordinates — 2 credits
Search listings inside exact map bounds (returns more than the standard ~860-result cap), with the same structured filters as search.

**Parameters:**
- `map_bounds` (object, required) — Map viewport to search: {west, east, south, north} in decimal degrees.
- `status` (enum, optional, default "for_sale") — Listing status to search (synonyms rent/rental/recently_sold also accepted). [one of: for_sale, for_rent, sold]
- `max_results` (integer, optional, default 1000) — Stop after this many listings. Caps across pages — a single page (~41 listings) is always returned in full.
- `max_pages` (integer, optional, default 1) — How many result pages to fetch (~41 listings/page).
- `fetch_all` (boolean, optional, default false) — Fetch EVERY listing in the area (returns more than Zillow's standard ~860-result cap). Slower; combine with max_results.
- `price_min` (integer, optional) — Minimum list price in USD (e.g. 300000).
- `price_max` (integer, optional) — Maximum list price in USD (e.g. 700000).
- `beds_min` (integer, optional) — Minimum bedrooms (e.g. 3 = 3+ beds).
- `baths_min` (number, optional) — Minimum bathrooms (e.g. 2 = 2+ baths).
- `home_type` (string, optional) — Property type filter — one or several (comma-separated). One of: house, condo, townhouse, multi_family, land, manufactured, apartment (e.g. 'house,condo').
- `sqft_min` (integer, optional) — Minimum living area in square feet (e.g. 1500).
- `sqft_max` (integer, optional) — Maximum living area in square feet (e.g. 3000).
- `lot_min` (integer, optional) — Minimum lot size in SQUARE FEET (43560 sqft = 1 acre).
- `lot_max` (integer, optional) — Maximum lot size in square feet.
- `year_built_min` (integer, optional) — Earliest year built (e.g. 2010).
- `year_built_max` (integer, optional) — Latest year built (e.g. 2024).
- `max_hoa` (integer, optional) — Maximum monthly HOA fee in USD (e.g. 100; 0 keeps no-HOA only).
- `days_on_max` (integer, optional) — Only listings on Zillow at most this many days (e.g. 7 = new this week).
- `keywords` (string, optional) — Free-text listing keyword filter (e.g. 'pool', 'waterfront', 'guest house').
- `sort` (enum, optional, default "relevance") — Result order (Zillow's own sort). zestimate_desc ranks by Zillow's estimated value, highest first. Rows are re-sorted on the value after fetching, rows without it last. [one of: relevance, price_desc, price_asc, zestimate_desc, zestimate_asc]
- `sold_within` (enum, optional, default "12m") — status=sold only: how far back to look. 36m is the longest Zillow offers (ZIP 20902: 419 homes in 12m, 1,183 in 36m). [one of: 6m, 12m, 24m, 36m]

**Returns:** items[] - the same shape, and the same for_rent (buildings, not apartments) and sold (no price in non-disclosure states) caveats, as `search` - plus filters_applied.

**Example request body:**
```json
{
  "map_bounds": {
    "west": -97.78,
    "east": -97.7,
    "south": 30.24,
    "north": 30.3
  }
}
```

### POST https://api.reefapi.com/zillow/v1/search_by_url — 2 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.

**Parameters:**
- `url` (string, required) — Any Zillow search or property URL, copied from the browser.

**Returns:** items[] (search URL) or listing{...} (property URL)

**Example request body:**
```json
{
  "url": "https://www.zillow.com/austin-tx/rentals/"
}
```

### POST https://api.reefapi.com/zillow/v1/property_detail — 3 credits
Full property record: Zestimate (+history), price & tax history, schools, climate risk, walk/transit/bike scores, listing agent, photos, RESO facts. Batch several with zpids[].

**Parameters:**
- `zpid` (string, optional) — Zillow property ID. Provide zpid, zpids OR url.
- `zpids` (array, optional) — Several property IDs in one call (batch).
- `url` (string, optional) — Zillow property URL (alternative to zpid).

**Returns:** listing{zpid, url, status, property_type, address_line, city, state_code, postal_code, county, latitude, longitude, list_price_usd, price_per_sqft_usd, zestimate_usd, zestimate_history[]{date_ms, value_usd}, rent_zestimate_usd, last_sold_price_usd, last_sold_date, beds, baths, sqft, lot_sqft, year_built, days_on_market, property_tax_rate, hoa_fee_monthly_usd, parcel_id, description, price_history[]{date, price_usd, price_per_sqft_usd, event, source}, tax_history[]{year, tax_paid_usd, assessed_value_usd, tax_increase_rate, value_increase_rate}, schools[]{name, rating, level, grades, type, distance_miles, district_name, enrollment, student_teacher_ratio}, climate_risk{flood, fire, wind, air, heat}, walk_transit_score{...}, listing_agent{agent_name, agent_license, broker_name, mls_id, mls_name}, photos[], nearby_areas{...}, reso_facts{...}} (or items[] for the zpids batch). PRICE & TAX HISTORY, SCHOOLS, CLIMATE RISK AND THE FULL RESO BLOCK ARE FETCHED SEPARATELY. Zillow serves them on a second request rather than on the property page, and this API makes that request for you. It nearly always succeeds; when it does not, meta.fields_not_retrieved names every field that stayed empty for that reason and says the call is worth retrying, so an empty tax_history never has to be guessed at. meta.second_paint is 'ok' when the second request landed. ON A SOLD HOME IN A NON-DISCLOSURE STATE (AK, ID, KS, LA, MS, MO, MT, NM, ND, TX, UT, WY) there is no sale price to return: list_price_usd comes back null (NOT 0) with price_unavailable_reason set to 'non_disclosure_state', and the Sold rows in price_history carry a null price. Verified against Zillow itself 2026-09-24 on nine TX/UT/MS homes: every Sold event in Zillow's own history, back to 2010 and including ones it sources from Public Record, has no price - while three Columbus OH homes carry one on every Sold event back to 1996. Retrying cannot change it. tax_history, schools, zestimate_usd and the property facts fill normally in those states.

**Example request body:**
```json
{
  "zpid": "29377187"
}
```

### POST https://api.reefapi.com/zillow/v1/comps — 2 credits
Comparable homes near a property (synthesized similar-listing search, scored by distance/beds/sqft).

**Parameters:**
- `zpid` (string, optional) — Zillow property ID — the number in the property URL (…/12345678_zpid/) or `zpid` from a search result.
- `url` (string, optional) — Zillow property URL (alternative to zpid).
- `radius_deg` (number, optional, default 0.03) — Search radius in decimal degrees (0.03 ≈ 2 miles).
- `max_comps` (integer, optional, default 12) — How many comparables to return (1–100).

**Returns:** subject{...} + comps[]{zpid, address_line, list_price_usd, beds, baths, sqft, distance_miles (straight-line from the subject; also echoed as `distance`), latitude, longitude, photos[]} + count + status + radius_deg + method. When the subject is a sold home, the comps are sold homes too - so in a non-disclosure state their prices are null and each such row carries price_unavailable_reason, exactly as in `sold`.

**Example request body:**
```json
{
  "zpid": "29377187",
  "max_comps": 5
}
```

### POST https://api.reefapi.com/zillow/v1/sold — 2 credits
Recently-sold listings (last 12 months; sold_within up to 36m) by location or map bounds, with the same structured filters as search. The sale price fills in disclosure states and is genuinely absent in non-disclosure ones - read `returns` before building on it.

**Parameters:**
- `location` (string, optional) — Where to search. Provide location OR map_bounds.
- `map_bounds` (object, optional) — Exact map viewport {west, east, south, north} (alternative to location).
- `max_pages` (integer, optional, default 1) — How many result pages to fetch (~41 listings/page).
- `fetch_all` (boolean, optional, default false) — Fetch EVERY listing in the area (returns more than Zillow's standard ~860-result cap). Slower; combine with max_results.
- `price_min` (integer, optional) — Minimum list price in USD (e.g. 300000).
- `price_max` (integer, optional) — Maximum list price in USD (e.g. 700000).
- `beds_min` (integer, optional) — Minimum bedrooms (e.g. 3 = 3+ beds).
- `baths_min` (number, optional) — Minimum bathrooms (e.g. 2 = 2+ baths).
- `home_type` (string, optional) — Property type filter — one or several (comma-separated). One of: house, condo, townhouse, multi_family, land, manufactured, apartment (e.g. 'house,condo').
- `sqft_min` (integer, optional) — Minimum living area in square feet (e.g. 1500).
- `sqft_max` (integer, optional) — Maximum living area in square feet (e.g. 3000).
- `lot_min` (integer, optional) — Minimum lot size in SQUARE FEET (43560 sqft = 1 acre).
- `lot_max` (integer, optional) — Maximum lot size in square feet.
- `year_built_min` (integer, optional) — Earliest year built (e.g. 2010).
- `year_built_max` (integer, optional) — Latest year built (e.g. 2024).
- `max_hoa` (integer, optional) — Maximum monthly HOA fee in USD (e.g. 100; 0 keeps no-HOA only).
- `days_on_max` (integer, optional) — Only listings on Zillow at most this many days (e.g. 7 = new this week).
- `keywords` (string, optional) — Free-text listing keyword filter (e.g. 'pool', 'waterfront', 'guest house').
- `sort` (enum, optional, default "relevance") — Result order (Zillow's own sort). zestimate_desc ranks by Zillow's estimated value, highest first. Rows are re-sorted on the value after fetching, rows without it last. [one of: relevance, price_desc, price_asc, zestimate_desc, zestimate_asc]
- `sold_within` (enum, optional, default "12m") — status=sold only: how far back to look. 36m is the longest Zillow offers (ZIP 20902: 419 homes in 12m, 1,183 in 36m). [one of: 6m, 12m, 24m, 36m]

**Returns:** items[]{zpid, url, sold_price_usd, sold_date, list_price_usd, price_display, status (RECENTLY_SOLD), property_type, beds, baths, sqft, lot_sqft, zestimate_usd, tax_assessed_value_usd, address_line, city, state_code, postal_code, latitude, longitude, photos[]} + count + total_reported + filters_applied. WHERE THE SALE PRICE EXISTS AND WHERE IT DOES NOT: twelve US states are non-disclosure markets - AK, ID, KS, LA, MS, MO, MT, NM, ND, TX, UT, WY - where what a home sold for is not a public record, so Zillow publishes no price on any recently-sold listing there. MEASURED 2026-09-24, one page (41 rows) per metro: priced 41/41 in Columbus OH, Charlotte NC, Phoenix AZ and Denver CO; 0/41 Austin TX, 1/41 Houston TX, 1/41 Salt Lake City UT, 1/41 Jackson MS. Verified against Zillow's own property record the same day: on nine TX/UT/MS homes every Sold event in Zillow's price history - back to 2010, including events it sources from Public Record - has a null price, while three Columbus OH homes carry a price on every Sold event back to 1996. So the number does not exist upstream; sold_price_usd, list_price_usd and price_display come back null rather than invented, and property_detail cannot rescue them. EVERY UNPRICED ROW SAYS WHY: price_unavailable_reason is 'non_disclosure_state' (the number does not exist anywhere - do not retry) or 'not_published_by_source' (a disclosure state where this particular card has no price, usually withheld or not yet reported - property_detail may have it), with the long form in price_unavailable_detail. meta.fields_not_published repeats the split with rows_by_reason and rows_by_state. What you DO get everywhere: sold_date, tax_assessed_value_usd and zestimate_usd. The Zestimate is Zillow's own estimate of value and is NOT the price the home changed hands for - do not read it as one.

**Example request body:**
```json
{
  "location": "Seattle, WA"
}
```

### POST https://api.reefapi.com/zillow/v1/agent — 2 credits
Listing agent + broker attribution for one property (agentInfo).

**Parameters:**
- `zpid` (string, optional) — Zillow property ID — the number in the property URL (…/12345678_zpid/) or `zpid` from a search result.
- `url` (string, optional) — Zillow property URL (alternative to zpid).

**Returns:** agent{agent_name, agent_license, broker_name, co_agent_name, buyer_agent…} + for_property{zpid, address_line, list_price_usd, status} (contact details require include_pii)

**Example request body:**
```json
{
  "url": "https://www.zillow.com/homedetails/29377187_zpid/"
}
```

### POST https://api.reefapi.com/zillow/v1/agent_profile — 3 credits
An agent's full portfolio: profile info + their for-sale/sold listings + reviews.

**Parameters:**
- `username` (string, optional) — Agent's Zillow username (the part after /profile/; e.g. the profile_url a `agents_by_location` row returns). Provide username, profile_url, zuid OR url.
- `profile_url` (string, optional) — Agent profile URL.
- `zuid` (string, optional) — Advanced: Zillow user ID.

**Returns:** agent{name, business_name, rating_average, review_count, years_experience, specialties[], license_number, license_state, sale_count_all_time, sales_last_12mo, price_range, average_price, photo_url, service_areas[]} + for_sale[] + sold[] + reviews[]{rating, text, date, reviewer}

**Example request body:**
```json
{
  "profile_url": "https://www.zillow.com/profile/ericbramlett/"
}
```

### POST https://api.reefapi.com/zillow/v1/agents_by_location — 2 credits
Real-estate agent directory for a location, with review summaries.

**Parameters:**
- `location` (string, required) — Where to search — city, ZIP, neighborhood or county ('Austin, TX', '78704', 'Brooklyn, NY'), or a street address ('5013 Cortez Way, Severance, CO') to search the blocks around it (about 2 km each way); the matched home comes back as address_match{zpid, address, latitude, longitude, search_box}. A street Zillow cannot match (no house number, or one it has no record of: 'Stonington Drive, Silver Spring, MD 20902') falls back to the ZIP / city in the same string, and meta.warnings names the area actually searched.

**Returns:** agents[]{name, subtitle, encoded_zuid, profile_url, rating (0-5), review_count (integer), review_count_text, review_average, is_top_agent, tags[]} + count + location. Pass an agent's profile_url or the last segment of it to `agent_profile` for their sale counts, licence, specialties, listings and reviews - those are on the profile page, not in the directory card.

**Example request body:**
```json
{
  "location": "Austin, TX"
}
```

### POST https://api.reefapi.com/zillow/v1/autocomplete — 1 credit
Location autocomplete — suggest Zillow regions and addresses for a free-text query (city, ZIP, neighborhood, county or street). Use it to resolve a fuzzy term before searching, or to power a search box.

**Parameters:**
- `query` (string, required) — Free-text location to autocomplete — a partial city, ZIP, neighborhood, county or street ('Brookl', '787', 'Austin').
- `limit` (integer, optional, default 10) — Max suggestions to return (1–25).

**Returns:** suggestions[]{name, type, region_id, latitude, longitude} + count + query

**Example request body:**
```json
{
  "query": "Austin"
}
```

### POST https://api.reefapi.com/zillow/v1/market_trends — 2 credits
Region market metrics: ZHVI home-value index, median sale/list price, inventory, days-to-pending, % sold above list, rent index.

**Parameters:**
- `location` (string, required) — Where to search — city, ZIP, neighborhood or county ('Austin, TX', '78704', 'Brooklyn, NY'), or a street address ('5013 Cortez Way, Severance, CO') to search the blocks around it (about 2 km each way); the matched home comes back as address_match{zpid, address, latitude, longitude, search_box}. A street Zillow cannot match (no house number, or one it has no record of: 'Stonington Drive, Silver Spring, MD 20902') falls back to the ZIP / city in the same string, and meta.warnings names the area actually searched.

**Returns:** market{zhvi_usd, median_sale_price_usd, median_list_price_usd, for_sale_inventory, days_to_pending, pct_sold_above_list, rent_zori_usd} + location + region_id + region_type

**Example request body:**
```json
{
  "location": "Austin, TX"
}
```

### POST https://api.reefapi.com/zillow/v1/walk_transit_bike — 1 credit
Zillow Walk Score, Transit Score and Bike Score for a property — walkability, public-transit access and bikeability (0-100) with a description for each.

**Parameters:**
- `zpid` (string, optional) — Zillow property ID — the number in the property URL (…/12345678_zpid/) or `zpid` from a search result.
- `url` (string, optional) — Zillow property URL (alternative to zpid).

**Returns:** scores{walk_score, walk_description, transit_score, transit_description, bike_score, bike_description} + zpid

**Example request body:**
```json
{
  "zpid": "29377187"
}
```

### POST https://api.reefapi.com/zillow/v1/home_value_chart — 1 credit
Zillow home-value history — the Zestimate value-over-time series for a property (monthly home value, up to the last 10 years, with the latest forecast point).

**Parameters:**
- `zpid` (string, optional) — Zillow property ID — the number in the property URL (…/12345678_zpid/) or `zpid` from a search result.
- `url` (string, optional) — Zillow property URL (alternative to zpid).
- `time_period` (enum, optional, default "10y") — History window for the home-value chart. [one of: 1y, 5y, 10y]

**Returns:** this_home{name, points[]{date_ms, value_usd}, point_count} + series[] + latest_value_usd + earliest_value_usd + time_period + zpid

**Example request body:**
```json
{
  "zpid": "29377187"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=zillow
- Human docs page: https://reefapi.com/docs/zillow
- Overview page: https://reefapi.com/zillow-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
