Pular para o conteúdo principal

​
Endpoint

GET https://api.bunny.build/api/v1/ip-lookup?ip=8.8.8.8

​
Autenticação

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

​
Visão geral

Obtenha informações detalhadas de geolocalização e rede para qualquer endereço IP. A Bunny retorna o país, região, cidade, coordenadas, fuso horário, nome do ISP, organização e ASN, tudo em uma única requisição rápida.

​
Casos de uso

  • Personalizar conteúdo e idioma pela localização do usuário
  • Registrar a origem das requisições para análises e auditorias
  • Aplicar controles de acesso baseados em região
  • Exibir localizações estimadas de entrega

​
Detalhes

Suporta IPv4 e IPv6. A precisão em nível de cidade varia por região e ISP. As coordenadas representam o centro aproximado da cidade detectada, não a localização exata do usuário final.

​
Parâmetros de query

ParâmetroTipoObrigatórioDescrição
ipstringSimEndereço IPv4 ou IPv6 válido

​
Resposta

​
200 OK

CampoTipoDescrição
ipstringO IP consultado
countrystring | nullCódigo do país ISO (ex.: US)
regionstring | nullNome da região/estado
citystring | nullNome da cidade
latnumber | nullLatitude
lonnumber | nullLongitude
timezonestring | nullFuso horário (ex.: America/Sao_Paulo)
asnint | nullNúmero do Sistema Autônomo
orgstring | nullNome da organização
Exemplo 
{
  "ip": "8.8.8.8",
  "country": "US",
  "region": "California",
  "city": "Mountain View",
  "lat": 37.386,
  "lon": -122.0838,
  "timezone": "America/Los_Angeles",
  "asn": 15169,
  "org": "Google LLC"
}

​
401 Unauthorized

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

​
402 Payment Required

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

​
422 Unprocessable Entity

Formato de IP inválido. 
{
  "detail": "Invalid IP address format"
}

​
429 Too Many Requests

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

​
Exemplo cURL

curl "https://api.bunny.build/api/v1/ip-lookup?ip=8.8.8.8" \
  -H "X-API-Key: bun_sua_chave_api"