Find ZIPs for a place
find_zipsRead-only
Identify ZIP codes (ZCTAs) that overlap a named U.S. place. Add an optional state for disambiguation; results show each ZIP's coverage percentage.
Instructions
Reverse lookup: the ZIPs (ZCTAs) that fall within a named place.
`place`: a U.S. place name — an incorporated city/town or a census-designated
place (e.g. 'Cambridge', 'West Hollywood'); the Census descriptor is optional
('Cambridge' and 'Cambridge city' both work). `state`: optional 2-letter USPS
code or full state name to disambiguate (many places share a name). Returns
the ZCTAs intersecting that place, ranked by `coverage_pct` — the share of
each ZCTA's land that lies within the place. This is approximate: ZCTAs don't
nest inside places, so a ZIP may span several places and vice versa. Built on
the public 2020 Census ZCTA-to-Place relationship file (no API key needed).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| place | Yes | ||
| state | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The place name searched for | |
| state | No | The 2-letter USPS state filter applied, if any | |
| matches | Yes | ZCTAs intersecting the place, sorted by coverage_pct descending. Empty places (no match) raise an error instead. | |
| vintage | Yes | Census geography year of the ZCTA-to-place relationship (2020) |