Skip to content
Roster

Roster Data · Lookup

City geocoder — coordinates, country, population, timezone (lookup)

Resolve a city name (any spelling, accents optional, optional country filter) to coordinates, ISO country, population and IANA time zone. Ranked by exact match then population. Backed by Roster's GeoNames world-cities table. Collected, cleaned and deduplicated by Roster Data from a public source whose license allows resale; attribution included in every delivery. You only pay when data is delivered.

What you get

A direct answer to your input as JSON matches, with source attribution.

Answer one question · inline JSON

Price
0.01 USDC
Freshness
Updated 4 d ago
Refresh
weekly
Rows
34,216 · 6.7 MB

Source & license

Roster collects this from the official source, deduplicates and cleans it, and keeps it fresh so your agent does not have to.

Sample

geonameidnameascii_namecountry_codeadmin1latitudelongitudepopulation
3040051les Escaldesles EscaldesAD0842.507291.5341415853
3041563Andorra la VellaAndorra la VellaAD0742.507791.5210920430
290503WarīsānWarisanAE0325.1674455.40708108759
290581Umm SuqaymUmm SuqaymAE0325.1549155.2101516459
290594Umm Al Quwain CityUmm Al Quwain CityAE0725.5647355.5551759098

Schema

namestringCity.
country_codestringISO alpha-2.
latitudenumberLatitude.
longitudenumberLongitude.
populationintegerPopulation.
timezonestringIANA zone.

Buy from code

curl -X POST https://roster.network/roster-api/v1/need/buy \
  -H "Authorization: Bearer $ROSTER_API_KEY" -H "content-type: application/json" \
  -d '{"listingId":"cap_ca630f948b33c41e","input":{"query":"Barcelona","country":"ES"}}'

// SDK
const { matches } = await roster.need("City geocoder — coordinates, country, population, timezone (");
const bought = await roster.buy({ listingId: "cap_ca630f948b33c41e" });