# ZipFYI

> Comprehensive ZIP code and postal code reference for developers, logistics professionals, and data analysts. Covers postal codes worldwide with geographic data, country postal systems, state/province breakdowns, statistics, interactive tools, glossary, and in-depth stories. 15 languages supported.

## Data Scope
- Postal codes with latitude, longitude, city, state, and county data
- Countries with postal system format, regex patterns, and statistics
- States/provinces with postal code ranges and density
- Cities with postal code listings
- Postal code statistics — distribution, density, population coverage
- Country comparisons of postal systems
- Interactive tools for postal code lookup, validation, distance
- Postal terminology glossary
- In-depth stories on postal systems organized by series

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/countries/` — Browse countries with postal data (e.g. `/countries/`)
- `/country/{slug}/` — Country postal system detail (e.g. `/country/united-states/`)
- `/statistics/` — Postal code statistics overview (e.g. `/statistics/`)
- `/zip/{code}/` — US ZIP code detail (e.g. `/zip/10001/`)
- `/compare/{zip1}-vs-{zip2}/` — ZIP code comparison (e.g. `/compare/10001-vs-90210/`)
- `/glossary/` — Postal terminology glossary (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term detail (e.g. `/glossary/zip-code/`)
- `/tools/` — Interactive tools (e.g. `/tools/`)
- `/tools/{slug}/` — Tool detail (e.g. `/tools/reverse-zip-lookup/`)
- `/stories/` — In-depth stories (e.g. `/stories/`)
- `/series/{slug}/` — Story series (e.g. `/series/zip-code-101/`)
- `/story/{slug}/` — Story detail (e.g. `/story/history-of-zip-codes/`)
- `/nearby/` — ZIP codes near me hub (e.g. `/nearby/`)
- `/nearby/{city-slug}/` — ZIP codes near a specific city (e.g. `/nearby/new-york/`)

## Postal Codes
- [Countries](https://zipfyi.com/countries/)
- [Statistics](https://zipfyi.com/statistics/)
- [ZIP Comparisons](https://zipfyi.com/compare/10001-vs-90210/)

## Tools & Reference
- [Interactive Tools](https://zipfyi.com/tools/)
- [Glossary](https://zipfyi.com/glossary/)
- [Stories](https://zipfyi.com/stories/)

## Nearby ZIP Codes
- [ZIP Codes Near Me](https://zipfyi.com/nearby/)

## Embed Widget
- [ZipFYI Widget Docs](https://widget.zipfyi.com)
- [zipfyi-embed on npm](https://www.npmjs.com/package/zipfyi-embed)
- [zipfyi-embed on GitHub](https://github.com/fyipedia/zipfyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/countries/` | Countries with postal systems |
| GET | `/api/v1/countries/{slug}/` | Country detail |
| GET | `/api/v1/states/` | States/provinces |
| GET | `/api/v1/cities/` | Cities |
| GET | `/api/v1/postal-codes/` | Postal codes |
| GET | `/api/v1/postal-codes/{code}/` | Postal code detail |
| GET | `/api/v1/glossary/` | Glossary terms |
| GET | `/api/v1/blog-series/` | Story series |
| GET | `/api/v1/blog-posts/` | Story articles |
| GET | `/api/v1/faqs/` | FAQs |
| GET | `/api/v1/stats/` | Site statistics |
| GET | `/api/v1/search/?q={query}` | Search across all content |

```bash
curl -s "https://zipfyi.com/api/v1/countries/"
```

[API Docs](https://zipfyi.com/developers/) · [OpenAPI Spec](https://zipfyi.com/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install zipfyi` — [zipfyi](https://pypi.org/project/zipfyi/) — ZIP and postal codes geocoding API client
- **Embed Widget**: [zipfyi-embed](https://widget.zipfyi.com)

## Geo FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [DistanceFYI](https://distancefyi.com) — Haversine distance, travel times, city pairs
- [MountainFYI](https://mountainfyi.com) — Mountains, peaks, elevation, climbing routes
- [QuakeFYI](https://quakefyi.com) — Earthquakes, seismic data, tectonic plates

## Countries
- [Australia](https://zipfyi.com/country/australia/)
- [Brazil](https://zipfyi.com/country/brazil/)
- [Canada](https://zipfyi.com/country/canada/)
- [France](https://zipfyi.com/country/france/)
- [Germany](https://zipfyi.com/country/germany/)
- [India](https://zipfyi.com/country/india/)
- [Japan](https://zipfyi.com/country/japan/)
- [Mexico](https://zipfyi.com/country/mexico/)
- [South Korea](https://zipfyi.com/country/south-korea/)
- [United Kingdom](https://zipfyi.com/country/united-kingdom/)
- [United States](https://zipfyi.com/country/united-states/)

## Glossary
- [ZIP Code](https://zipfyi.com/glossary/zip-code/)
- [Postal Code](https://zipfyi.com/glossary/postal-code/)
- [ZIP+4 Code](https://zipfyi.com/glossary/zip-plus-4/)
- [Postcode](https://zipfyi.com/glossary/postcode/)
- [PIN Code](https://zipfyi.com/glossary/pin-code/)
- [PLZ](https://zipfyi.com/glossary/plz/)
- [Eircode](https://zipfyi.com/glossary/eircode/)
- [Forward Sortation Area](https://zipfyi.com/glossary/forward-sortation-area/)
- [ZIP Code Tabulation Area](https://zipfyi.com/glossary/zcta/)
- [Unique ZIP Code](https://zipfyi.com/glossary/unique-zip-code/)
- [PO Box ZIP Code](https://zipfyi.com/glossary/po-box-zip-code/)
- [Military ZIP Code](https://zipfyi.com/glossary/military-zip-code/)
- [Standard ZIP Code](https://zipfyi.com/glossary/standard-zip-code/)
- [Street Address](https://zipfyi.com/glossary/street-address/)
- [PO Box](https://zipfyi.com/glossary/po-box/)
- [Rural Route](https://zipfyi.com/glossary/rural-route/)
- [Suite/Unit Number](https://zipfyi.com/glossary/suite-unit-number/)
- [Attention Line](https://zipfyi.com/glossary/attention-line/)
- [City/Municipality](https://zipfyi.com/glossary/city-municipality/)
- [State/Province Code](https://zipfyi.com/glossary/state-province-code/)
- [County](https://zipfyi.com/glossary/county/)
- [Delivery Point](https://zipfyi.com/glossary/delivery-point/)
- [DPID](https://zipfyi.com/glossary/dpid/)
- [CASS Certification](https://zipfyi.com/glossary/cass/)
- [Last Line](https://zipfyi.com/glossary/last-line/)
- [FIPS Code](https://zipfyi.com/glossary/fips-code/)
- [Core-Based Statistical Area](https://zipfyi.com/glossary/cbsa/)
- [Metropolitan Statistical Area](https://zipfyi.com/glossary/msa/)
- [Census Tract](https://zipfyi.com/glossary/census-tract/)
- [Census Block Group](https://zipfyi.com/glossary/census-block-group/)
- [Census Block](https://zipfyi.com/glossary/census-block/)
- [County Subdivision](https://zipfyi.com/glossary/county-subdivision/)
- [Congressional District](https://zipfyi.com/glossary/congressional-district/)
- [School District](https://zipfyi.com/glossary/school-district/)
- [Urban Area](https://zipfyi.com/glossary/urban-area/)
- [Urbanized Area](https://zipfyi.com/glossary/urbanized-area/)
- [Urban Cluster](https://zipfyi.com/glossary/urban-cluster/)
- [Census Designated Place](https://zipfyi.com/glossary/census-designated-place/)
- [Sectional Center Facility](https://zipfyi.com/glossary/sectional-center-facility/)
- [Network Distribution Center](https://zipfyi.com/glossary/network-distribution-center/)
- [Area Distribution Center](https://zipfyi.com/glossary/area-distribution-center/)
- [Carrier Route](https://zipfyi.com/glossary/carrier-route/)
- [Delivery Point Barcode](https://zipfyi.com/glossary/delivery-point-barcode/)
- [Intelligent Mail Barcode](https://zipfyi.com/glossary/intelligent-mail-barcode/)
- [Certified Mail](https://zipfyi.com/glossary/certified-mail/)
- [Priority Mail](https://zipfyi.com/glossary/priority-mail/)
- [Bulk Mail](https://zipfyi.com/glossary/bulk-mail/)
- [Last Mile Delivery](https://zipfyi.com/glossary/last-mile-delivery/)
- [Mail Processing Equipment](https://zipfyi.com/glossary/mail-processing-equipment/)
- [Parcel Select](https://zipfyi.com/glossary/parcel-select/)
- [Population Density](https://zipfyi.com/glossary/population-density/)
- [Median Household Income](https://zipfyi.com/glossary/median-household-income/)
- [Median Home Value](https://zipfyi.com/glossary/median-home-value/)
- [Per Capita Income](https://zipfyi.com/glossary/per-capita-income/)
- [Housing Units](https://zipfyi.com/glossary/housing-units/)
- [Owner-Occupied Housing](https://zipfyi.com/glossary/owner-occupied-housing/)
- [Renter-Occupied Housing](https://zipfyi.com/glossary/renter-occupied-housing/)
- [Poverty Rate](https://zipfyi.com/glossary/poverty-rate/)
- [Land Area](https://zipfyi.com/glossary/land-area/)
- [Water Area](https://zipfyi.com/glossary/water-area/)
- [Commute Time](https://zipfyi.com/glossary/commute-time/)
- [Educational Attainment](https://zipfyi.com/glossary/educational-attainment/)
- [Age Distribution](https://zipfyi.com/glossary/age-distribution/)
- [Geocoding](https://zipfyi.com/glossary/geocoding/)
- [Reverse Geocoding](https://zipfyi.com/glossary/reverse-geocoding/)
- [USPS Web Tools API](https://zipfyi.com/glossary/usps-web-tools-api/)
- [Address Standardization](https://zipfyi.com/glossary/address-standardization/)
- [DPV](https://zipfyi.com/glossary/dpv/)
- [LACSLink](https://zipfyi.com/glossary/lacslink/)
- [SuiteLink](https://zipfyi.com/glossary/suitelink/)
- [eLOT](https://zipfyi.com/glossary/elot/)
- [PostalOne!](https://zipfyi.com/glossary/postalone/)
- [NCOA](https://zipfyi.com/glossary/ncoa/)
- [ACS (Address Change Service)](https://zipfyi.com/glossary/acs/)
- [CASS Certification Process](https://zipfyi.com/glossary/cass-certification-process/)

## Stories
- [What Is a ZIP Code?](https://zipfyi.com/story/what-is-a-zip-code/)
- [ZIP+4: The Extended ZIP Code Explained](https://zipfyi.com/story/zip-plus-4-explained/)
- [A Brief History of ZIP Codes](https://zipfyi.com/story/history-of-zip-codes/)
- [How USPS Sorts Mail by ZIP Code](https://zipfyi.com/story/how-usps-sorts-mail/)
- [ZIP Code Types: Standard, PO Box, Unique, and Military](https://zipfyi.com/story/zip-code-types/)
- [Reading a ZIP Code: What Each Digit Tells You](https://zipfyi.com/story/reading-a-zip-code/)
- [ZIP Codes vs. ZCTAs: Understanding the Difference](https://zipfyi.com/story/zip-codes-vs-zctas/)
- [How ZIP Codes Are Assigned and Changed](https://zipfyi.com/story/how-zip-codes-are-assigned/)
- [UK Postcodes: The Alphanumeric System Explained](https://zipfyi.com/story/uk-postcodes-explained/)
- [Canada's Postal Code System: FSA and LDU](https://zipfyi.com/story/canada-postal-codes/)
- [Japan's 7-Digit Postal Code System](https://zipfyi.com/story/japan-postal-codes/)
- [India's PIN Code: 6 Digits Serving 1.4 Billion People](https://zipfyi.com/story/india-pin-codes/)
- [Germany's PLZ: Postleitzahl from 1941 to Today](https://zipfyi.com/story/germany-plz-system/)
- [Comparing Postal Code Formats Around the World](https://zipfyi.com/story/comparing-postal-formats/)
- [How E-Commerce Reshaped Postal Codes](https://zipfyi.com/story/ecommerce-and-postal-codes/)
- [Eircode: Ireland's Unique Per-Address Postal Code](https://zipfyi.com/story/ireland-eircode/)
- [Census Data and ZIP Codes: What You Can Learn](https://zipfyi.com/story/census-data-and-zip-codes/)
- [Income Inequality by ZIP Code](https://zipfyi.com/story/income-inequality-by-zip/)
- [Population Density: Urban, Suburban, and Rural ZIPs](https://zipfyi.com/story/population-density-by-zip/)
- [Housing Data by ZIP Code: Owners, Renters, and Values](https://zipfyi.com/story/housing-data-by-zip/)
- [Education Levels by ZIP Code](https://zipfyi.com/story/education-by-zip/)
- [Commute Patterns and Transportation by ZIP Code](https://zipfyi.com/story/commute-patterns-by-zip/)
- [Age Distribution Across ZIP Codes](https://zipfyi.com/story/age-distribution-by-zip/)
- [Poverty Rates and Economic Hardship by ZIP Code](https://zipfyi.com/story/poverty-rates-by-zip/)
- [ZCTA Boundaries: How the Census Maps ZIP Codes](https://zipfyi.com/story/zcta-boundaries-explained/)
- [Time Zones and ZIP Codes](https://zipfyi.com/story/time-zones-and-zip-codes/)
- [Congressional Districts and ZIP Codes](https://zipfyi.com/story/congressional-districts-and-zips/)
- [Urban, Suburban, and Rural: Classifying ZIP Codes](https://zipfyi.com/story/urban-suburban-rural-zips/)
- [Geocoding ZIP Codes: From Code to Coordinates](https://zipfyi.com/story/geocoding-zip-codes/)
- [Counties, FIPS Codes, and ZIP Codes](https://zipfyi.com/story/counties-fips-and-zips/)
- [MSAs and CBSAs: Metro Area Definitions](https://zipfyi.com/story/msas-and-cbsas/)
- [How ZIP Code Boundaries Cross State Lines](https://zipfyi.com/story/zip-codes-crossing-state-lines/)
- [Shipping Zones: How Carriers Price by ZIP Code](https://zipfyi.com/story/shipping-zones-explained/)
- [Sales Tax Lookup by ZIP Code](https://zipfyi.com/story/sales-tax-by-zip-code/)
- [Direct Mail Marketing and ZIP Code Targeting](https://zipfyi.com/story/direct-mail-zip-targeting/)
- [The USPS Network: From Local to National](https://zipfyi.com/story/usps-network-infrastructure/)
- [Insurance Rating by ZIP Code](https://zipfyi.com/story/insurance-rating-by-zip/)
- [Real Estate and ZIP Code Valuation](https://zipfyi.com/story/real-estate-and-zip-codes/)
- [ZIP Code Data for Market Research](https://zipfyi.com/story/zip-code-market-research/)
- [Bulk Mail and Postal Discounts by ZIP](https://zipfyi.com/story/bulk-mail-postal-discounts/)
- [What Is CASS Certification?](https://zipfyi.com/story/what-is-cass-certification/)
- [NCOA: Processing Address Changes at Scale](https://zipfyi.com/story/ncoa-address-changes/)
- [Address Standardization: USPS Rules and Best Practices](https://zipfyi.com/story/address-standardization-guide/)
- [Geocoding Accuracy: From Rooftop to ZIP Centroid](https://zipfyi.com/story/geocoding-accuracy-levels/)
- [DPV: Confirming an Address Actually Exists](https://zipfyi.com/story/dpv-delivery-point-validation/)
- [Address Validation for E-Commerce Checkout](https://zipfyi.com/story/address-validation-ecommerce/)
- [eLOT: Enhanced Line of Travel Sequencing](https://zipfyi.com/story/elot-line-of-travel/)
- [Building an Address Quality Program](https://zipfyi.com/story/address-quality-program/)
- [Famous ZIP Codes: From 90210 to 10001](https://zipfyi.com/story/famous-zip-codes/)
- [Mr. ZIP: The Mascot That Sold a Nation on Postal Codes](https://zipfyi.com/story/mr-zip-mascot-history/)
- [Military ZIP Codes: Mail Across Oceans](https://zipfyi.com/story/military-zip-codes/)
- [The Strangest ZIP Codes in America](https://zipfyi.com/story/strangest-zip-codes/)
- [How Other Countries Invented Postal Codes](https://zipfyi.com/story/invention-of-postal-codes/)
- [ZIP Codes and Privacy: What Your Code Reveals](https://zipfyi.com/story/zip-codes-and-privacy/)
- [The Future of Postal Addressing](https://zipfyi.com/story/future-of-postal-addressing/)

## Full Index
- [XML Sitemap](https://zipfyi.com/sitemap.xml)