Geolocalização de IP API
País, região, cidade, coordenadas e fuso horário de qualquer endereço IPv4 ou IPv6 público. Powered by MaxMind GeoLite2 — cálculo totalmente local, sem rate limits compartilhados.
Não tem uma API key?
Faça login na sua conta para criar e gerenciar suas API keys.
Guia de integração
Copie um trecho, troque sua API key e execute. Funciona em qualquer cliente HTTP — exemplos abaixo em cURL, JavaScript e Python.
/api/ip-geolocationhttps://www.apipick.comGet geolocation data for any public IP address
ipstringopcionalPublic IPv4 or IPv6 address. Omit to look up caller's own IP. 8.8.8.8
curl -X GET "https://www.apipick.com/api/ip-geolocation" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "ok",
"data": {
"ip": "8.8.8.8",
"country_code": "US",
"country_name": "United States",
"continent": "North America",
"continent_code": "NA",
"city": "Mountain View",
"latitude": 37.4056,
"longitude": -122.0775,
"timezone": "America/Los_Angeles",
"currency": "USD",
"isp": "Google LLC",
"asn": 15169
},
"credits_used": 1,
"remaining_credits": 99
}Feita para Casos de Uso Reais
Detecção de Fraude
Sinalize cadastros ou transações de regiões de alto risco. Verifique se o IP de um usuário corresponde à localização ou ao país de cobrança declarados.
Localização de Conteúdo
Selecione automaticamente idioma, moeda e preços regionais com base na localização do visitante. Exiba banners de cookies em conformidade com a UE apenas para visitantes da UE.
Rate Limiting
Aplique rate limits ou controles de acesso por país. Bloqueie ou reduza o tráfego de regiões específicas sem comprar ferramentas de segurança caras.
Enriquecimento por Agentes de IA
Deixe que agentes de IA enriqueçam registros de usuários, classifiquem leads por geografia ou localizem conteúdo gerado com base em dados de IP em tempo real.
Alternativa ao ipinfo.io e ipapi.co
Cobrança por créditos por conta — sem pool de rate limit compartilhado, sem faixas de plano, sem tetos mensais que reiniciam no primeiro dia do mês.
ipinfo.io | ipapi.co | API Pick ✓ | |
|---|---|---|---|
| Plano gratuito | 50k req/month | 1,000 req/day | 100 créditos no cadastro |
| Modelo de rate limiting | Risco de pool de IP compartilhado | Risco de pool de IP compartilhado | Créditos por conta |
| Créditos / cota expiram? | Reset mensal | Reset diário | Nunca expiram |
| País + região + cidade | ✓ | ✓ | ✓ |
| Fuso horário | Plano pago | ✓ | ✓ |
| Suporte a IPv6 | ✓ | ✓ | ✓ |
| Indicador de membro da UE | Plano pago | ✓ | ✓ |
| Sem cartão de crédito para começar | ✓ | ✓ | ✓ |
| Pronta para agentes de IA / LLM | Parcial | Parcial | ✓ JSON nativo |
O problema do pool de rate limit compartilhado
Nos planos gratuitos do ipinfo.io e do ipapi.co, os rate limits são aplicados por IP do cliente. Isso significa que todas as requisições da mesma região da Vercel, AWS ou GCP compartilham um único pool de cota. Se outro tenant no mesmo edge node já tiver esgotado o limite diário de 1.000, suas chamadas de API começam a falhar — mesmo que você ainda não tenha feito uma única requisição.
Cobrança por créditos: previsível em qualquer escala
A API Pick cobra por conta, não por IP. Cada chamada deduz exatamente 1 crédito do seu saldo — somente em caso de resposta bem-sucedida. Os créditos nunca expiram. Quer você faça 10 consultas ou 10.000 em um único dia, você paga apenas pelo que usar, sem risco de falhas surpresa por causa de uma cota compartilhada.
Campos de Resposta
| Campo | Tipo | Descrição |
|---|---|---|
| data.ip | string | O endereço IP consultado |
| data.country_code | string | Código de país ISO 3166-1 alpha-2 (ex.: US, DE, JP) |
| data.country_name | string | Nome completo do país em inglês |
| data.continent | string | Nome do continente (ex.: North America, Europe) |
| data.continent_code | string | Código de continente de duas letras (ex.: NA, EU) |
| data.city | string | Nome da cidade (string vazia se indisponível) |
| data.latitude | number | null | Latitude aproximada da localização do IP |
| data.longitude | number | null | Longitude aproximada da localização do IP |
| data.timezone | string | Identificador de fuso horário IANA (ex.: America/Los_Angeles) |
| data.currency | string | Código de moeda ISO 4217 do país (ex.: USD, EUR) |
| data.isp | string | Nome do ISP / organização a partir da base de dados ASN |
| data.asn | integer | null | Autonomous System Number (ex.: 15169 para o Google) |
| credits_used | integer | Créditos deduzidos por esta requisição |
| remaining_credits | integer | Créditos restantes na sua conta |
Rate limits
O throttling é por API key, em janela deslizante de 60 segundos. Ao atingir o limite, você recebe um 429 limpo com um header Retry-After.
120req/min
Por API key, por endpoint. Janela deslizante de 60 segundos.
3concurrent
Máximo de requisições simultâneas em andamento por API key.
X-RateLimit-LimitMáximo de requisições permitidas por minutoX-RateLimit-RemainingRequisições restantes na janela atualX-RateLimit-ResetSegundos até a janela atual reiniciarRetry-AfterSegundos a aguardar antes de tentar novamente (apenas em 429)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Perguntas Frequentes
P: O que acontece se eu não passar um endereço IP?
R: O endpoint detecta automaticamente o IP de quem chama a partir dos headers da requisição (X-Forwarded-For). Isso é útil para consultas do lado do servidor, quando você quer geolocalizar o usuário final sem passar o IP explicitamente.
P: IPs privados são suportados?
R: Não. IPs privados (faixas RFC 1918 como 192.168.x.x, 10.x.x.x), loopback (127.0.0.1) e outras faixas reservadas retornam um erro 400. Somente endereços IPv4 e IPv6 publicamente roteáveis são suportados.
P: Qual é a precisão da geolocalização?
R: Powered by MaxMind GeoLite2-City. A precisão em nível de país costuma ser de 95–99%. A precisão em nível de cidade varia por região — em geral confiável na América do Norte e Europa, menos precisa em partes da Ásia e da África. As coordenadas representam a área geral, não uma localização física exata.
P: Agentes de IA podem usar isto como uma tool?
R: Sim. O endpoint aceita um único parâmetro de consulta opcional ip e retorna um objeto JSON plano — fácil de expor como uma função tool para OpenAI, Claude, LangChain ou qualquer framework de agentes. Útil para agentes que precisam raciocinar sobre a localização do usuário, aplicar regras baseadas em geografia ou enriquecer dados de leads com contexto regional.
Use a IP Geolocation no Claude Code e em Agentes de IA
Instale a skill oficial do Claude Code para geolocalizar qualquer endereço IP diretamente dentro do seu agente de programação de IA — país, cidade, ISP, fuso horário e mais, via linguagem natural.
Peça ao seu agente de IA em linguagem natural
Plataformas compatíveis
Skill do Claude Code para a API IP Geolocation da APIpick
Retorna país, continente, cidade, latitude/longitude, fuso horário IANA, código de moeda ISO, nome do ISP e ASN de qualquer endereço IP.