Global Rent & Housing Prices API

Rental prices, property price indices, and affordability metrics across 300+ global cities. Track housing market trends with data sourced from Numbeo and National Statistics Offices.

Live

Base URL

https://api.crimate.net/v1/housing

Authentication

Include your Housing API key in the Authorization header.

curl -H "Authorization: Bearer db_housing_live_YOUR_KEY" \
     https://api.crimate.net/v1/housing/rentals/latest

Endpoints

GET/v1/housing/cities

List all cities with available housing data, filterable by country or region

Parameters: country (ISO alpha-2), region, page, per_page

Example

GET /v1/housing/cities?country=ZA

GET/v1/housing/cities/{cityCode}

Detailed housing profile for a specific city including median rent, sale price, and key ratios

Parameters: cityCode (required, path)

Example

GET /v1/housing/cities/CPT

GET/v1/housing/rentals

Rental price listings with filters for city, property type, bedrooms, and date range

Parameters: city, type (apartment|house), bedrooms (1-5), from (YYYY-MM), to (YYYY-MM), page, per_page

Example

GET /v1/housing/rentals?city=CPT&type=apartment&bedrooms=2

GET/v1/housing/rentals/latest

Most recent median rental prices per city and property type

Parameters: city (optional), type (optional)

Example

GET /v1/housing/rentals/latest?city=JNB

GET/v1/housing/indices

Housing price indices over time by city or country, with base year 2015 = 100

Parameters: city, country, from (YYYY-MM), to (YYYY-MM), page, per_page

Example

GET /v1/housing/indices?country=ZA&from=2025-01&to=2026-01

GET/v1/housing/affordability

Affordability metrics: price-to-income ratio, rent-to-income ratio, and mortgage affordability by city

Parameters: city (required)

Example

GET /v1/housing/affordability?city=CPT

GET/v1/housing/stats

Dataset statistics (total cities, countries, records, latest period)

Parameters: None

Example

GET /v1/housing/stats

Response Examples

Latest rentals response:

{
  "rentals": [
    {
      "city_code": "CPT",
      "city_name": "Cape Town",
      "country": "ZA",
      "type": "apartment",
      "bedrooms": 2,
      "median_rent_usd": 820.00,
      "median_rent_local": 15400.00,
      "currency": "ZAR",
      "period": "2026-02",
      "change_mom_pct": 1.80,
      "change_yoy_pct": 7.50
    },
    {
      "city_code": "JNB",
      "city_name": "Johannesburg",
      "country": "ZA",
      "type": "apartment",
      "bedrooms": 2,
      "median_rent_usd": 640.00,
      "median_rent_local": 12000.00,
      "currency": "ZAR",
      "period": "2026-02",
      "change_mom_pct": 0.90,
      "change_yoy_pct": 5.20
    }
  ]
}

Try It

Enter your Housing API key to make a live request. Generate a key in the dashboard.

Try It

Make a live API call from your browser

API Key

Endpoint

GET

curl -H "Authorization: Bearer db_housing_live_YOUR_KEY" \
     "https://crimate.net/v1/housing/stats"

Data Sources

Numbeo

Crowd-sourced and verified cost-of-living data covering rental prices, property sale prices, and affordability ratios across 300+ cities worldwide. Updated monthly with community-contributed data points validated against official sources.

National Statistics Offices

Official housing price indices and rental surveys from government statistics agencies including Stats SA, ONS (UK), BLS (US), and Eurostat. Provides authoritative benchmarks for property price trends and housing affordability indicators.

Rate Limits

Tier	Price	Rate Limit	Daily Quota	Monthly Quota
Free	R0/mo	10 req/min	100	1,000
Starter	R899/mo	60 req/min	5,000	50,000
Pro	R3,499/mo	300 req/min	Unlimited	500,000

Error Codes

All error responses follow a consistent JSON format:

{
  "error": "error_code",
  "message": "Human-readable description."
}

Status	Error Code	Description
400	invalid_request	The request body or query parameters are malformed.
401	unauthorized	Missing or invalid API key.
403	no_subscription	No active subscription for this API product.
403	quota_exceeded	Daily or monthly quota exceeded.
404	not_found	The requested resource does not exist.
429	rate_limit_exceeded	Too many requests. Check X-RateLimit-Remaining header.
500	internal_error	An unexpected server error occurred.