Search all places
Search the full GeoNames gazetteer — ~12M features worldwide (cities, towns, mountains, rivers, regions and more), ordered by population. Filter by name (`q`), `country`, and feature `class`. Also: `GET /places/{geonameId}` for one place and `GET /places/near?lat=&lng=` for the nearest features to a coordinate.
Search the full GeoNames gazetteer — ~12M features worldwide (cities,
towns, mountains, rivers, regions and more), ordered by population.
Filter by name (q), country, and feature class. Also:
GET /places/{geonameId} for one place and
GET /places/near?lat=&lng= for the nearest features to a coordinate.
Query Parameters
Match places whose name contains this text (accent/punctuation-insensitive).
ISO 3166-1 alpha-2 country code.
GeoNames feature class: A (admin), P (populated place), H (water), T (terrain), L (area), S (spot), R (road), V (vegetation), U (undersea).
Max results (1–100, default 20).
Response Body
application/json
text/plain
curl -X GET "https://example.com/places?q=kilimanjaro&country=TZ&class=T&limit=20"[ { "geonameId": 149232, "name": "Kilimanjaro", "asciiName": "Kilimanjaro", "featureClass": "T", "featureCode": "MT", "countryCode": "TZ", "admin1Code": "string", "latitude": -3.07583, "longitude": 37.35333, "population": 0, "timezone": "Africa/Dar_es_Salaam" }]"Country not found"Search cities GET
Search the world's cities (~34k populated places over 15k people, plus capitals, from GeoNames), ordered by population. Filter by name (`q`) and/or country. Also available: `GET /cities/{geonameId}` for one city, and `GET /cities/near?lat=&lng=` for the nearest cities to a coordinate.
Look up a postal code GET
Resolve a postal/ZIP code to its place name, administrative regions, and coordinates. Covers ~100 countries (GeoNames). Coordinates are approximate and a few countries have reduced precision.