The /market-stats endpoint returns current market statistics for a US ZIP code: median prices, days on market, active listings, year-over-year price change, and market temperature classification.

Request

GET /market-stats?zip_code={zip_code} Required Parameters: zip_code (string) — 5-digit US ZIP code (e.g., "78701") Required Headers: x-rapidapi-proxy-secret: YOUR_API_KEY

Response Schema

{ "zip_code": "78701", "data_date": "2026-07", // YYYY-MM of data vintage "median_sale_price": 475000, // USD "median_list_price": 495000, // USD "median_days_on_market": 18, // integer days "active_listings": 94, // count "yoy_price_change": 0.032, // decimal fraction: 0.032 = +3.2% "market_temperature": "Warm", // see the band table below "data_source": "redfin_mls", // "estimated" when modelled "data_age_days": 21 // age of the row, in days }

Market Temperature Bands

The label is derived from median days on market alone, and is null when days on market is unknown — an absent reading is never reported as a hot market.

Median days on marketmarket_temperature
Under 15Hot
15–27Warm
28–41Balanced
42–57Cool
58 or moreBuyer's Market

Two freshness fields matter more than they look. data_source is "redfin_mls" for a real Redfin row and "estimated" when the ZIP was too sparse and a regional anchor was substituted — an estimated response also carries estimate_basis explaining what it was built from. data_age_days measures from the end of the reporting month, and once it passes 75 the response gains is_stale: true. Check both before treating a figure as current.

Code Examples

# Python import requests r = requests.get("https://zipmarketdata.com/market-stats", params={"zip_code": "78701"}, headers={"x-rapidapi-proxy-secret": "YOUR_KEY"}) data = r.json() // JavaScript (Node.js) const res = await fetch( "https://zipmarketdata.com/market-stats?zip_code=78701", { headers: { "x-rapidapi-proxy-secret": "YOUR_KEY" } } ); const data = await res.json();

Error Responses

StatusMeaning
200Success
400Invalid ZIP code format
401Missing or invalid API key
404ZIP code not found in database
429Rate limit exceeded