Get income by ZIP
get_incomeRead-only
Retrieve income metrics for a U.S. ZIP code: median household income, per-capita income, household count, and percentage earning $200k+ based on ACS 5-year estimates.
Instructions
Income measures for a ZIP: median household, per-capita, and % $200k+.
`zip_code`: a 5-digit US ZIP. Returns median household income, per-capita
income, the number of households, and the percent of households earning
$200k+ — all ACS 5-year estimates in USD. Note: ACS top-codes median
household income at $250,001, so the wealthiest ZIPs (e.g. Atherton 94027)
report exactly that — read it as "$250k or more," not an exact figure.
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) | |
| total_households | No | Total number of households | |
| per_capita_income | No | Per-capita income | |
| median_household_income | No | Median household income | |
| households_200k_plus_pct | No | Percent of households with income $200k+ (0-100) |