Pular para o conteúdo principal

​
Endpoint

GET https://api.bunny.build/api/v1/country-info/:code
Também suporta busca por nome: 
GET https://api.bunny.build/api/v1/country-info?search=termo

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)

​
Visão geral

Recupere dados estruturados de países usando um código ISO 3166-1 alfa-2 (ex: BR), alfa-3 (ex: BRA) ou uma consulta de busca por nome. A resposta cobre geografia, demografia, moedas, idiomas, códigos de discagem e mais em uma única chamada.

​
Casos de uso

  • Preencher campos de país e validar entradas em formulários de cadastro
  • Enriquecer registros de endereços com dados de região, capital e código de discagem
  • Alimentar calculadoras de frete com área, fronteiras e informações de fuso horário
  • Orientar lógica de localização com base em idiomas, moedas e TLDs

​
Requisição

Passe o código ISO 3166-1 alfa-2 ou alfa-3 como parâmetro de rota, ou use o parâmetro de consulta search para busca por nome. Exemplos: 
GET /country-info/BR
GET /country-info/BRA
GET /country-info?search=brazil

​
Resposta

​
200 OK

CampoTipoDescrição
cca2stringCódigo ISO 3166-1 alfa-2
cca3stringCódigo ISO 3166-1 alfa-3
namestringNome comum do país
official_namestringNome oficial do país
capitalstringCapital
regionstringRegião geográfica
subregionstringSub-região geográfica
populationintegerPopulação estimada
area_km2numberÁrea em quilômetros quadrados
flagstringEmoji da bandeira
currenciesarray de objetosLista de moedas com code, name e symbol
languagesarray de stringsIdiomas oficiais
calling_codestringCódigo de discagem internacional
tldstringDomínio de nível superior
bordersarray de stringsCódigos dos países vizinhos (alfa-3)
timezonesarray de stringsIdentificadores IANA de fuso horário
continentsarray de stringsContinente(s)
Exemplo 
{
  "cca2": "BR",
  "cca3": "BRA",
  "name": "Brazil",
  "official_name": "Federative Republic of Brazil",
  "capital": "Brasilia",
  "region": "Americas",
  "subregion": "South America",
  "population": 215313498,
  "area_km2": 8515767,
  "flag": "🇧🇷",
  "currencies": [{ "code": "BRL", "name": "Brazilian real", "symbol": "R$" }],
  "languages": ["Portuguese"],
  "calling_code": "+55",
  "tld": ".br",
  "borders": ["ARG", "BOL", "COL", "GUY", "PRY", "PER", "SUR", "URY", "VEN"],
  "timezones": ["America/Sao_Paulo", "America/Manaus"],
  "continents": ["South America"]
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

{
  "detail": "Country not found for the provided code or search term."
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl "https://api.bunny.build/api/v1/country-info/BR" \
  -H "X-API-Key: bun_your_api_key"