Zillow Home Value Index (ZHVI) time series by geo tier

Returns the Zillow Home Value Index - a smoothed, seasonally adjusted estimate of the typical home value across the 35th to 65th percentile tier (the mid-tier cut Zillow publishes as its default). Values are in USD and cover January 2000 through the latest published month. Available at all seven geographic tiers: national, state, metro, county, city, ZIP, and neighborhood.

Note on the metro tier: the Metro CSV includes one row with RegionType=country (the United States aggregate) alongside the ~894 Metropolitan Statistical Area rows. Consumers filtering purely on MSA rows should check RegionType=='msa'.

Data Provided by Zillow Group. Source: Zillow Research public CSV drops (zillow.com/research/data/). Used under Zillow's free-for-public-use-with-attribution policy.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Zillow Home Value Index observations per region at the requested tier, ordered ascending by month.

Bodyapplication/json

Example

{
    "data": {
        "metric": "zhvi",
        "geo_type": "metro",
        "unit": "string",
        "label": "string",
        "region_filter": "string",
        "start_month": "string",
        "end_month": "string",
        "regions": [
            {
                "RegionID": 0,
                "SizeRank": 0,
                "RegionName": "string",
                "RegionType": "string",
                "StateName": "string",
                "observations": [
                    {
                        "month": "2026-03-31",
                        "value": 0
                    }
                ],
                "count": 315,
                "property1": "string",
                "property2": "string"
            }
        ],
        "count": 1,
        "source_url": "https://files.zillowstatic.com/research/public_csvs/zhvi/Metro_zhvi_uc_sfrcondo_tier_0.33_0.67_sm_sa_month.csv",
        "dataset_last_modified": "string",
        "attribution": "Data Provided by Zillow Group (Zillow Research, zillow.com/research/data/)."
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "source": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true
    }
}

🟠401

🟠422

🟠429

🔴503