API de consulta de IPv4
País, região, cidade, coordenadas aproximadas, fuso horário, a rede e a operadora por trás dela, indicadores de datacenter e proxy, e um bloco de ameaças que informa se o endereço foi denunciado por abuso ou ataques, e com que gravidade. Omita o parâmetro ip e você recebe o endereço de quem faz a chamada, que é o caso mais comum em sites.
Exemplo
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4?ip=8.8.8.8"
# The caller's own address
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4"A geolocalização de um endereço IP em nível de cidade é uma estimativa e sempre será; o endereço pertence a uma rede, não a uma pessoa. O país está correto para bem mais de 99% dos endereços. A cidade é mais confiável para provedores de internet residenciais e menos confiável para operadoras móveis e datacenters, e é por isso que esses são sinalizados.
{
"status": "ok",
"ip": "1.0.164.165",
"version": 4,
"found": true,
"prefix": "1.0.164.0/24",
"country": "Thailand",
"country_code": "TH",
"continent": "Asia",
"continent_code": "AS",
"region": "Krung Thep Maha Nakhon",
"region_code": null,
"city": "Bangkok",
"postcode": "10200",
"lat": 13.749976,
"lon": 100.516819,
"timezone": "Asia/Bangkok",
"utc_offset": "+07:00",
"utc_offset_seconds": 25200,
"is_eu": false,
"asn": 23969,
"as_name": "TOT Public Company Limited",
"org": "TOT Public Company Limited",
"usage_type": "Eyeball",
"registry": "apnic",
"allocated": "2008-10-22",
"tags": ["dsl"],
"is_anycast": false,
"is_satellite": false,
"is_datacenter": false,
"is_proxy": false,
"is_vpn_provider": false,
"is_tor": false,
"is_private": false,
"abuse_email": "abuse@totisp.net",
"threat": {
"listed": true,
"score": 90,
"source_count": 2,
"categories": ["abuse", "attacker"],
"is_tor": false,
"is_tor_exit": false,
"is_bogon": false,
"listings": [
{ "category": "abuse", "confidence": 100, "recency_days": 1 },
{ "category": "attacker", "confidence": null, "recency_days": null }
]
},
"updated_at": "2026-09-18 06:53:39"
}O que você recebe
| Campo | Significado |
|---|---|
country, country_code | Nome do país e código ISO 3166-1 alfa-2. |
region, region_code | Estado, província ou equivalente, com seu código ISO 3166-2 quando existir. |
city, postcode | Melhor estimativa da cidade e do código postal. Ausente quando desconhecido. |
lat, lon | Coordenadas da cidade ou, na falta delas, do centro da região ou do país. |
timezone | Nome IANA, a partir da localização. |
asn, org | O número do sistema autônomo e a organização que anuncia o prefixo. |
is_datacenter | O endereço está em uma faixa de hospedagem ou nuvem. Considere a cidade pouco confiável e leve em conta que o tráfego pode ser automatizado. |
is_proxy, is_tor, is_vpn_provider | Evidência, por endereço, de um relay Tor ou de listagem como proxy; e, separadamente, se a operadora vende serviços de VPN. |
usage_type, tags, registry, allocated, abuse_email | Que tipo de operadora administra a rede, suas tags de operadora, qual registro a alocou e quando, e seu contato de abuso. |
threat | Bloco de reputação: listado ou não, uma pontuação de 0 a 100, quantas denúncias independentes listam o endereço e em quais categorias, indicadores de Tor e bogon, e cada listagem com sua confiança e idade. Atualizado diariamente. |
Onde é usada
Localizar a primeira visita
Escolha um país, moeda, idioma e unidades padrão antes que o visitante tenha digitado qualquer coisa. Passe o endereço do visitante como ip a partir do seu servidor.
Sinais de fraude e abuso
Compare o país do IP com o país de cobrança. Trate is_proxy e is_datacenter como sinais, não como veredictos.
Analytics sem cookies
Agregue visitas por país e região no servidor a partir dos logs de acesso, sem nenhum rastreamento no lado do cliente.
Preço e limites
Uma chamada é uma requisição; cada endereço de um lote conta como uma. Toda chave tem 2.500 requisições gratuitas por dia; acima disso, € 0,0001 cada uma a partir do crédito pré-pago, ou nada em uma chave Unlimited (€ 50 por mês). Preços. Vai migrar do ip-api, ipinfo ou ipstack? Esses formatos estão disponíveis como hosts compatíveis (drop-in). Para endereços IPv6, veja a API de consulta de IPv6.