Geomelon provides a free city autocomplete API built on pre-generated static JSON files. No API key required.

Live demo

Loading demo…
Last: — ms  ·  Avg: — ms

How it works

Each request resolves to a pre-built static JSON file. The URL encodes the country, search language, and typed prefix:

GET https://oneshot.geomelon.dev/{country}/{lang}/{prefix}
Parameter Description
country ISO 3166-1 alpha-2 country code, lowercase
lang BCP 47 language code — drives both the search index and the returned name
prefix What the user has typed (strip . and ' before sending)

Response

[
  { "id": "uuid", "name": "Paris", "population": 2161000, "emoji": "🇫🇷" },
  { "id": "uuid", "name": "Parthenay", "population": 10537, "emoji": "🇫🇷", "en": "Parthenay" }
]

Up to 10 cities, sorted by population descending. The en field is included when the search language is not English and an English translation exists — useful as a subtitle or tooltip.

Notes

  • Dots and apostrophes in the prefix are handled server-side — "st." finds St. John’s, "l'" finds L’Aquila
  • Responses include Access-Control-Allow-Origin: * — safe to call directly from browser JavaScript
  • If a (country, language) pair is not in the table below, fall back to en
  • A 404 means no cities match that prefix in that country/language

Also available via the main API

The same city data is accessible via the full Geomelon API on RapidAPI with filtering by population, pagination, coordinate search, and region data. The free endpoint is a fast shortcut for typing-based city lookup scoped to a known country.

Coverage

203 countries · 50 languages · 2,497 country–language pairs

Hover a language tag to see the full name.

CountryISOLanguages
🇦🇫 Afghanistan af arbnenfafrnlptrusvuz
🇦🇱 Albania al bgdeelenesfrhuitnlplrusqsrsvtruz
🇩🇿 Algeria dz arenfafrnlpt
🇦🇩 Andorra ad en
🇦🇴 Angola ao ennl
🇦🇬 Antigua and Barbuda ag en
🇦🇷 Argentina ar arbncacsdadeeleneseufafifrglhehuhyiditjakakoltmsnbnlplptruskslsvtrukuzvizh
🇦🇲 Armenia am arazbgcadeelenesfafrhyitkamsnlplrusvtrukuzvizh
🇦🇼 Aruba aw en
🇦🇺 Australia au arcacsdadeeleneseteufafifrhehihuhyiditjakakoltlvmsnbnlplptroruslsvtrukvizh
🇦🇹 Austria at arbgcacsdadeeleneseteufafifrhehrhuhyiditjakkkoltnbnlplptroruskslsrsvtrukuzvizh
🇦🇿 Azerbaijan az arazcadeelenesfafrhyiditjakamsnlplrusvtrukuzvizh
🇧🇭 Bahrain bh en
🇧🇩 Bangladesh bd bnenfafrmsnlrusvuz
🇧🇧 Barbados bb en
🇧🇾 Belarus by bgcsdeenesetfifrglheitltlvnlplruslsrsvukzh
🇧🇪 Belgium be afbgcacsdadeeneseteufafifrhehuiditjaltnbnlplptroruskslsvtrukvizh
🇧🇿 Belize bz en
🇧🇯 Benin bj enfrnl
🇧🇹 Bhutan bt enfanl
🇧🇴 Bolivia bo deenesfafritnlplptsvzh
🇧🇦 Bosnia and Herzegovina ba arbgcacsdadeeleneseufafifrhrhuhyiditjaltnbnlplptroruskslsqsrsvtrukuzzh
🇧🇼 Botswana bw enfritnlplptsvuz
🇧🇷 Brazil br arbgbncacsdadeeleneseufafifrglhehihuhyiditjakakkkoltlvmsnbnlplptrorusrsvthtrukuzvizh
🇧🇳 Brunei bn enidms
🇧🇬 Bulgaria bg arbgcacsdeelenesfafrhehuhyitjakakkltmsnlplptroruskslsrsvtrukuzvizh
🇧🇫 Burkina Faso bf bgdeenesfafritjanlsvuz
🇧🇮 Burundi bi enfr
🇰🇭 Cambodia kh en
🇨🇲 Cameroon cm deenesfritnlsv
🇨🇦 Canada ca afarbgbncacsdadeeleneseteufafifrglhehihuhyiditjakoltlvmsnbnlplptroruskslsqsrsvthtrukvizh
🇨🇻 Cape Verde cv caenesfrnlpt
🇨🇫 Central African Republic cf ennl
🇹🇩 Chad td enfritnlru
🇨🇱 Chile cl arcadeeneseufafritjakoltnlplptrorusvtrukzh
🇨🇳 China cn afarbgbncacsdadeeleneseteufafifrhehihuhyiditjakakkkoltlvmnmsnbnlplptruslsrsvthtrukvizh
🇨🇴 Colombia co enesnlsv
🇰🇲 Comoros km enfrnlsv
🇨🇰 Cook Islands ck en
🇨🇷 Costa Rica cr en
🇭🇷 Croatia hr cacsdadeenesfafrhrhuitjanlplroruslsqsrsvtrukzh
🇨🇺 Cuba cu cadeenesfafritjakanlptrusvuzvizh
🇨🇼 Curaçao cw en
🇨🇾 Cyprus cy bgdeelenfafrhyitnlplsvtr
🇨🇿 Czech Republic cz arbgcacsdadeeleneseteufafifrhehrhuhyiditjakakoltlvmsnbnlplptroruskslsrsvtrukuzvizh
🇨🇩 DR Congo cd deenesfritjanlplrorusvzh
🇩🇰 Denmark dk afbgcacsdadeenesfafifrhehuitjanbnlplptroruslsvtruzzh
🇩🇯 Djibouti dj en
🇩🇲 Dominica dm en
🇩🇴 Dominican Republic do enesnlsv
🇪🇨 Ecuador ec cadeenesfrglitnlplptsv
🇪🇬 Egypt eg ardeelenesfafrheitjanlplrusvukuz
🇸🇻 El Salvador sv en
🇬🇶 Equatorial Guinea gq en
🇪🇷 Eritrea er en
🇪🇪 Estonia ee arbgcacsdadeenesetfafifrhuhyitjanbnlplrusvtrukuzzh
🇸🇿 Eswatini sz en
🇪🇹 Ethiopia et deenfritnlplrusvzh
🇫🇯 Fiji fj en
🇫🇮 Finland fi cacsdadeeneseteufafifrglitjanbnlplroruslsqsvtrukuzzh
🇫🇷 France fr afarbgcacsdadeeleneseteufafifrglhehrhuhyiditjakkkoltlvmsnbnlplptroruskslsqsrsvtrukuzvizh
🇬🇦 Gabon ga en
🇬🇪 Georgia ge azcsdeenesfafrhehykanlplrutrukuz
🇩🇪 Germany de afarazbgcacsdadeeleneseteufafifrglhehrhuhyiditjakakkkoltlvmsnbnlplptroruskslsqsrsvthtrukuzvizh
🇬🇭 Ghana gh deenesfrjanlplsvtr
🇬🇷 Greece gr arbgcacsdadeelenesfafifrhehuhyiditjakoltnbnlplptroruskslsqsrsvtrukvizh
🇬🇩 Grenada gd deen
🇬🇹 Guatemala gt enesnlsv
🇬🇳 Guinea gn enesfritmsnl
🇬🇼 Guinea-Bissau gw en
🇬🇾 Guyana gy ennl
🇭🇹 Haiti ht en
🇭🇳 Honduras hn enessv
🇭🇺 Hungary hu arazbgcacsdadeeneseteufafifrhehrhuhyitjakomsnbnlplptroruskslsrsvtrukuzvizh
🇮🇸 Iceland is deenfrnlplpt
🇮🇳 India in arazbgbncacsdadeeleneseufafifrglhehihuhyiditjakakoltlvmsnbnlplptroruslsrsvthtrukuzvizh
🇮🇩 Indonesia id afarbncacsdadeeleneseteufafifrglhihrhuiditjakoltlvmsnbnlplptroruskslsvthtrukvizh
🇮🇷 Iran ir arazbgbncadadeelenesfafifrhehihuhyiditjakoltmsnbnlplptroruslsvthtrukuzvizh
🇮🇶 Iraq iq ardeenfafrnlplrusvtruz
🇮🇪 Ireland ie bgcadadeeneseufafrheiditjakaltnbnlplptrusksvtrukzh
🇮🇱 Israel il arcacsdeenesfafifrheiditjanlplptrusvtrukzh
🇮🇹 Italy it afarazbgbncacsdadeeleneseteufafifrglhehrhuhyiditjakkkoltlvmsnbnlplptroruskslsrsvtrukuzvizh
🇨🇮 Ivory Coast ci enfritmsnlro
🇯🇲 Jamaica jm ennl
🇯🇵 Japan jp arazbgbncacsdadeeleneseteufafifrglhehihuhyiditjakakoltlvmsnbnlplptroruskslsrsvthtrukuzvizh
🇯🇴 Jordan jo arenfanlsq
🇰🇿 Kazakhstan kz bgdeelenfafrjakkmsnbnlplrusvukuzzh
🇰🇪 Kenya ke deenesfafifrjanlplsvzh
🇰🇮 Kiribati ki en
🇽🇰 Kosovo xk bgdeenfritnlplrusqsrsvtr
🇰🇼 Kuwait kw en
🇰🇬 Kyrgyzstan kg deenfanlrutrukuzzh
🇱🇦 Laos la ennlpl
🇱🇻 Latvia lv bgcacsdadeenesetfafritltlvnlplrusvtrukzh
🇱🇧 Lebanon lb ardeenesfafrheitnlplru
🇱🇸 Lesotho ls en
🇱🇷 Liberia lr en
🇱🇾 Libya ly arenfafrnlpt
🇱🇮 Liechtenstein li en
🇱🇹 Lithuania lt bgcacsdeenesetfafifrheitjaltlvnlplrusvukuzzh
🇱🇺 Luxembourg lu cadeenfrmsnlplsvtr
🇲🇬 Madagascar mg en
🇲🇼 Malawi mw en
🇲🇾 Malaysia my deenesfridjamsnlplzh
🇲🇻 Maldives mv en
🇲🇱 Mali ml enfrnluz
🇲🇹 Malta mt ensv
🇲🇭 Marshall Islands mh en
🇲🇷 Mauritania mr en
🇲🇺 Mauritius mu enhunl
🇲🇽 Mexico mx bgbncadadeeneseufafifrglhuiditjaltnbnlplptrusrsvtrukvizh
🇫🇲 Micronesia fm en
🇲🇩 Moldova md bgdadeeneseufritjakanbnlplptrorusvtruk
🇲🇨 Monaco mc en
🇲🇳 Mongolia mn en
🇲🇪 Montenegro me bgdeelenesfafrhritnlplroslsqsrsvuk
🇲🇦 Morocco ma arcadeenesfafritnlptsv
🇲🇿 Mozambique mz en
🇲🇲 Myanmar mm deenesfrjanlplptrusvthuzzh
🇳🇦 Namibia na deenfrnl
🇳🇷 Nauru nr en
🇳🇵 Nepal np bgbndeenesfrhijamsnlplptzh
🇳🇱 Netherlands nl afarbgcacsdadeeneseufafifrglhehuhyiditjakoltmsnbnlplptroruskslsqsvtrukvizh
🇳🇿 New Zealand nz cadeenesfritjamsnlplrusvtrzh
🇳🇮 Nicaragua ni deenesfrsv
🇳🇪 Niger ne deenfrittr
🇳🇬 Nigeria ng cadeenesfritjanlplptruzh
🇳🇺 Niue nu en
🇰🇵 North Korea kp en
🇲🇰 North Macedonia mk bgcacsdeelenesfrhuitkanlplptruskslsqsrsvtruk
🇳🇴 Norway no cadadeenesetfafifritjamsnbnlplptrorusvzh
🇴🇲 Oman om arennluz
🇵🇰 Pakistan pk arbncadadeenesfafifrhiiditjamsnbnlplptrusvtrukuzvizh
🇵🇼 Palau pw en
🇵🇸 Palestine ps arcacsdeenesfafrhenlplru
🇵🇦 Panama pa en
🇵🇬 Papua New Guinea pg ennl
🇵🇾 Paraguay py enesnl
🇵🇪 Peru pe deenesfafritjaltnlplptruzh
🇵🇭 Philippines ph arbgbncadadeeleneseufafifrhihuiditjakakoltlvmsnbnlplptrusvthtrukvizh
🇵🇱 Poland pl afarazbgcacsdadeeleneseteufafifrglhehrhuhyiditjakoltlvmsnbnlplptroruskslsqsrsvthtrukuzvizh
🇵🇹 Portugal pt cadeeneseufrglitkknlplptrutrukzh
Puerto Rico pr en
🇶🇦 Qatar qa arenfa
🇨🇬 Republic of the Congo cg enfr
🇷🇴 Romania ro arbgcacsdadeeneseteufafifrglhehrhuiditjaltlvmsnbnlplptroruskslsqsrsvtrukvizh
🇷🇺 Russia ru afarazbgbncacsdadeeleneseteufafifrglhehihrhuhyiditjakakkkoltlvmnmsnbnlplptroruskslsqsrsvthtrukuzvizh
🇷🇼 Rwanda rw en
🇰🇳 Saint Kitts and Nevis kn en
🇱🇨 Saint Lucia lc deenesfr
🇻🇨 Saint Vincent and the Grenadines vc en
🇼🇸 Samoa ws bnennl
🇸🇲 San Marino sm en
🇸🇦 Saudi Arabia sa arenfaidnlruuz
🇸🇳 Senegal sn deenfrnl
🇷🇸 Serbia rs bgcsdeelenesfafrhrhuitjamsnlplptroruslsqsrsvtrukzh
🇸🇨 Seychelles sc en
🇸🇱 Sierra Leone sl ennl
🇸🇬 Singapore sg en
🇸🇽 Sint Maarten sx en
🇸🇰 Slovakia sk arcacsdadeeneseteufafrhrhuitjalvmsnlplptrorusksrtrukzh
🇸🇮 Slovenia si arbgcacsdadeenesfafrhrhuitjakonbnlplptroruslsrsvthukuzvizh
🇸🇧 Solomon Islands sb en
🇸🇴 Somalia so arenjanl
🇿🇦 South Africa za afarbgcadadeenesetfafrheitjanbnlplptrorusvtrukzh
🇰🇷 South Korea kr enfrjakonlsvvizh
🇸🇸 South Sudan ss ennl
🇪🇸 Spain es afarbgcacsdadeeneseteufafifrglhehrhuhyiditjakaltmsnbnlplptroruskslsvtrukuzvizh
🇱🇰 Sri Lanka lk bgdeenesfafrjanlsvuz
🇸🇩 Sudan sd arenfanl
🇸🇷 Suriname sr ennl
🇸🇪 Sweden se bgcadadeenesfafifritjanbnlplptroruslsvtrukzh
🇨🇭 Switzerland ch arbgcacsdadeeleneseteufafifrglhehrhuhyiditjakkkoltmsnbnlplptroruskslsqsrsvtrukuzvizh
🇸🇾 Syria sy arcadeenesfafrhehyjanlplrusvtrukuzvizh
🇸🇹 São Tomé and Príncipe st deenfrnlpt
🇹🇼 Taiwan tw deenitjakoruvizh
🇹🇯 Tajikistan tj enfamsnlruukuz
🇹🇿 Tanzania tz deenfritnl
🇹🇭 Thailand th deenfritnbnlth
🇧🇸 The Bahamas bs en
🇬🇲 The Gambia gm deennlsv
🇹🇱 Timor-Leste tl deen
🇹🇬 Togo tg enesfritnluz
🇹🇴 Tonga to en
🇹🇹 Trinidad and Tobago tt enesnl
🇹🇳 Tunisia tn ardeenfr
🇹🇷 Turkey tr arazbgcacsdadeeleneseufafifrglhehrhuhyiditjakakkkoltlvmsnbnlplptroruskslsrsvtrukuzvizh
🇹🇲 Turkmenistan tm enfaru
🇹🇻 Tuvalu tv en
🇺🇬 Uganda ug enfrjanbnlpl
🇺🇦 Ukraine ua arazbgcacsdadeeleneseteufafifrhehuhyitjakakkkoltlvnbnlplptroruskslsqsrsvthtrukuzvizh
🇦🇪 United Arab Emirates ae arenesfanl
🇬🇧 United Kingdom gb afarazbgbncacsdadeeleneseteufafifrglhehihrhuhyiditjakakoltlvmsnbnlplptroruskslsrsvthtrukvizh
🇺🇸 United States us afarazbgbncacsdadeeleneseteufafifrglhehihrhuhyiditjakakkkoltlvmsnbnlplptroruskslsqsrsvthtrukuzvizh
🇺🇾 Uruguay uy cadeenesfrhyitnbnlplptruzh
🇺🇿 Uzbekistan uz ardeenesfafrjakknlplrutrukuz
🇻🇺 Vanuatu vu en
🇻🇦 Vatican City va en
🇻🇪 Venezuela ve cadeenesfafritjanbnlplptrusvvizh
🇻🇳 Vietnam vn enfrjakonlvizh
🇾🇪 Yemen ye arenfanlru
🇿🇲 Zambia zm deennl
🇿🇼 Zimbabwe zw ennl