GET /ip-lookup

Endpoint

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

Autenticação

Header	Obrigatório	Valor
`X-API-Key`	Sim	Sua 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âmetro	Tipo	Obrigatório	Descrição
`ip`	string	Sim	Endereço IPv4 ou IPv6 válido

Resposta

200 OK

Campo	Tipo	Descrição
`ip`	string	O IP consultado
`country`	string \| null	Código do país ISO (ex.: `US`)
`region`	string \| null	Nome da região/estado
`city`	string \| null	Nome da cidade
`lat`	number \| null	Latitude
`lon`	number \| null	Longitude
`timezone`	string \| null	Fuso horário (ex.: `America/Sao_Paulo`)
`asn`	int \| null	Número do Sistema Autônomo
`org`	string \| null	Nome 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"

Introdução

Referência da API

GET /ip-lookup

Endpoint

Autenticação

Visão geral

Casos de uso

Detalhes

Parâmetros de query

Resposta

200 OK

401 Unauthorized

402 Payment Required

422 Unprocessable Entity

429 Too Many Requests

Exemplo cURL

​Endpoint

​Autenticação

​Visão geral

​Casos de uso

​Detalhes

​Parâmetros de query

​Resposta

​200 OK

​401 Unauthorized

​402 Payment Required

​422 Unprocessable Entity

​429 Too Many Requests

​Exemplo cURL

Endpoint

Autenticação

Visão geral

Casos de uso

Detalhes

Parâmetros de query

Resposta

200 OK

401 Unauthorized

402 Payment Required

422 Unprocessable Entity

429 Too Many Requests

Exemplo cURL