# World Cities

World cities of 15,000+ people: lookup, search, nearby, largest, time zones, distance and comparison from GeoNames.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://world-cities.x402tookit.com/openapi.json
- x402 manifest: https://world-cities.x402tookit.com/.well-known/x402
- Catalog (free): https://world-cities.x402tookit.com/catalog
- Health (free): https://world-cities.x402tookit.com/health
- Uptime (free): https://world-cities.x402tookit.com/uptime

## Endpoints (8)

### GET /cities-near-point — $0.02
Nearest world cities to a latitude and longitude within a radius, with distance and compass bearing.
Params: lat: number, lon: number, radiusKm?: integer, minPopulation?: integer, limit?: integer
Example: https://world-cities.x402tookit.com/cities-near-point?lat=48.8566&lon=2.3522&radiusKm=30&limit=5

### GET /city-compare — $0.03
Compare two world cities side by side: population ratio, distance, latitude, elevation and time difference now.
Params: a: string, b: string, aCountry?: string, bCountry?: string
Example: https://world-cities.x402tookit.com/city-compare?a=Tokyo&b=Sao+Paulo

### GET /city-distance — $0.02
Great-circle distance in km, miles and nautical miles plus bearing between two cities, resolved by name.
Params: from: string, to: string, fromCountry?: string, toCountry?: string
Example: https://world-cities.x402tookit.com/city-distance?from=London&to=Paris&fromCountry=GB&toCountry=FR

### GET /city-lookup — $0.02
Find a world city by name and optional country; ranked by population with coordinates, time zone and elevation.
Params: name: string, country?: string, limit?: integer
Example: https://world-cities.x402tookit.com/city-lookup?name=Paris&limit=3

### GET /city-search — $0.02
Search world cities by name prefix, word or small misspelling; optional country and minimum population; capped at 50.
Params: q: string, country?: string, minPopulation?: integer, fuzzy?: string, limit?: integer
Example: https://world-cities.x402tookit.com/city-search?q=barcel&limit=5

### GET /city-timezone — $0.02
Time zone id for a city with UTC offset at a moment, daylight saving flag, local time and next offset change.
Params: name: string, country?: string, at?: string
Example: https://world-cities.x402tookit.com/city-timezone?name=New+York&country=US&at=2026-07-01T12%3A00%3A00Z

### GET /country-cities-summary — $0.02
Country summary of listed cities: count, total population, largest, northernmost, southernmost, capital, time zones.
Params: country: string
Example: https://world-cities.x402tookit.com/country-cities-summary?country=JP

### GET /largest-cities — $0.02
Largest cities by population, worldwide or within one country or first-level division such as a US state.
Params: country?: string, admin1?: string, limit?: integer, offset?: integer
Example: https://world-cities.x402tookit.com/largest-cities?country=BR&limit=5

## Terms

City data from GeoNames (geonames.org), licensed CC BY 4.0, provided as is and crowd-edited; populations and coordinates may be dated or wrong. Only places of 15,000 or more people are included. Distances are great-circle estimates; UTC offsets use the runtime's time zone database and can lag legal changes. Not for navigation, legal time or compliance decisions.