{"openapi":"3.1.0","info":{"title":"World Cities","version":"1.0.0","description":"World cities of 15,000+ people: lookup, search, nearby, largest, time zones, distance and comparison from GeoNames. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"World Cities: World cities of 15,000+ people: lookup, search, nearby, largest, time zones, distance and comparison from GeoNames. Use /city-lookup for a city by name and optional country, /city-search for prefix and fuzzy name search, /cities-near-point for cities near a coordinate, /largest-cities for rankings, /city-timezone for the time zone id, current UTC offset and DST flag, /country-cities-summary for a country's city totals and extremes, /city-distance for great-circle distance between two cities, and /city-compare for two cities side by side. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://world-cities.x402tookit.com"}],"paths":{"/cities-near-point":{"get":{"operationId":"cities_near_point","summary":"Nearest world cities to a latitude and longitude within a radius, with distance and compass bearing.","description":"Nearest world cities to a latitude and longitude within a radius, with distance and compass bearing.","tags":["cities","nearest","geo","radius"],"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude, -90 to 90","schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"description":"Longitude, -180 to 180","schema":{"type":"number"}},{"name":"radiusKm","in":"query","required":false,"description":"Search radius 1 to 2000 km (default 100)","schema":{"type":"integer"}},{"name":"minPopulation","in":"query","required":false,"description":"Only cities with at least this population (default 0)","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 50 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"query":{"type":["null","object"],"properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"radiusKm":{"type":["null","number"]},"minPopulation":{"type":["null","number"]}}},"cities":{"type":["array","null"],"items":{"type":"object","properties":{"geonameId":{"type":["null","number"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"admin1Code":{"type":["null","string"]},"admin1Name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"timezone":{"type":["null","string"]},"role":{"type":["null","string"]},"distanceKm":{"type":["null","number"]},"distanceMiles":{"type":["null","number"]},"bearingDeg":{"type":["null","number"]},"direction":{"type":["null","string"]}}}},"totalWithinRadius":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"Nearest: Paris 04 Hôtel-de-Ville, FR, 0.4 km NNW; 216 within 30 km.","reasons":["Distances are great-circle on a sphere of radius 6371.0088 km; the bearing is from your point to the city.","GeoNames also lists some boroughs and district seats (for example Brooklyn, Queens, Paris arrondissements) as separate places, so a city can appear next to its own parts."],"query":{"lat":48.8566,"lon":2.3522,"radiusKm":30,"minPopulation":0},"cities":[{"geonameId":3013131,"name":"Paris 04 Hôtel-de-Ville","asciiName":"Paris 04 Hotel-de-Ville","country":"FR","countryName":"France","admin1Code":"11","admin1Name":"Ile-de-France","lat":48.8601,"lon":2.3507,"population":27332,"elevationM":44,"timezone":"Europe/Paris","role":null,"distanceKm":0.4,"distanceMiles":0.3,"bearingDeg":344,"direction":"NNW"},{"geonameId":2988507,"name":"Paris","asciiName":"Paris","country":"FR","countryName":"France","admin1Code":"11","admin1Name":"Ile-de-France","lat":48.85341,"lon":2.3488,"population":2138551,"elevationM":42,"timezone":"Europe/Paris","role":"national capital","distanceKm":0.4,"distanceMiles":0.3,"bearingDeg":215,"direction":"SW"}],"totalWithinRadius":216,"truncated":true,"attribution":"City data: GeoNames (geonames.org), licensed CC BY 4.0, cities15000 snapshot 2026-10-21. Crowd-edited; populations and coordinates may be dated.","degraded":false,"notChecked":["places under about 15,000 people (a remote point may show none even with villages nearby)","travel distance or time (straight-line only)","…1 more"],"source":"GeoNames cities15000 (CC BY 4.0)","asOf":"2026-10-21T06:28:04.033Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/cities-near-point"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/cities-near-point"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/cities-near-point"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/cities-near-point"}}]}}},"/city-compare":{"get":{"operationId":"city_compare","summary":"Compare two world cities side by side: population ratio, distance, latitude, elevation and time difference now.","description":"Compare two world cities side by side: population ratio, distance, latitude, elevation and time difference now.","tags":["cities","compare","population","timezone"],"parameters":[{"name":"a","in":"query","required":true,"description":"First city, e.g. Tokyo or 'Paris, FR'","schema":{"type":"string"}},{"name":"b","in":"query","required":true,"description":"Second city, e.g. 'London, GB'","schema":{"type":"string"}},{"name":"aCountry","in":"query","required":false,"description":"Country of the first city to disambiguate","schema":{"type":"string"}},{"name":"bCountry","in":"query","required":false,"description":"Country of the second city to disambiguate","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"a":{"type":["null","object"],"properties":{"geonameId":{"type":["null","number"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"admin1Code":{"type":["null","string"]},"admin1Name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"timezone":{"type":["null","string"]},"role":{"type":["null","string"]},"utcOffsetNow":{"type":["null","string"]},"hemisphere":{"type":["null","string"]}}},"b":{"type":["null","object"],"properties":{"geonameId":{"type":["null","number"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"admin1Code":{"type":["null","string"]},"admin1Name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"timezone":{"type":["null","string"]},"role":{"type":["null","string"]},"utcOffsetNow":{"type":["null","string"]},"hemisphere":{"type":["null","string"]}}},"populationRatioAOverB":{"type":["null","number"]},"populationDifference":{"type":["null","number"]},"distanceKm":{"type":["null","number"]},"distanceMiles":{"type":["null","number"]},"latitudeDifferenceDeg":{"type":["null","number"]},"elevationDifferenceM":{"type":["null","number"]},"timeDifferenceHoursNow":{"type":["null","number"]},"aAheadOfBHours":{"type":["null","number"]},"sameCountry":{"type":["boolean","null"]},"sameTimezone":{"type":["boolean","null"]},"asOfUtc":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPARED","summary":"Tokyo (9,733,276) vs São Paulo (12,400,232): São Paulo is 1.27 times larger; 18,534 km apart; 12 hours time difference now.","reasons":[],"a":{"geonameId":1850147,"name":"Tokyo","asciiName":"Tokyo","country":"JP","countryName":"Japan","admin1Code":"40","admin1Name":"Tokyo","lat":35.6895,"lon":139.69171,"population":9733276,"elevationM":44,"timezone":"Asia/Tokyo","role":"national capital","utcOffsetNow":"+09:00","hemisphere":"northern, eastern"},"b":{"geonameId":3448439,"name":"São Paulo","asciiName":"Sao Paulo","country":"BR","countryName":"Brazil","admin1Code":"27","admin1Name":"Sao Paulo","lat":-23.5475,"lon":-46.63611,"population":12400232,"elevationM":769,"timezone":"America/Sao_Paulo","role":"first-level administrative seat","utcOffsetNow":"-03:00","hemisphere":"southern, western"},"populationRatioAOverB":0.785,"populationDifference":-2666956,"distanceKm":18533.8,"distanceMiles":11516.4,"latitudeDifferenceDeg":59.24,"elevationDifferenceM":725,"timeDifferenceHoursNow":12,"aAheadOfBHours":12,"sameCountry":false,"sameTimezone":false,"asOfUtc":"2026-10-21T06:28:04Z","attribution":"City data: GeoNames (geonames.org), licensed CC BY 4.0, cities15000 snapshot 2026-10-21. Crowd-edited; populations and coordinates may be dated.","degraded":false,"notChecked":["metro-area sizes, economy, climate or cost of living","whether the two populations are from the same year","…1 more"],"source":"GeoNames cities15000 (CC BY 4.0) + IANA tz data via Intl","asOf":"2026-10-21T06:28:04.319Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0300"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-compare"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-compare"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-compare"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-compare"}}]}}},"/city-distance":{"get":{"operationId":"city_distance","summary":"Great-circle distance in km, miles and nautical miles plus bearing between two cities, resolved by name.","description":"Great-circle distance in km, miles and nautical miles plus bearing between two cities, resolved by name.","tags":["distance","great-circle","cities","bearing"],"parameters":[{"name":"from","in":"query","required":true,"description":"Origin city, e.g. London or 'Paris, FR'","schema":{"type":"string"}},{"name":"to","in":"query","required":true,"description":"Destination city, e.g. Paris","schema":{"type":"string"}},{"name":"fromCountry","in":"query","required":false,"description":"Country of the origin to disambiguate","schema":{"type":"string"}},{"name":"toCountry","in":"query","required":false,"description":"Country of the destination to disambiguate","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"from":{"type":["null","object"],"properties":{"geonameId":{"type":["null","number"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"admin1Code":{"type":["null","string"]},"admin1Name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"timezone":{"type":["null","string"]},"role":{"type":["null","string"]}}},"to":{"type":["null","object"],"properties":{"geonameId":{"type":["null","number"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"admin1Code":{"type":["null","string"]},"admin1Name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"timezone":{"type":["null","string"]},"role":{"type":["null","string"]}}},"distanceKm":{"type":["null","number"]},"distanceMiles":{"type":["null","number"]},"distanceNauticalMiles":{"type":["null","number"]},"initialBearingDeg":{"type":["null","number"]},"direction":{"type":["null","string"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"London, GB to Paris, FR: 344 km (214 mi), initial bearing 148 degrees SSE.","reasons":["Great-circle distance on a sphere of radius 6371.0088 km; real routes are longer."],"from":{"geonameId":2643743,"name":"London","asciiName":"London","country":"GB","countryName":"United Kingdom","admin1Code":"ENG","admin1Name":"England","lat":51.50853,"lon":-0.12574,"population":8961989,"elevationM":25,"timezone":"Europe/London","role":"national capital"},"to":{"geonameId":2988507,"name":"Paris","asciiName":"Paris","country":"FR","countryName":"France","admin1Code":"11","admin1Name":"Ile-de-France","lat":48.85341,"lon":2.3488,"population":2138551,"elevationM":42,"timezone":"Europe/Paris","role":"national capital"},"distanceKm":343.8,"distanceMiles":213.6,"distanceNauticalMiles":185.6,"initialBearingDeg":148,"direction":"SSE","attribution":"City data: GeoNames (geonames.org), licensed CC BY 4.0, cities15000 snapshot 2026-10-21. Crowd-edited; populations and coordinates may be dated.","degraded":false,"notChecked":["road, rail or flight route distance (straight line over a spherical Earth)","the exact point inside each city (GeoNames uses one representative coordinate)","…1 more"],"source":"GeoNames cities15000 (CC BY 4.0)","asOf":"2026-10-21T06:28:04.582Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-distance"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-distance"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-distance"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-distance"}}]}}},"/city-lookup":{"get":{"operationId":"city_lookup","summary":"Find a world city by name and optional country; ranked by population with coordinates, time zone and elevation.","description":"Find a world city by name and optional country; ranked by population with coordinates, time zone and elevation.","tags":["cities","geonames","lookup","population"],"parameters":[{"name":"name","in":"query","required":true,"description":"City name, e.g. Paris, Sao Paulo or Saint Petersburg","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO 3166 code or country name, e.g. FR or France","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 25 (default 5)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"query":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"country":{}}},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"geonameId":{"type":["null","number"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"admin1Code":{"type":["null","string"]},"admin1Name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"timezone":{"type":["null","string"]},"role":{"type":["null","string"]}}}},"totalMatches":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND_MULTIPLE","summary":"Paris, Ile-de-France, France: population 2,138,551; 1 other place share this name.","reasons":["Several places share this name; they are ranked by population. Add a country to narrow it."],"query":{"name":"Paris","country":null},"matches":[{"geonameId":2988507,"name":"Paris","asciiName":"Paris","country":"FR","countryName":"France","admin1Code":"11","admin1Name":"Ile-de-France","lat":48.85341,"lon":2.3488,"population":2138551,"elevationM":42,"timezone":"Europe/Paris","role":"national capital"},{"geonameId":4717560,"name":"Paris","asciiName":"Paris","country":"US","countryName":"United States","admin1Code":"TX","admin1Name":"Texas","lat":33.66094,"lon":-95.55551,"population":24782,"elevationM":183,"timezone":"America/Chicago","role":null}],"totalMatches":2,"truncated":false,"attribution":"City data: GeoNames (geonames.org), licensed CC BY 4.0, cities15000 snapshot 2026-10-21. Crowd-edited; populations and coordinates may be dated.","degraded":false,"notChecked":["places under about 15,000 people (unless a capital or administrative seat)","alternate and historic names","…1 more"],"source":"GeoNames cities15000 (CC BY 4.0)","asOf":"2026-10-21T06:28:04.846Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-lookup"}}]}}},"/city-search":{"get":{"operationId":"city_search","summary":"Search world cities by name prefix, word or small misspelling; optional country and minimum population; capped at 50.","description":"Search world cities by name prefix, word or small misspelling; optional country and minimum population; capped at 50.","tags":["cities","search","autocomplete","geonames"],"parameters":[{"name":"q","in":"query","required":true,"description":"Start of a name or a misspelling, e.g. Barcel or Lodnon","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO 3166 code or country name to restrict to","schema":{"type":"string"}},{"name":"minPopulation","in":"query","required":false,"description":"Only cities with at least this population (default 0)","schema":{"type":"integer"}},{"name":"fuzzy","in":"query","required":false,"description":"true (default) adds near-miss spellings when few exact matches","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 50 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"query":{"type":["null","object"],"properties":{"q":{"type":["null","string"]},"country":{},"minPopulation":{"type":["null","number"]}}},"matches":{"type":["array","null"],"items":{"type":"object","properties":{"geonameId":{"type":["null","number"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"admin1Code":{"type":["null","string"]},"admin1Name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"timezone":{"type":["null","string"]},"role":{"type":["null","string"]},"matchScore":{"type":["null","number"]}}}},"totalMatches":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"7 name matches for \"barcel\"; best: Barcelona, ES.","reasons":["Score: 100 exact, 80 prefix, 60 word prefix, 40 contains, 30 or 20 a near-miss spelling (1 or 2 edits)."],"query":{"q":"barcel","country":null,"minPopulation":0},"matches":[{"geonameId":3128760,"name":"Barcelona","asciiName":"Barcelona","country":"ES","countryName":"Spain","admin1Code":"56","admin1Name":"Catalonia","lat":41.38879,"lon":2.15899,"population":1686208,"elevationM":15,"timezone":"Europe/Madrid","role":"first-level administrative seat","matchScore":80},{"geonameId":3648559,"name":"Barcelona","asciiName":"Barcelona","country":"VE","countryName":"Venezuela","admin1Code":"02","admin1Name":"Anzoategui","lat":10.1384,"lon":-64.68769,"population":815141,"elevationM":3,"timezone":"America/Caracas","role":"first-level administrative seat","matchScore":80}],"totalMatches":7,"truncated":true,"attribution":"City data: GeoNames (geonames.org), licensed CC BY 4.0, cities15000 snapshot 2026-10-21. Crowd-edited; populations and coordinates may be dated.","degraded":false,"notChecked":["alternate-language names (only the primary and ASCII names are searched)","places under about 15,000 people","…1 more"],"source":"GeoNames cities15000 (CC BY 4.0)","asOf":"2026-10-21T06:28:05.110Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-search"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-search"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-search"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-search"}}]}}},"/city-timezone":{"get":{"operationId":"city_timezone","summary":"Time zone id for a city with UTC offset at a moment, daylight saving flag, local time and next offset change.","description":"Time zone id for a city with UTC offset at a moment, daylight saving flag, local time and next offset change.","tags":["timezone","dst","utc-offset","cities"],"parameters":[{"name":"name","in":"query","required":true,"description":"City name, e.g. Sydney","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO 3166 code or country name to disambiguate","schema":{"type":"string"}},{"name":"at","in":"query","required":false,"description":"ISO date or date-time for the offset (default: now), e.g. 2026-07-01T12:00:00Z","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"city":{"type":["null","object"],"properties":{"geonameId":{"type":["null","number"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"admin1Code":{"type":["null","string"]},"admin1Name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"timezone":{"type":["null","string"]},"role":{}}},"timezone":{"type":["null","string"]},"atUtc":{"type":["null","string"]},"usedNow":{"type":["boolean","null"]},"localTime":{"type":["null","string"]},"utcOffset":{"type":["null","string"]},"utcOffsetMinutes":{"type":["null","number"]},"abbreviation":{"type":["null","string"]},"standardUtcOffset":{"type":["null","string"]},"isDst":{"type":["boolean","null"]},"usesDstThisYear":{"type":["boolean","null"]},"nextOffsetChange":{"type":["null","object"],"properties":{"atUtc":{"type":["null","string"]},"fromUtcOffset":{"type":["null","string"]},"toUtcOffset":{"type":["null","string"]}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"COMPUTED","summary":"New York City, US: America/New_York, UTC-04:00 (daylight saving in effect); local time 2026-07-01 08:00.","reasons":["This zone has two offsets in 2026 (-05:00 in January, -04:00 in July); the lower is treated as standard."],"city":{"geonameId":5128581,"name":"New York City","asciiName":"New York City","country":"US","countryName":"United States","admin1Code":"NY","admin1Name":"New York","lat":40.71427,"lon":-74.00597,"population":8804190,"elevationM":10,"timezone":"America/New_York","role":null},"timezone":"America/New_York","atUtc":"2026-07-01T12:00:00Z","usedNow":false,"localTime":"2026-07-01 08:00","utcOffset":"-04:00","utcOffsetMinutes":-240,"abbreviation":"EDT","standardUtcOffset":"-05:00","isDst":true,"usesDstThisYear":true,"nextOffsetChange":{"atUtc":"2026-11-01T06:00:00Z","fromUtcOffset":"-04:00","toUtcOffset":"-05:00"},"attribution":"City data: GeoNames (geonames.org), licensed CC BY 4.0, cities15000 snapshot 2026-10-21. Crowd-edited; populations and coordinates may be dated.","degraded":false,"notChecked":["legal changes to a zone made after the runtime's tz database was built","cities that sit on a zone border (the zone is GeoNames' assignment for that point)","…1 more"],"source":"GeoNames cities15000 (CC BY 4.0) + IANA tz data via Intl","asOf":"2026-10-21T06:28:05.377Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-timezone"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-timezone"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-timezone"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/city-timezone"}}]}}},"/country-cities-summary":{"get":{"operationId":"country_cities_summary","summary":"Country summary of listed cities: count, total population, largest, northernmost, southernmost, capital, time zones.","description":"Country summary of listed cities: count, total population, largest, northernmost, southernmost, capital, time zones.","tags":["cities","country","population","summary"],"parameters":[{"name":"country","in":"query","required":true,"description":"ISO 3166 code or country name, e.g. JP or Japan","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"country":{"type":["null","object"],"properties":{"code":{"type":["null","string"]},"iso3":{"type":["null","string"]},"name":{"type":["null","string"]},"continent":{"type":["null","string"]},"capitalName":{"type":["null","string"]},"population":{"type":["null","number"]}}},"cityCount":{"type":["null","number"]},"totalCityPopulation":{"type":["null","number"]},"shareOfCountryPopulationPct":{"type":["null","number"]},"largest":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]}}},"smallest":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]}}},"northernmost":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]}}},"southernmost":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]}}},"easternmost":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]}}},"westernmost":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]}}},"capital":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]}}},"timezones":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":["null","string"]},"cities":{"type":["null","number"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"SUMMARIZED","summary":"Japan: 1216 listed cities with 132,342,909 people in total; largest Tokyo (9,733,276).","reasons":["The listed cities hold about 107.3% of the country's GeoNames population (123,366,734); the rest live in smaller places or are counted differently."],"country":{"code":"JP","iso3":"JPN","name":"Japan","continent":"AS","capitalName":"Tokyo","population":123366734},"cityCount":1216,"totalCityPopulation":132342909,"shareOfCountryPopulationPct":107.3,"largest":{"name":"Tokyo","lat":35.6895,"lon":139.69171,"population":9733276},"smallest":{"name":"Sakaki","lat":36.46667,"lon":138.18333,"population":15025},"northernmost":{"name":"Wakkanai","lat":45.40944,"lon":141.67389,"population":33869},"southernmost":{"name":"Ishigaki","lat":24.34478,"lon":124.15717,"population":47637},"easternmost":{"name":"Nemuro","lat":43.32361,"lon":145.575,"population":31223},"westernmost":{"name":"Ishigaki","lat":24.34478,"lon":124.15717,"population":47637},"capital":{"name":"Tokyo","lat":35.6895,"lon":139.69171,"population":9733276},"timezones":[{"id":"Asia/Tokyo","cities":1216}],"attribution":"City data: GeoNames (geonames.org), licensed CC BY 4.0, cities15000 snapshot 2026-10-21. Crowd-edited; populations and coordinates may be dated.","degraded":false,"notChecked":["people living in places under about 15,000 (so the city total is far below the national population)","metro-area populations","…1 more"],"source":"GeoNames cities15000 (CC BY 4.0)","asOf":"2026-10-21T06:28:05.639Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/country-cities-summary"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/country-cities-summary"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/country-cities-summary"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/country-cities-summary"}}]}}},"/largest-cities":{"get":{"operationId":"largest_cities","summary":"Largest cities by population, worldwide or within one country or first-level division such as a US state.","description":"Largest cities by population, worldwide or within one country or first-level division such as a US state.","tags":["cities","population","ranking","geonames"],"parameters":[{"name":"country","in":"query","required":false,"description":"ISO 3166 code or country name (default: world)","schema":{"type":"string"}},{"name":"admin1","in":"query","required":false,"description":"First-level division code or name within the country, e.g. NY with US","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results 1 to 100 (default 10)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Rows to skip (default 0)","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"scope":{"type":["null","string"]},"citiesInScope":{"type":["null","number"]},"offset":{"type":["null","number"]},"returned":{"type":["null","number"]},"truncated":{"type":["boolean","null"]},"cities":{"type":["array","null"],"items":{"type":"object","properties":{"rank":{"type":["null","number"]},"geonameId":{"type":["null","number"]},"name":{"type":["null","string"]},"asciiName":{"type":["null","string"]},"country":{"type":["null","string"]},"countryName":{"type":["null","string"]},"admin1Code":{"type":["null","string"]},"admin1Name":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"population":{"type":["null","number"]},"elevationM":{"type":["null","number"]},"timezone":{"type":["null","string"]},"role":{"type":["null","string"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"RANKED","summary":"Largest in Brazil: São Paulo, 12,400,232; 2277 cities ranked.","reasons":["GeoNames also lists some boroughs and district seats (for example Brooklyn, Queens, Paris arrondissements) as separate places, so a city can appear next to its own parts.","Populations are GeoNames' figure for the city proper and can mix years and definitions; do not compare across countries as if they were one census."],"scope":"Brazil","citiesInScope":2277,"offset":0,"returned":5,"truncated":true,"cities":[{"rank":1,"geonameId":3448439,"name":"São Paulo","asciiName":"Sao Paulo","country":"BR","countryName":"Brazil","admin1Code":"27","admin1Name":"Sao Paulo","lat":-23.5475,"lon":-46.63611,"population":12400232,"elevationM":769,"timezone":"America/Sao_Paulo","role":"first-level administrative seat"},{"rank":2,"geonameId":3451190,"name":"Rio de Janeiro","asciiName":"Rio de Janeiro","country":"BR","countryName":"Brazil","admin1Code":"21","admin1Name":"Rio de Janeiro","lat":-22.90642,"lon":-43.18223,"population":6747815,"elevationM":12,"timezone":"America/Sao_Paulo","role":"first-level administrative seat"}],"attribution":"City data: GeoNames (geonames.org), licensed CC BY 4.0, cities15000 snapshot 2026-10-21. Crowd-edited; populations and coordinates may be dated.","degraded":false,"notChecked":["urban agglomeration or metro-area populations (figures are for the named city proper as GeoNames records it)","whether populations are current (sources and years vary)","…1 more"],"source":"GeoNames cities15000 (CC BY 4.0)","asOf":"2026-10-21T06:28:05.903Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/largest-cities"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/largest-cities"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/largest-cities"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://world-cities.x402tookit.com/largest-cities"}}]}}}}}