URANIA ENGINE // v1.0.0

Global geo data,
built for engineers.

Access 250 countries, 5,000+ states, and 150,000+ cities through a predictable REST API. Built with in-memory caching, spatial distance indexing, and typed SDKs.

Get free API key API Reference
100k free req/mo
No credit card required
Sub-50ms responses
GET /api/v1/cities/nearby
# Query cities within 50km of coordinates (Haversine formula)
curl -X GET "https://urania.obilodev.com/api/v1/cities/nearby?lat=6.5244&lng=3.3792&radius=50" \
-H "X-API-Key: sk_live_demo994827" \
-H "Accept: application/json"
# Response (HTTP 200 OK — 28ms)
{ "data": [ { "id": 14502, "name": "Ikeja", "stateId": 90, "countryId": 160, "lat": 6.6059, "lng": 3.3491, "distance_km": 9.65 }, // ... 47 more cities within radius ], "meta": { "timestamp": "2026-09-22T17:00:00Z", "record_count": 48 } }
// Technical Capabilities

Designed for performance, predictability, and scale.

Normalized Relational Hierarchy

Traverse seamlessly from Country → State → City. Strictly mapped to ISO 3166-1 (alpha-2, alpha-3) and ISO 3166-2 administrative standards.

Spatial Distance Engine

Run millisecond-fast nearby city lookups with custom radius limits using high-precision Haversine math and B-Tree geospatial coordinates.

Sub-50ms Response Latency

Payload responses are backed by atomic ETag validation and in-memory caches. Serve repeat requests instantly without hitting cold disk reads.

Simple Key-Based Auth

Authentication requires a single header: X-API-Key: sk_.... No complex OAuth handshakes or token refresh routines required.

Generated Client SDKs

Pre-packaged SDKs for TypeScript/JavaScript, Python, and PHP automatically synced to our OpenAPI 3.0 specification. Full type definitions included.

Filtering, Sorting & Autocomplete

Filter by region, continent, currency, or prefix. Autocomplete endpoints provide instant typeahead suggestions for search bars and address forms.

// Dataset Provenance & Coverage
250
Sovereign Nations & Territories
Currencies, flags, borders, languages
5,000+
States & Provinces
ISO 3166-2 divisions, capitals, codes
150k+
Cities & Municipalities
Populations > 5,000 with coordinates
100k
Free Monthly Requests
Generous quota for developers & founders
// Quick Integration

Drop into any stack in seconds.

Whether you're building checkout shipping forms, weather widgets, user onboarding, or location services—Urania provides clean JSON payloads without proprietary locks.

OpenAPI 3.0 compliant
99.9% Production uptime
CORS enabled out of the box
cURL TypeScript Python PHP 
# Fetch all states in Nigeria by ISO code
curl -H "X-API-Key: YOUR_KEY" \
  "https://urania.obilodev.com/api/v1/countries/NG/states"

Start building with Urania today.

Get your production API key in 30 seconds. Free forever for developers, creators, and founders.

Generate Free API Key Explore Documentation