{
"query": "mün",
"searched": [
"mun"
],
"count": 5,
"results": [
{
"geonameId": 4924006,
"name": "مونسي",
"localName": "Muncie",
"label": "مونسي, إنديانا, الولايات المتحدة الأمريكية",
"region": {
"code": "IN",
"name": "إنديانا"
},
"county": {
"code": "035",
"name": "Delaware County"
},
"country": {
"code": "US",
"name": "الولايات المتحدة الأمريكية"
},
"population": 70087,
"lat": 40.19338,
"lng": -85.38636,
"timezone": "America/Indiana/Indianapolis",
"featureCode": "PPLA2",
"matched": {
"name": "Muncie",
"kind": "name",
"exact": false
},
"score": 5.996
},
{
"geonameId": 4903184,
"name": "موندلين",
"localName": "Mundelein",
"label": "موندلين, إلينوي, الولايات المتحدة الأمريكية",
"region": {
"code": "IL",
"name": "إلينوي"
},
"county": {
"code": "097",
"name": "Lake County"
},
"country": {
"code": "US",
"name": "الولايات المتحدة الأمريكية"
},
"population": 31582,
"lat": 42.26308,
"lng": -88.00397,
"timezone": "America/Chicago",
"featureCode": "PPL",
"matched": {
"name": "Mundelein",
"kind": "name",
"exact": false
},
"score": 5.5
},
{
"geonameId": 4924014,
"name": "Munster",
"label": "Munster, إنديانا, الولايات المتحدة الأمريكية",
"region": {
"code": "IN",
"name": "إنديانا"
},
"county": {
"code": "089",
"name": "Lake County"
},
"country": {
"code": "US",
"name": "الولايات المتحدة الأمريكية"
},
"population": 22984,
"lat": 41.56448,
"lng": -87.51254,
"timezone": "America/Chicago",
"featureCode": "PPL",
"matched": {
"name": "Munster",
"kind": "name",
"exact": false
},
"score": 5.362
},
{
"geonameId": 5202734,
"name": "Munhall",
"label": "Munhall, بنسيلفانيا, الولايات المتحدة الأمريكية",
"region": {
"code": "PA",
"name": "بنسيلفانيا"
},
"county": {
"code": "003",
"name": "Allegheny County"
},
"country": {
"code": "US",
"name": "الولايات المتحدة الأمريكية"
},
"population": 11247,
"lat": 40.39229,
"lng": -79.90005,
"timezone": "America/New_York",
"featureCode": "PPL",
"matched": {
"name": "Munhall",
"kind": "name",
"exact": false
},
"score": 5.051
},
{
"geonameId": 4644282,
"name": "مونفورد",
"localName": "Munford",
"label": "مونفورد, تينيسي, الولايات المتحدة الأمريكية",
"region": {
"code": "TN",
"name": "تينيسي"
},
"county": {
"code": "167",
"name": "Tipton County"
},
"country": {
"code": "US",
"name": "الولايات المتحدة الأمريكية"
},
"population": 6108,
"lat": 35.44925,
"lng": -89.81508,
"timezone": "America/Chicago",
"featureCode": "PPL",
"matched": {
"name": "Munford",
"kind": "name",
"exact": false
},
"score": 4.787
}
],
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37310/city+typeahead+prefix+search?q=mün&country=US&limit=5&lang=ar&minPopulation=Optional' --header 'Authorization: Bearer YOUR_API_KEY'
{
"geonameId": 2867714,
"name": "ميونخ",
"localName": "Munich",
"label": "ميونخ, بفاريا, ألمانيا",
"region": {
"code": "02",
"name": "بفاريا"
},
"county": {
"code": "091",
"name": "Upper Bavaria"
},
"country": {
"code": "DE",
"name": "ألمانيا"
},
"population": 1505005,
"lat": 48.13743,
"lng": 11.57549,
"timezone": {
"id": "Europe/Berlin",
"utcOffsetNow": "+01:00",
"dstNow": false,
"localTimeNow": "2026-10-28T02:51:00",
"utcOffsetJanuary": "+01:00",
"utcOffsetJuly": "+02:00"
},
"featureCode": "PPLA",
"asciiName": "Munich",
"elevation": 524,
"names": {
"ar": "ميونخ",
"de": "München",
"en": "Munich",
"es": "Múnich",
"fr": "Munich",
"hi": "म्यूनिख",
"it": "Monaco di Baviera",
"ja": "ミュンヘン",
"ko": "뮌헨",
"nl": "München",
"pl": "Monachium",
"pt": "Munique",
"ru": "Мюнхен",
"tr": "Münih",
"uk": "Мюнхен",
"zh": "慕尼黑"
},
"modified": "2026-05-06",
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37311/one+place+by+geonames+id?lang=ar&geonameId=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"lat": 48.137,
"lng": 11.575,
"radiusKm": 10,
"count": 3,
"results": [
{
"geonameId": 2867714,
"name": "ميونخ",
"localName": "Munich",
"label": "ميونخ, بفاريا, ألمانيا",
"region": {
"code": "02",
"name": "بفاريا"
},
"county": {
"code": "091",
"name": "Upper Bavaria"
},
"country": {
"code": "DE",
"name": "ألمانيا"
},
"population": 1505005,
"lat": 48.13743,
"lng": 11.57549,
"timezone": "Europe/Berlin",
"featureCode": "PPLA",
"distanceKm": 0.06
},
{
"geonameId": 2947022,
"name": "Bogenhausen",
"label": "Bogenhausen, بفاريا, ألمانيا",
"region": {
"code": "02",
"name": "بفاريا"
},
"county": {
"code": "091",
"name": "Upper Bavaria"
},
"country": {
"code": "DE",
"name": "ألمانيا"
},
"population": 77542,
"lat": 48.15221,
"lng": 11.61585,
"timezone": "Europe/Berlin",
"featureCode": "PPLX",
"distanceKm": 3.47
},
{
"geonameId": 2819568,
"name": "Unterföhring",
"label": "Unterföhring, بفاريا, ألمانيا",
"region": {
"code": "02",
"name": "بفاريا"
},
"county": {
"code": "091",
"name": "Upper Bavaria"
},
"country": {
"code": "DE",
"name": "ألمانيا"
},
"population": 10500,
"lat": 48.19253,
"lng": 11.64293,
"timezone": "Europe/Berlin",
"featureCode": "PPLA4",
"distanceKm": 7.97
}
],
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37312/places+near+a+point?lat=48.137&lng=11.575&radius=10&limit=3&minPopulation=Optionallang=ar' --header 'Authorization: Bearer YOUR_API_KEY'
{
"lat": 40.7128,
"lng": -74.006,
"timezone": {
"id": "America/New_York",
"utcOffsetNow": "-04:00",
"dstNow": true,
"localTimeNow": "2026-10-27T21:51:01",
"utcOffsetJanuary": "-05:00",
"utcOffsetJuly": "-04:00"
},
"nearestCity": {
"geonameId": 5128581,
"name": "New York City",
"country": "US",
"distanceKm": 0.16
},
"agreement": {
"nearestPlaces": 5,
"sameTimezone": 5,
"otherTimezones": []
},
"caveat": "The time zone of the nearest populated place, not a time zone boundary lookup: near a border, at sea or in empty land it can be wrong. Check \"agreement\" and \"nearestCity.distanceKm\".",
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37313/time+zone+at+a+point+nearest+place?lat=40.7128&lng=-74.006' --header 'Authorization: Bearer YOUR_API_KEY'
{
"count": 252,
"countries": [
{
"code": "AW",
"iso3": "ABW",
"isoNumeric": "533",
"name": "آروبا",
"englishName": "Aruba",
"capital": "Oranjestad",
"continent": "NA",
"population": 108785,
"areaKm2": 193,
"currency": {
"code": "AWG",
"name": "Guilder"
},
"phone": "297",
"tld": ".aw",
"languages": [
"nl-AW",
"pap",
"es",
"en"
],
"neighbours": [],
"postalCodeFormat": null,
"geonameId": 3577279,
"places": 14
},
{
"code": "IS",
"iso3": "ISL",
"isoNumeric": "352",
"name": "آيسلندا",
"englishName": "Iceland",
"capital": "Reykjavik",
"continent": "EU",
"population": 392404,
"areaKm2": 103000,
"currency": {
"code": "ISK",
"name": "Krona"
},
"phone": "354",
"tld": ".is",
"languages": [
"is",
"en",
"de",
"da",
"sv"
],
"neighbours": [],
"postalCodeFormat": "###",
"geonameId": 2629691,
"places": 50
},
{
"code": "ET",
"iso3": "ETH",
"isoNumeric": "231",
"name": "إثيوبيا",
"englishName": "Ethiopia",
"capital": "Addis Ababa",
"continent": "AF",
"population": 135472051,
"areaKm2": 1127127,
"currency": {
"code": "ETB",
"name": "Birr"
},
"phone": "251",
"tld": ".et",
"languages": [
"am",
"en-ET",
"om-ET",
"ti-ET",
"so-ET"
],
"neighbours": [
"ER",
"KE",
"SD",
"SS",
"SO"
],
"postalCodeFormat": "####",
"geonameId": 337996,
"places": 256
},
{
"code": "AZ",
"iso3": "AZE",
"isoNumeric": "031",
"name": "أذربيجان",
"englishName": "Azerbaijan",
"capital": "Baku",
"continent": "AS",
"population": 10246996,
"areaKm2": 86600,
"currency": {
"code": "AZN",
"name": "Manat"
},
"phone": "994",
"tld": ".az",
"languages": [
"az",
"ru",
"hy"
],
"neighbours": [
"GE",
"IR",
"AM",
"TR",
"RU"
],
"postalCodeFormat": "AZ ####",
"geonameId": 587116,
"places": 245
},
{
"code": "AM",
"iso3": "ARM",
"isoNumeric": "051",
"name": "أرمينيا",
"englishName": "Armenia",
"capital": "Yerevan",
"continent": "AS",
"population": 3086700,
"areaKm2": 29800,
"currency": {
"code": "AMD",
"name": "Dram"
},
"phone": "374",
"tld": ".am",
"languages": [
"hy"
],
"neighbours": [
"GE",
"IR",
"AZ",
"TR"
],
"postalCodeFormat": "####",
"geonameId": 174982,
"places": 625
}
],
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37314/all+countries?lang=ar' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": {
"code": "CH",
"name": "سويسرا"
},
"count": 26,
"regions": [
{
"code": "AR",
"name": "أبينزيل أوسيرهودن",
"asciiName": "Appenzell Ausserrhoden",
"geonameId": 2661739,
"places": 13
},
{
"code": "AI",
"name": "أبينزيل إينرهودن",
"asciiName": "Appenzell Innerrhoden",
"geonameId": 2661741,
"places": 4
},
{
"code": "OW",
"name": "أوبفالدن",
"asciiName": "Obwalden",
"geonameId": 2659315,
"places": 7
},
{
"code": "UR",
"name": "أوري",
"asciiName": "Uri",
"geonameId": 2658226,
"places": 15
},
{
"code": "ZG",
"name": "تسوغ",
"asciiName": "Zug",
"geonameId": 2657907,
"places": 9
},
{
"code": "TG",
"name": "تورغاو",
"asciiName": "Thurgau",
"geonameId": 2658372,
"places": 54
},
{
"code": "TI",
"name": "تيسينو",
"asciiName": "Ticino",
"geonameId": 2658370,
"places": 84
},
{
"code": "JU",
"name": "جورا",
"asciiName": "Jura",
"geonameId": 2660207,
"places": 28
},
{
"code": "SO",
"name": "سولوتورن",
"asciiName": "Solothurn",
"geonameId": 2658563,
"places": 52
},
{
"code": "SH",
"name": "شافهوزن",
"asciiName": "Schaffhausen",
"geonameId": 2658760,
"places": 20
},
{
"code": "SZ",
"name": "شفيتس",
"asciiName": "Schwyz",
"geonameId": 2658664,
"places": 33
},
{
"code": "GR",
"name": "غروبندن",
"asciiName": "Grisons",
"geonameId": 2660522,
"places": 79
},
{
"code": "GL",
"name": "غلاروس",
"asciiName": "Glarus",
"geonameId": 2660593,
"places": 14
},
{
"code": "VS",
"name": "فاليه",
"asciiName": "Valais",
"geonameId": 2658205,
"places": 88
},
{
"code": "VD",
"name": "فود",
"asciiName": "Vaud",
"geonameId": 2658182,
"places": 143
},
{
"code": "AG",
"name": "كانتون أرجاو",
"asciiName": "Aargau",
"geonameId": 2661876,
"places": 132
},
{
"code": "BL",
"name": "كانتون بازل الريف",
"asciiName": "Basel-Landschaft",
"geonameId": 2661603,
"places": 53
},
{
"code": "BE",
"name": "كانتون برن",
"asciiName": "Bern",
"geonameId": 2661551,
"places": 211
},
{
"code": "GE",
"name": "كانتون جنيف",
"asciiName": "Geneva",
"geonameId": 2660645,
"places": 36
},
{
"code": "ZH",
"name": "كانتون زيوريخ",
"asciiName": "Zurich",
"geonameId": 2657895,
"places": 550
},
{
"code": "SG",
"name": "كانتون سانت غالن",
"asciiName": "Saint Gallen",
"geonameId": 2658821,
"places": 74
},
{
"code": "FR",
"name": "كانتون فريبورغ",
"asciiName": "Fribourg",
"geonameId": 2660717,
"places": 77
},
{
"code": "BS",
"name": "كانتون مدينة بازل",
"asciiName": "Basel-City",
"geonameId": 2661602,
"places": 4
},
{
"code": "LU",
"name": "لوتسيرن",
"asciiName": "Lucerne",
"geonameId": 2659810,
"places": 73
},
{
"code": "NW",
"name": "نيدفالدن",
"asciiName": "Nidwalden",
"geonameId": 2659471,
"places": 9
},
{
"code": "NE",
"name": "نيوشاتل",
"asciiName": "Neuchatel",
"geonameId": 2659495,
"places": 37
}
],
"note": "Codes are GeoNames admin1 codes: ISO 3166-2 suffixes for the US, Switzerland, Belgium and Montenegro, FIPS 10-4 or GeoNames codes elsewhere. Use the code or the name as \"admin1\" in /autocomplete.",
"source": {
"data": "GeoNames (geonames.org), CC BY 4.0; changed by us (see /attribution)",
"license": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "/attribution"
}
}
curl --location --request GET 'https://zylalabs.com/api/14562/world+city+autocomplete+api/37315/regions+states+provinces+of+a+country?country=CH&lang=ar' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Autocompletar Cidade do Mundo API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
Previsão de cidade rápida: 236.000 lugares, 16 idiomas, à prova de sotaque, com região, país e fuso horário
Cada endpoint retorna dados geográficos específicos O tipo de sugestão de cidade fornece nomes de locais e detalhes com base em uma pesquisa por prefixo O endpoint Um lugar pelo ID do GeoNames retorna informações completas sobre um local específico O endpoint Locais próximos a um ponto lista locais nas proximidades enquanto o Fuso horário em um ponto fornece detalhes sobre o fuso horário O endpoint Todos os países fornece informações sobre países e Regiões estados províncias de um país lista regiões de primeiro nível
Os campos-chave variam por ponto final. Para o autocompletar de cidades, os campos incluem `geonameId`, `nome`, `população`, e `fuso horário`. O ponto final de um lugar inclui `lat`, `lng`, `população`, e `elevação`. O ponto final de lugares próximos a um ponto retorna `distanciaKm`, `rótulo`, e `região`. O ponto final de fuso horário apresenta `utcOffsetNow`, `dstNow`, e `cidadeMaisPróxima`. O ponto final de todos os países inclui `código`, `capital`, `população`, e `idiomas`
Os parâmetros variam conforme o ponto final O tipo autocomplete da Cidade aceita um `prefixo` para busca O Local único pelo ID do GeoNames requer um `geonameId` Os Lugares próximos a um ponto precisam de `lat`, `lng` e `radiusKm` O ponto final do Fuso horário usa `lat` e `lng` para encontrar o local mais próximo O ponto final de Todos os países não requer parâmetros enquanto o ponto final de Regiões estados províncias requer um `código de país`
Os dados de resposta estão estruturados no formato JSON Cada endpoint retorna um objeto contendo campos relevantes Por exemplo o tipo de autocompletar Cidade retorna uma `query` `count` e um array de `results` O endpoint Um lugar retorna informações detalhadas sobre uma localização em um único objeto O Places perto de um ponto retorna uma `lat` `lng` e um array de `results` enquanto o endpoint Todos os países retorna um `count` e um array de `countries`
Os dados são obtidos do GeoNames (geonames.org), que fornece uma base de dados abrangente de informações geográficas. A API também pode incorporar modificações adicionais nos dados para melhorar a precisão. As verificações de qualidade incluem atualizações regulares e validação contra padrões geográficos conhecidos para manter a integridade dos dados
Os casos de uso típicos incluem serviços baseados em localização, aplicativos de viagem e análise geográfica. Os desenvolvedores podem usar o tipo City para sugestões de pesquisa, o endpoint One place para informações detalhadas de localização e o Places near a point para encontrar atrações próximas. O endpoint Time zone é útil para agendamento em diferentes regiões, enquanto o endpoint All countries ajuda na análise de dados globais
Os usuários podem utilizar os dados retornados analisando a resposta JSON para extrair campos relevantes para suas aplicações Por exemplo eles podem exibir nomes de cidades e populações em uma interface de busca ou usar coordenadas para aplicações de mapeamento Entender a estrutura permite um manuseio eficiente de dados e integração em diversas soluções de software
Ao lidar com resultados parciais ou vazios, os usuários devem implementar verificações para o campo `count` na resposta. Se `count` for zero, isso indica que nenhuma correspondência foi encontrada. Para resultados parciais, os usuários podem exibir opções disponíveis e incentivar os usuários a refinarem sua pesquisa. Implementar debounce na entrada também pode reduzir solicitações desnecessárias e melhorar a experiência do usuário