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": "2025-02", // 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": 3.2, // percent, +/- float
"market_temperature": "hot", // "hot" | "warm" | "cool"
"is_estimated": false // true if data is sparse/estimated
}
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
| Status | Meaning |
|---|---|
| 200 | Success |
| 400 | Invalid ZIP code format |
| 401 | Missing or invalid API key |
| 404 | ZIP code not found in database |
| 429 | Rate limit exceeded |