---
id: pyzipcode
version: "3.0.1"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# pyzipcode — query zip codes and location data

License: permissive · Maintenance: abandoned · Downloads: 289.8K/mo

## What it is and what it does

pyzipcode wraps a local SQLite database of US ZIP codes to provide fast, offline lookups of postal code metadata. It loads city, state, latitude, longitude, timezone, and daylight savings time information for any ZIP code, and supports search by city name and radius-based filtering around a given ZIP code.

The package exposes a dictionary-like ZipCodeDatabase interface: you can look up a ZIP code by integer or string, search for all codes in a city using SQL wildcards, or find codes within a specified radius. It requires no external API calls or network access, making it suitable for applications that need reliable ZIP code data without external dependencies.

Use it for:

- Validate and enrich user-submitted ZIP codes with city/state information in web forms or data pipelines
- Find nearby ZIP codes for location-based features like store locators or delivery radius calculations
- Populate timezone and daylight savings time data for scheduling or time-aware applications
- Offline geocoding: convert ZIP codes to approximate latitude/longitude for mapping or distance calculations
- Bulk lookup of ZIP code metadata in batch processing without rate limits or API costs

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides local lookup of US ZIP code information including city, state, coordinates, timezone, and daylight savings time, with search and radius-based filtering.

No. The package is abandoned (last update 2021-03-03), has high install friction (source-only distribution), and relies on a ZIP code database from 2004 that is now significantly outdated. For current applications, use a maintained alternative or a live API service that reflects current postal code assignments.

## Install

pip install pyzipcode
uv add pyzipcode
poetry add pyzipcode

## Installing pyzipcode

Before you install: High install friction: the package ships as a source distribution only and requires compilation or build steps. Maintenance is abandoned—last release was 2021-03-03, over 1990 days ago, with no recent commits.

License in practice: MIT license is permissive and imposes no significant restrictions on use, modification, or redistribution.

Quickstart:

from pyzipcode import ZipCodeDatabase
zcdb = ZipCodeDatabase()
result = zcdb[54115]
print(result.city, result.state, result.latitude, result.longitude)

Requires Python 3.6+; source distribution may require a C compiler or build tools to install.

Verify before relying:

- Whether the embedded ZIP code database (from 2004) remains accurate for current US postal codes
- Whether the package builds cleanly on modern Python versions despite abandonment
- Performance characteristics when searching or filtering large result sets

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: high
- Maintenance: abandoned
- Downloads: 289.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

zip code lookup, US postal code database, city state from zip, coordinates from zip code, zip code search by city, nearby zip codes radius, timezone from zip code, geocoding, offline-data, abandoned

[View on SkillFed](https://skillfed.io/packages/pyzipcode) · [View on PyPI](https://pypi.org/project/pyzipcode/)