geocoded
Cloudflare Workers REST API for countries, states, cities, and IP geolocation with OpenAPI docs, field selection, and edge caching.
Problem
Most apps eventually need location data, but developers are forced into paid APIs, signup-gated free tiers, or self-hosted data dumps for basic country, city, and IP lookup workflows.
Approach
- Deployed the API on Cloudflare Workers so requests resolve close to the caller instead of a single origin.
- Used edge caching and field selection to keep common country, state, city, and IP lookups small and fast.
- Published OpenAPI documentation so developers can integrate without signing up or reverse-engineering payloads.
Outcome
Free API access without an API key for basic usage
Globally distributed on Cloudflare edge infrastructure
Structured country, state, city, timezone, currency, and IP location data
OpenAPI docs and field selection for lighter integrations
Tech
Cloudflare Workers Hono KV API