# Zillow Home Value Index (ZHVI) Lookup

> Zillow Home Value Index (ZHVI) Lookup is a paid API for AI agents from api.jobsproperty-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns Zillow's official mid-tier home value index (ZHVI) for US states or metro areas, including latest value, year-over-year change, and monthly history back to 2000.

## Facts

- Endpoint: GET https://api.jobsproperty-api.workers.dev/api/realestate/zillow?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zillow-home-value-index-zhvi-lookup-ec67a2d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__UPlHMR6X9vp7Y-xaVMDQ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zillow-home-value-index-zhvi-lookup-ec67a2d3
```

Example prompt: What's the current Zillow home value index for Texas, and how has it changed over the past 12 months? Show me the monthly history too.

## When to prefer this

Use this endpoint when you need authoritative, smoothed, seasonally adjusted home value index data for US states or metro areas from Zillow's official research dataset (ZHVI). Prefer this over scraping Zillow listings or Zestimates (which are blocked) when you need aggregate market trends, year-over-year comparisons, or multi-year historical context rather than individual property estimates. Best suited for market analysis, investment research, or reporting dashboards.

## Known failure modes

- No matching region found for the provided name — returns empty results array
- Invalid 'level' parameter (must be 'state' or 'metro') — may return error or default
- 'months' parameter out of range (must be 1-320) — may return error or clamp
- Data may be up to one month stale since ZHVI is updated monthly
- Zillow source CSV temporarily unavailable — upstream data fetch failure

## How this service works

Typical US home value from the Zillow Home Value Index (ZHVI, Zillow Research's official public data: mid-tier homes, single-family + condo, smoothed, seasonally adjusted, USD) for states or metro areas: latest monthly value, change vs 12 months earlier and monthly history (back to 2000) for every region whose name matches (up to 10). Index data, not individual listings or Zestimates (zillow.com pages block automated access). Updated monthly.

## Output

A JSON object containing: the number of matching regions, the index name and level (state or metro), the source CSV URL, and for each matching region — its name, type, region ID, size rank, latest monthly value with date, year-over-year percent change, and an array of historical monthly values (date + USD value) covering the requested number of months.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "region"
     ],
     "properties": {
      "level": {
       "type": "string",
       "description": "state (default) or metro (metro file includes the United States row)"
      },
      "months": {
       "type": "string",
       "description": "How many recent monthly values per region, 1-320 (default 12)"
      },
      "region": {
       "type": "string",
       "description": "Region name or part of it, e.g. 'Texas', 'Austin, TX', 'United States' (required)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "index": "ZHVI (Zillow Home Value Index), mid-tier, USD",
  "level": "state",
  "source": "https://files.zillowstatic.com/research/public_csvs/zhvi/State_zhvi_uc_sfrcondo_tier_0.33_0.67_sm_sa_month.csv",
  "regions": [
   {
    "name": "Texas",
    "type": "state",
    "state": null,
    "latest": {
     "date": "2026-09-30",
     "value": 296423.82
    },
    "history": [
     {
      "date": "2025-10-31",
      "value": 300407.39
     },
     {
      "date": "2025-11-30",
      "value": 300252.62
     }
    ],
    "regionId": 54,
    "sizeRank": 1,
    "yoyChangePct": -1.45
   }
  ],
  "checkedAt": "2026-10-23T09:36:57.627Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zillow-home-value-index-zhvi-lookup-ec67a2d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.jobsproperty-api.workers.dev](https://www.zero.xyz/host/api.jobsproperty-api.workers.dev/llms.txt)