Do I need a credit card to try the API?

No. The free tier on RapidAPI is available without a credit card and includes 100 requests/day. Paid tiers require a credit card through RapidAPI's standard billing.

What format are API responses in?

All responses are JSON. Error responses follow a standard format: {"detail": "error message", "status_code": 4xx}. Successful responses vary by endpoint but are documented in the Swagger UI at /docs.

Getting Started with the ZipMarketData API

ZipMarketData is a REST API delivering US real estate market data — median prices, rental yields, cash flow projections, and affordability indices — for any US ZIP code. This guide walks through authentication, your first request, and parsing responses.

Step 1: Get Your API Key

ZipMarketData is available on RapidAPI. Sign up at the pricing page, subscribe to a plan, and copy your x-rapidapi-key from your RapidAPI dashboard. The free tier includes 100 requests/day — enough for development and light production use.

Step 2: Your First Request

curl -X GET "https://zipmarketdata.com/market-stats?zip_code=10001" \
  -H "x-rapidapi-proxy-secret: YOUR_KEY"

Step 3: Understanding the Response

{
  "zip_code": "10001",
  "data_date": "2025-02",
  "median_sale_price": 895000,
  "median_list_price": 925000,
  "median_days_on_market": 38,
  "active_listings": 124,
  "yoy_price_change": 2.1,
  "market_temperature": "warm"
}

Step 4: Explore All Endpoints

Explore the interactive Swagger docs at /docs to see all available endpoints, parameters, and response schemas without writing any code.

Rate Limits and Best Practices

Rate limit: 120 requests/minute burst
Cache responses locally for 24 hours — data updates once daily
Use /health to check data freshness before bulk processing
Handle 429 responses with exponential backoff