{
"count": 252,
"countries": [
{
"alpha2": "AF",
"alpha3": "AFG",
"numeric": "004",
"name": "Afghanistan",
"flag": "🇦🇫",
"capital": "Kabul",
"continent": "Asia",
"continent_code": "AS",
"currency_code": "AFN",
"calling_code": "+93",
"population": 43844111
},
{
"alpha2": "AX",
"alpha3": "ALA",
"numeric": "248",
"name": "Aland Islands",
"flag": "🇦🇽",
"capital": "Mariehamn",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "EUR",
"calling_code": "+358-18",
"population": 26711
},
{
"alpha2": "AL",
"alpha3": "ALB",
"numeric": "008",
"name": "Albania",
"flag": "🇦🇱",
"capital": "Tirana",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "ALL",
"calling_code": "+355",
"population": 2349580
}
],
"attribution": "Country data from GeoNames (geonames.org), CC BY 4.0. Subdivisions from ISO 3166-2."
}
curl --location --request GET 'https://zylalabs.com/api/15050/countries+api/39818/list+or+search+countries?eu_only=false' --header 'Authorization: Bearer YOUR_API_KEY'
{
"code": "EUR",
"name": "Euro",
"numeric": "978",
"countries": [
{
"alpha2": "AX",
"name": "Aland Islands",
"flag": "🇦🇽"
},
{
"alpha2": "AD",
"name": "Andorra",
"flag": "🇦🇩"
},
{
"alpha2": "AT",
"name": "Austria",
"flag": "🇦🇹"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15050/countries+api/39819/currency+details+and+the+countries+that+use+it&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"alpha2": "FR",
"alpha3": "FRA",
"numeric": "250",
"name": "France",
"flag": "🇫🇷",
"capital": "Paris",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "EUR",
"calling_code": "+33",
"population": 68720337,
"official_name": "French Republic",
"currency_name": "Euro",
"area_km2": 547030,
"tld": ".fr",
"languages": [
"fr-FR",
"frp",
"br"
],
"neighbours": [
"CH",
"DE",
"BE"
],
"time_zones": [
"Europe/Paris"
],
"eu_member": true,
"eurozone": true,
"postal_code_format": "#####",
"postal_code_regex": "^(\\d{5})$",
"subdivision_count": 124,
"attribution": "Country data from GeoNames (geonames.org), CC BY 4.0. Subdivisions from ISO 3166-2."
}
curl --location --request GET 'https://zylalabs.com/api/15050/countries+api/39820/look+up+one+country&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "US",
"count": 57,
"subdivisions": [
{
"code": "US-AL",
"name": "Alabama",
"type": "State",
"parent": null
},
{
"code": "US-AK",
"name": "Alaska",
"type": "State",
"parent": null
},
{
"code": "US-AS",
"name": "American Samoa",
"type": "Outlying area",
"parent": null
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15050/countries+api/39821/states+provinces+and+regions+of+a+country&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"country": "DE",
"count": 9,
"neighbours": [
{
"alpha2": "CH",
"alpha3": "CHE",
"numeric": "756",
"name": "Switzerland",
"flag": "🇨🇭",
"capital": "Bern",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "CHF",
"calling_code": "+41",
"population": 9092436
},
{
"alpha2": "PL",
"alpha3": "POL",
"numeric": "616",
"name": "Poland",
"flag": "🇵🇱",
"capital": "Warsaw",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "PLN",
"calling_code": "+48",
"population": 36435861
},
{
"alpha2": "NL",
"alpha3": "NLD",
"numeric": "528",
"name": "The Netherlands",
"flag": "🇳🇱",
"capital": "Amsterdam",
"continent": "Europe",
"continent_code": "EU",
"currency_code": "EUR",
"calling_code": "+31",
"population": 18087633
}
],
"attribution": "Country data from GeoNames (geonames.org), CC BY 4.0. Subdivisions from ISO 3166-2."
}
curl --location --request GET 'https://zylalabs.com/api/15050/countries+api/39822/countries+sharing+a+land+border&code=Required' --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 Países 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.
Dados do país por código ISO: capital, moeda, código de discagem, idiomas, fusos horários, vizinhos e subdivisões
Tabela de países GeoNames agrupada (CC BY 4.0) e subdivisões ISO 3166-2 As respostas incluem a atribuição do GeoNames
A população e a área são uma captura do GeoNames datada de 2026-11-14
Cada endpoint retorna dados JSON relacionados a países, incluindo detalhes como capital, moeda, código de discagem, idiomas, fusos horários e vizinhos geográficos. Por exemplo, o endpoint "Buscar um país" fornece informações abrangentes sobre um país específico, enquanto o endpoint "Listar ou pesquisar países" retorna um resumo de vários países
Os campos principais incluem códigos de país (alpha2, alpha3, numérico), nome, capital, código da moeda, código de chamada, população, idiomas e fusos horários. Por exemplo, o ponto de extremidade "GET Procurar um país" inclui campos como "nome_oficial" e "área_km2" para informações detalhadas sobre o país
A API fornece vários tipos de informações, como dados demográficos do país (população, área), dados geográficos (vizinhos, subdivisões) e detalhes econômicos (moeda, códigos de discagem). Cada endpoint foca em aspectos específicos, como o endpoint "GET Detalhes da moeda" listando países que utilizam uma determinada moeda
Os dados de resposta estão estruturados no formato JSON geralmente contendo um objeto principal com campos relevantes e arrays aninhados para dados relacionados Por exemplo o endpoint "GET Estados províncias e regiões de um país" retorna uma contagem e um array de subdivisões cada uma com seus próprios atributos como código e nome
Os parâmetros variam por ponto de extremidade; por exemplo, o ponto de extremidade "GET Lista ou pesquisa de países" pode aceitar parâmetros de consulta para filtragem por nome ou região. Os usuários podem personalizar solicitações especificando códigos de país ou códigos de moeda para recuperar dados específicos
Os usuários podem aproveitar os dados retornados para aplicações como planejamento de viagens, recursos educacionais ou análise econômica Por exemplo, o endpoint "GET Países que compartilham uma fronteira terrestre" pode ajudar a identificar países vizinhos para estudos geográficos ou itinerários de viagem
A precisão dos dados é mantida por meio de fontes de bancos de dados respeitáveis como GeoNames e normas ISO Atualizações regulares e verificações garantem que as informações reflitam as realidades geopolíticas atuais aumentando a confiabilidade para os usuários
Casos de uso típicos incluem o desenvolvimento de ferramentas educacionais a criação de aplicações de viagem a realização de pesquisas de mercado e a análise de tendências demográficas Os dados abrangentes permitem diversas aplicações em vários setores incluindo turismo e negócios internacionais