# 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/{slug1}-vs-{slug2}/` — Country postal comparison (e.g. `/compare/united-states-vs-japan/`)
- `/glossary/` — Postal terminology glossary (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term detail (e.g. `/glossary/zip-code/`)
- `/tools/` — Interactive tools (e.g. `/tools/`)
- `/tool/{slug}/` — Tool detail (e.g. `/tool/zip-lookup/`)
- `/stories/` — In-depth stories (e.g. `/stories/`)
- `/series/{slug}/` — Story series (e.g. `/series/postal-history/`)
- `/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/`)
- `/search/` — Search postal codes, countries (e.g. `/search/?q=10001`)

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

## 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

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