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

API de geolocalização IP - pesquisa gratuita de endereço IP

Retorna dados de geolocalização para um endereço IP, incluindo país, cidade, região, coordenadas, fuso horário, ASN e data center Cloudflare. Se nenhum IP for fornecido, o IP do próprio chamador será usado.

Parameters

string

IPv4 or IPv6 address to geolocate. Omit to look up the caller's own IP.

Code examples

curl -X POST https://api.botoi.com/v1/ip/lookup \
  -H "Content-Type: application/json" \
  -d '{"ip":"203.0.113.1"}'

When to use this API

Personalize o conteúdo por localização do visitante

Detecte o país e a cidade de um visitante no carregamento da página para mostrar preços, idioma ou opções de envio localizadas. Uma página de checkout SaaS pode chamar esse endpoint para preencher previamente o seletor de moeda com base no código do país do visitante.

Pontuação de fraude em pipelines de pagamento

Compare a geolocalização IP de uma transação com o endereço de cobrança registrado. Sinalize pedidos em que o IP é resolvido para um país diferente do emissor do cartão e encaminhe transações sinalizadas por meio de revisão manual.

Registro de conformidade para auditorias de acesso

Registre o país e a região de cada login de administrador em um painel interno. Gere um relatório mensal de eventos de acesso agrupados por região geográfica para atender aos requisitos de auditoria SOC 2 ou GDPR.

Frequently asked questions

Quão precisos são os dados de geolocalização IP?
A precisão em nível de país está acima de 99%. A precisão em nível de cidade varia de acordo com a região, mas normalmente é de 80 a 90% para os principais ISPs. IPs e VPNs de operadoras móveis podem ser resolvidos na sede da operadora em vez da localização física do usuário.
Este endpoint suporta endereços IPv6?
Sim. Passe qualquer endereço IPv6 válido no campo ip. A resposta inclui os mesmos campos de geolocalização que as pesquisas IPv4.
O que acontece se eu omitir o parâmetro ip?
O endpoint retorna dados de geolocalização para o endereço IP do próprio chamador. Isso é útil para detectar a localização de um visitante do site sem qualquer JavaScript do lado do cliente.
Qual é o campo ASN?
ASN significa Número de Sistema Autônomo. Ele identifica a operadora de rede (como Comcast, AWS ou Cloudflare) proprietária do bloco de endereços IP. O campo as_organization fornece o nome legível.
Existe um limite de taxa neste endpoint?
Solicitações anônimas são limitadas a 5 por minuto com base no seu IP. As solicitações autenticadas com uma chave de API obtêm limites mais altos dependendo do seu plano.

Get your API key

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

Sign up free View full docs