URANIA // v1.0.0

Geographical data,
built for engineers.

Access 250 countries, 5,000+ states, and 150,000+ cities through a strict, predictable REST API. Fast, free, and aggressively cached.

Get free API key Read documentation
~/projects/urania-demo
# Find cities within 50km of Lagos coordinates curl -X GET "https://urania.obilodev.com/api/v1/cities/nearby?lat=6.524&lng=3.379&radius=50" \ -H "X-API-Key: sk_live_your_key_here" # Response (HTTP 200 OK - 42ms) { "data": [ { "name": "Ikeja", "state_code": "LA", "country_code": "NG", "distance": "14.2 km", "coordinates": { "latitude": 6.596, "longitude": 3.342 } } // 47 more items... ] }
// Core Capabilities

Hierarchical Topology

Traverse from countries to states to cities seamlessly. Standardized ISO 3166-1 and 3166-2 codes enforced across the board.

Geospatial Context

Every city features accurate latitude/longitude. Reverse-geocode regions or find nearby cities using Haversine distance querying.

Sub-50ms Latency

Heavy payload caching and index-optimized database structures mean you never wait for data. Built for high-throughput edge environments.

Zero OAuth Dance

Authentication is a single X-API-Key header. No rotating tokens, no complex handshake protocols.

Generated SDKs

Native client libraries for TypeScript, Python, and PHP dynamically generated from our OpenAPI spec. Fully typed.

Granular Filtering

Query data by continent, currency, population threshold, or substring. Limit and paginate response sizes natively.

// Dataset Coverage
250
Countries
5,000+
States & Provinces
150k+
Cities Worldwide
100k
Free Monthly Req.

Start building now.

Deploy your integration in minutes. No credit card required.

Generate API Key