geocoded
Open-source geography data API on Cloudflare Workers and D1 for countries, states, cities, IP lookup, timezones, currencies, languages, transport data, and country statistics.
Problem
Most apps eventually need geography data, but developers are forced into paid APIs, signup-gated free tiers, scattered public datasets, or self-hosted dumps for basic location, transport, and country-statistics workflows.
Approach
- Split the product into an apps/packages monorepo with a Cloudflare Worker API, Astro documentation site, and shared TypeScript client.
- Built v2 root collections with whitelisted filters, search, sorting, pagination, field projection, and explicit expansions.
- Backed public reads with D1, immutable edge caching, and separate OpenAPI and Postman documents for versioned API surfaces.
Outcome
No-key public API for 252 countries, 5,000+ subdivisions, 232K+ cities, timezones, currencies, and languages
Root collections for countries, states, cities, airports, airlines, ports, border crossings, statistics, and migrant stocks
Interactive docs, dashboard, explorer, quiz, and reusable TypeScript client package
Cloudflare edge delivery with D1 and aggressive cache headers for public reference-data reads
Tech
Cloudflare Workers Hono D1 Astro API