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 25 h ago
Refresh: weekly
Rows: 34,153 · 6.7 MB

Source & license

GeoNames · CC-BY-4.0
Source: GeoNames (geonames.org), CC BY 4.0.

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

Sample

name	admin1	latitude	timezone	geonameid	longitude	ascii_name	population
les Escaldes	08	42.50729	Europe/Andorra	3040051	1.53414	les Escaldes	15853
Andorra la Vella	07	42.50779	Europe/Andorra	3041563	1.52109	Andorra la Vella	20430
Warīsān	03	25.16744	Asia/Dubai	290503	55.40708	Warisan	108759
Umm Suqaym	03	25.15491	Asia/Dubai	290581	55.21015	Umm Suqaym	16459
Umm Al Quwain City	07	25.56473	Asia/Dubai	290594	55.55517	Umm Al Quwain City	59098

Schema

name	string	City.
country_code	string	ISO alpha-2.
latitude	number	Latitude.
longitude	number	Longitude.
population	integer	Population.
timezone	string	IANA 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" });