CyberMax-tools/us-zip-codes-demographics

Ziplore US ZIP Codes: city, county, coordinates, time zone and Census demographics

<!-- cybermax-bridge:start -->

Look up any ZIP code's demographics by API instead of loading the file: $5 for 12,000 calls. [Buy now →](https://data.cybermaxtools.com/buy/st-ziplore-api-pack?s=hf-us-zip-codes-demographics-top) · API key on screen the moment checkout ends · no subscription · 14-day refund if it doesn't work as described · help: cybermax.tools@gmail.com Need it fresh, filtered or via API? This free file is a snapshot (Census ACS 2020-2024 figures for every US ZIP), last updated 2026-09-24. - [Ziplore ZIP code API](https://data.cybermaxtools.com/buy/ziplore-api?s=hf-us-zip-codes-demographics) (200 free calls a day, $5 for 12,000 (no expiry), or $19/month for 60,000): looks up any ZIP by API: radius search, nearest ZIP, city to ZIPs, demographics; paid keys from a $5 pack of 12,000 calls or $19/month for 60,000 (Zipcodebase Developer: $45/month for 60,000). - [Coffermap FY2025 federal spending workbook](https://data.cybermaxtools.com/buy/coffermap?s=hf-us-zip-codes-demographics) ($15): every US county and state in one Excel file with top agencies, contractors and industries. - Using it at work? [Commercial license + support](https://data.cybermaxtools.com/buy/dataset-license?s=hf-us-zip-codes-demographics) (from $49/year): invoice, PDF licence certificate, named support, freshness and availability commitments and an SLA; the data stays free and open for everyone. - [Get an email when this dataset updates](https://data.cybermaxtools.com/notify?ds=us-zip-codes-demographics&s=hf-us-zip-codes-demographics): free, double opt-in, unsubscribe any time. - [CyberMax Store](https://cybermaxtools.com/store/?utm_source=huggingface&utm_medium=dataset&utm_campaign=us-zip-codes-demographics): every CyberMax data product, API plan and weekly brief in one place.

<!-- cybermax-bridge:end -->

<!-- cybermax-use:start -->

Use this dataset

from datasets import load_dataset

ds = load_dataset("CyberMax-tools/us-zip-codes-demographics", split="train")
df = ds.to_pandas()
print(df.shape)
df.head()

# or straight into pandas (needs huggingface_hub installed)
import pandas as pd
df = pd.read_csv("hf://datasets/CyberMax-tools/us-zip-codes-demographics/zips.csv")

Need it fresh, filtered or via API? [Ziplore ZIP code API](https://data.cybermaxtools.com/buy/ziplore-api?s=hf-use-us-zip-codes-demographics) (200 free calls a day, $5 for 12,000 (no expiry), or $19/month for 60,000). <!-- cybermax-use:end -->

<!-- cm:banner --> <!-- /cm:banner -->

A free, current replacement for the frozen ZIP data inside uszipcode (last release 2022), pyzipcode (2021) and the zipcodes npm package (2018). One row per US ZIP code (50 states, DC, Puerto Rico, the island areas and APO/FPO/DPO military ZIPs), 41,682 rows.

Empty cell = not available (no ZCTA, or the Census suppressed the estimate for a very small area).

import pandas as pd
df = pd.read_csv("https://huggingface.co/datasets/CyberMax-tools/us-zip-codes-demographics/resolve/main/zips.csv", dtype={"zip": str, "stateFips": str, "countyFips": str})
print(df[df.zip == "60614"].T)

Want radius search, nearest ZIP from coordinates, city → ZIPs, or an API for AI agents?

Ziplore on the Apify Store answers those from this same table: give it ZIP codes (or addresses containing them), "City, ST" names, coordinates or a radius, and it returns one clean JSON record per ZIP with distance in miles, nearby ZIPs, current UTC offset and the demographics above. $0.0005 per ZIP returned; unknown ZIPs are free. It also works as an MCP tool for AI agents.

<!-- cybermax-production:start -->

Use it in production

This snapshot is free. For live answers inside your app or pipeline, use the Ziplore ZIP code API: zIP lookups, radius search and demographics straight from your app.

# free tier, no key; paid plans: add -H "x-api-key: YOUR_KEY"
curl -s "https://ziplore.cybermaxtools.com/v1/zip/90210"

Plans and free tier · Docs

Licence: Attribution required for the GeoNames postal data (CC BY 4.0); Census figures are public domain. Using it at work? The Commercial License + Support adds an invoice, a licence certificate, named support and an SLA.

<!-- cybermax-production:end -->

Sources and licence

• —ZIP codes, place names, coordinates: GeoNames postal code dump, CC BY 4.0.
• —ZCTA areas: US Census Bureau 2024 Gazetteer; ZCTA-to-county: Census 2020 relationship file; demographics: American Community Survey 2020–2024 5-year estimates (table-based summary files). Public domain.
• —Time zones: timezonefinder, built on timezone-boundary-builder (by Evan Siroky) (ODbL, © OpenStreetMap contributors).

This table is published under CC BY 4.0: credit "Ziplore by CyberMax, with data from GeoNames, the US Census Bureau and OpenStreetMap contributors". ACS figures are survey estimates with margins of error; ZCTAs approximate, and are not identical to, USPS delivery areas. Made by CyberMax.

<!-- cybermax-xlinks:start -->

More free from CyberMax

• —All free CyberMax demos & datasets
• —Ziplore: US ZIP Code Lookup & Radius Search
• —Fipsbook: US Census Geographies with FIPS Codes, Centroids & Land Area (2025) <!-- cybermax-xlinks:end -->

<!-- cybermax-notebook:start -->

Quickstart notebook

Load this dataset with pandas and see real outputs in the quickstart notebook. <!-- cybermax-notebook:end -->

<!-- cybermax-web:start -->

Browse it on the web

Free, no sign-up: one page per ZIP code: https://data.cybermax-tools.workers.dev/zip/ (JSON: /api/zip/<zip>.json, free ZIP lookup widget). AI agents can query it through the remote MCP server https://data.cybermax-tools.workers.dev/mcp (no key). <!-- cybermax-web:end -->