Introduction
The Real Estate API provides ZIP-level market intelligence, rental rates, neighborhood scores, school ratings, and FEMA flood risk data — all in a clean JSON API with sub-100ms responses.
- Real estate investment analysis and property valuation
- Rental market research and pricing tools
- Neighborhood quality and livability scoring
- School district analysis for home buyers
- Flood risk assessment for mortgage and insurance platforms
- ZIP-code comparison dashboards for agents
Authentication
All /v1/* endpoints require an API key. Pass it in the X-API-Key header:
Header (required)
X-API-Key: re_your_api_key_here
Create an account to get your API key instantly.
Quickstart
Get market data for ZIP code 10001 in under 5 seconds:
curl -H "X-API-Key: re_yourkey" \ "https://realestate.ai32api.com/v1/market/10001"
import requests
resp = requests.get(
"https://realestate.ai32api.com/v1/market/10001",
headers={"X-API-Key": "re_yourkey"}
)
data = resp.json()
print(f"Median price: ${data['data']['median_price']:,}")
print(f"Avg rent: ${data['data']['avg_rent']:,}/mo")const res = await fetch(
"https://realestate.ai32api.com/v1/market/10001",
{ headers: { "X-API-Key": "re_yourkey" } }
);
const { data } = await res.json();
console.log(`Median: $${data.median_price.toLocaleString()}`);
console.log(`Rent: $${data.avg_rent.toLocaleString()}/mo`);req, _ := http.NewRequest("GET",
"https://realestate.ai32api.com/v1/market/10001", nil)
req.Header.Set("X-API-Key", "re_yourkey")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
var result map[string]any
json.NewDecoder(resp.Body).Decode(&result)Error Codes
| HTTP Status | Description |
|---|---|
| 400 | Invalid parameter or malformed request |
| 401 | Missing or invalid API key |
| 403 | Plan upgrade required for this endpoint |
| 404 | ZIP code or metro area not found |
| 429 | Monthly quota or per-minute rate limit exceeded |
| 500 | Unexpected server error |
{
"error": "invalid zip code",
"code": 400
}Rate Limits
| Plan | Calls / month | Endpoints |
|---|---|---|
| Trial | 1,000 | Market data only |
| Starter | 25,000 | Market + Trends + Rental + Compare |
| Growth | 250,000 | All endpoints |
| Business | 2,500,000 | All endpoints + priority support |
Rate limit headers are returned on every response: X-RateLimit-Plan, X-RateLimit-Used, X-RateLimit-Limit.
API Playground
// Select an endpoint and click Run ▶
/health
Returns service status. No authentication required.
{ "status": "ok", "version": "1.0.0" }/v1/market/{zip}
Returns real estate market data for a specific ZIP code including median prices, price trends, inventory, and days on market.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
zip | string | required | 5-digit US ZIP code, e.g. 10001 |
{
"success": true,
"data": {
"zip": "10001",
"city": "New York",
"state": "NY",
"median_price": 850000,
"price_per_sqft": 1240,
"avg_days_on_market": 18,
"inventory_count": 142,
"yoy_price_change": 4.2,
"updated_at": "2026-05-01T00:00:00Z"
}
}/v1/market/search
Search for market data across multiple ZIP codes by city, state, or custom query.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | required | City name, state code, or ZIP prefix |
limit | integer | optional | Max results. Default: 10, max: 50 |
/v1/trends/{metro}
Starter+Returns 12-month price trend data for a metro area including monthly median prices and price change percentage.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
metro | string | required | Metro area slug, e.g. new-york, los-angeles, chicago |
{
"success": true,
"data": {
"metro": "new-york",
"months": [
{ "month": "2025-05", "median_price": 812000, "change_pct": 2.1 },
{ "month": "2025-06", "median_price": 819000, "change_pct": 0.9 }
]
}
}/v1/rental/{zip}
Starter+Returns rental rate data for a ZIP code including average rents by bedroom count and vacancy rates.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
zip | string | required | 5-digit US ZIP code |
{
"success": true,
"data": {
"zip": "10001",
"avg_rent_studio": 2400,
"avg_rent_1br": 3200,
"avg_rent_2br": 4800,
"avg_rent_3br": 7200,
"vacancy_rate": 3.1,
"yoy_rent_change": 5.4
}
}/v1/neighborhood
Growth+Returns a comprehensive neighborhood quality score with sub-scores for safety, walkability, transit, restaurants, and entertainment.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
zip | string | required | 5-digit US ZIP code |
{
"success": true,
"data": {
"zip": "10001",
"overall_score": 88,
"walk_score": 99,
"transit_score": 100,
"safety_score": 71,
"restaurant_score": 95,
"entertainment_score": 92
}
}/v1/schools
Growth+Returns nearby school information including GreatSchools ratings, school type, and distance.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
zip | string | required | 5-digit US ZIP code |
radius_miles | float | optional | Search radius. Default: 2.0, max: 10.0 |
type | string | optional | elementary, middle, high, or omit for all |
/v1/flood-risk
Growth+Returns FEMA flood zone data and risk assessment for properties in a ZIP code area.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
zip | string | required | 5-digit US ZIP code |
{
"success": true,
"data": {
"zip": "10001",
"fema_zone": "X",
"risk_level": "minimal",
"pct_high_risk": 2.1,
"pct_moderate_risk": 8.4,
"flood_insurance_required": false
}
}/v1/compare
Starter+Compare market data across multiple ZIP codes side by side.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
zips | string | required | Comma-separated ZIP codes, e.g. 10001,90210,60601 |