Pular para o conteúdo
POST AI agent ready /v1/ip/bulk

API de geolocalização IP em massa - pesquisa gratuita em lote

Retorna dados de geolocalização para vários endereços IP em uma única solicitação. Inclui as informações de IP do próprio chamador juntamente com os resultados de cada IP solicitado.

Parameters

arrayrequired

Array of IPv4 or IPv6 addresses to geolocate.

Code examples

curl -X POST https://api.botoi.com/v1/ip/bulk \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1"]}'

When to use this API

Enriqueça os logs de eventos analíticos em lote

Depois de coletar um dia de eventos analíticos, extraia IPs de visitantes exclusivos e envie-os por meio do endpoint em massa. Anexe dados de país e cidade a cada linha de evento antes de carregá-los em seu data warehouse para relatórios geográficos.

Mapear infraestrutura distribuída

Alimente uma lista de seu servidor, nó CDN e IPs do balanceador de carga neste endpoint. Trace as coordenadas retornadas em um mapa para visualizar a área ocupada pela sua infraestrutura e identificar lacunas geográficas na cobertura.

Frequently asked questions

Quantos IPs posso enviar em uma única solicitação?
Você pode enviar até 100 endereços IP por solicitação. Para conjuntos de dados maiores, divida-os em lotes e envie várias solicitações.
A resposta inclui meu próprio IP?
Sim. A resposta inclui um campo caller_ip com geolocalização para seu próprio IP, além de resultados para cada IP no array ips.
Os IPs duplicados no array são tratados?
IPs duplicados são resolvidos de forma independente. Cada entrada na matriz ips obtém seu próprio objeto de resultado, mesmo que o mesmo IP apareça diversas vezes.
O que acontece se um IP do lote for inválido?
O endpoint retorna resultados para todos os IPs válidos e inclui uma mensagem de erro para qualquer IP que não pôde ser resolvido. A solicitação não falha totalmente devido a uma entrada incorreta.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.