uszipcode

What it is and what it does

uszipcode is a Python library that bundles a snapshot of US zipcode data crawled from data.census.gov, exposing it through a queryable search interface. It includes 42,724 zipcodes (STANDARD, PO BOX, UNIQUE, and MILITARY types) with associated census demographics, geographic coordinates, housing statistics, employment data, and income information. The data is primarily static from Census 2010 for demographic fields, with some time-series data extending to 2020 for population trends.

You query the database by zipcode to retrieve address, postal, geography, demographic, housing, employment, and education fields. The package depends on SQLAlchemy for data storage and retrieval, plus utilities like fuzzywuzzy for fuzzy matching and haversine for distance calculations. It is designed as a self-contained, offline-queryable reference rather than a live API client.

Use it for:

• Look up geographic coordinates and timezone for a US zipcode without calling an external API
• Retrieve Census 2010 demographic and income statistics for a zipcode to support business analytics or research
• Find housing and rental cost estimates by zipcode for real estate or relocation planning
• Query employment and educational attainment data for a region to support workforce analysis
• Perform fuzzy zipcode matching when user input is incomplete or misspelled

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides programmable access to a database of 42,724 US zipcodes with census demographics, geography, housing, employment, and income data.

Yes, if your use case tolerates static Census 2010 data and you need offline zipcode lookups without external API calls. No, if you require current census data, frequent updates, or active maintenance—the package has been abandoned since 2022-01-06 and will not receive security or data updates. Suitable for reference applications, historical analysis, or prototyping; not for production systems requiring fresh demographic data.

Install

uszipcode on PyPI

pip install uszipcode

uv add uszipcode

poetry add uszipcode

Installing uszipcode

Before you install

Low install friction with a pure-Python wheel. However, the package is abandoned—last release was 2022-01-06, over 1681 days ago. No recent maintenance or security updates; rely on it only if the data snapshot it contains meets your needs.

License in practice

MIT license permits commercial and private use with minimal restrictions, requiring only attribution and inclusion of the license notice.

Quickstart

pip install uszipcode

from uszipcode import SearchEngine

se = SearchEngine()
result = se.by_zipcode('94103')
print(result.lat, result.lng, result.population)

Verify before relying

• Whether the Census 2010 static data and IRS population data through FY 2018 / 2020 are current enough for your use case
• Whether the 42,724 zipcodes in the database include all current US postal codes or represent a snapshot
• How frequently the underlying data source (data.census.gov) is updated and whether this package will track those updates

Package facts

Evidence: uszipcode-1.0.1-py2.py3-none-any.whl

Tags

More Database packages