Get housing by ZIP
get_housingRead-only
Retrieve housing metrics for a U.S. ZIP code: median home value, monthly rent, occupied units, and owner-occupied share. Uses ACS 5-year data; values capped at $2,000,001.
Instructions
Housing measures for a ZIP: home value, rent, and owner-occupied share.
`zip_code`: a 5-digit US ZIP. Returns the median value of owner-occupied
homes, the median gross rent (monthly), the number of occupied housing
units, and the percent that are owner-occupied — all ACS 5-year estimates.
Note: ACS top-codes median home value at $2,000,001, so the priciest ZIPs
(e.g. Atherton 94027) report exactly that — read it as "$2M or more," not an
exact value.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip_code | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Census name for the area | |
| zcta | Yes | 5-digit ZIP Code Tabulation Area | |
| vintage | Yes | ACS 5-year data vintage (end year) | |
| occupied_units | No | Total occupied housing units | |
| median_gross_rent | No | Median gross rent (rent + utilities), monthly | |
| median_home_value | No | Median value of owner-occupied homes | |
| owner_occupied_pct | No | Percent of occupied units that are owner-occupied (0-100) |