API do iplover
Endpoints gratuitos em JSON e texto simples: seu próprio endereço, quem está por trás de qualquer endereço, o tipo de rede e se um robô é mesmo quem diz ser. Sem chave, sem cadastro, e com CORS aberto, então você também pode usar pelo navegador.
Primeiros passos
No terminal, sem configurar nada:
curl iplover.com
curl https://iplover.com/json
curl https://iplover.com/api/check/8.8.8.8.txt
curl "https://iplover.com/api/verify-bot.txt?ip=66.249.66.1&ua=Googlebot"
Endpoints
| Endpoint | O que retorna | Limite |
|---|---|---|
GET /ip | Seu endereço público em texto simples. | Nenhum |
GET /json | Seu endereço, localização aproximada e rede. | Nenhum |
GET /json/{ip} | O registro e o DNS reverso de qualquer endereço público. | 30 por minuto mais o orçamento comum de 60 por minuto |
GET /api/check/{ip} | Quem está por trás de um endereço: categoria, tipo de rede e dono, com as evidências. | 30 por minuto mais o orçamento comum de 60 por minuto |
GET /api/verify-bot | Se um robô é mesmo quem o user agent diz. | 30 por minuto mais o orçamento comum de 60 por minuto |
POST /api/classify | O tipo de rede de até 100 endereços em uma só requisição. | 30 por minuto |
GET /api/asn/index | Uma tabela endereço → rede, em pedaços pequenos, para consultas no navegador. | 30 por minuto só contam as requisições que o nosso cache não consegue responder |
GET /ip
Seu endereço público em texto simples.
Formato: text
Limite: Nenhum
curl iplover.com dá a mesma resposta: clientes de linha de comando (curl, Wget, HTTPie, xh, PowerShell) recebem só o endereço na página inicial. Os dois também funcionam por HTTP simples, para scripts que não seguem redirecionamentos.
Exemplo
curl iplover.com
curl https://iplover.com/ip
Resposta de exemplo
203.0.113.7
GET /json
Seu endereço, localização aproximada e rede.
Formato: JSON
Limite: Nenhum
A localização é a estimativa da Cloudflare para a sua conexão: normalmente a cidade do gateway do seu provedor, não a sua casa. Uma VPN ou uma rede móvel mudam isso.
Exemplo
curl https://iplover.com/json
Resposta de exemplo
{
"ip": "203.0.113.7",
"ip_version": 4,
"country": "Italy",
"country_code": "IT",
"region": "Lombardy",
"city": "Milan",
"postal_code": "20121",
"latitude": 45.4642,
"longitude": 9.19,
"timezone": "Europe/Rome",
"asn": 64500,
"as_organization": "Example Telecom",
"user_agent": "curl/8.5.0"
}
GET /json/{ip}
O registro e o DNS reverso de qualquer endereço público.
Formato: JSON
Limite: 30 por minuto (mais o orçamento comum de 60 por minuto)
Consultamos o registro regional (RDAP) e um resolvedor DNS público. Se uma parte falhar, ela fica vazia e status e errors explicam o motivo. Respostas completas ficam em cache por uma hora. Endereços privados e reservados recebem um 422 com o kind deles.
Parâmetros
{ip}(no caminho)- Um endereço IPv4 ou IPv6.
Exemplo
curl https://iplover.com/json/8.8.8.8
Resposta de exemplo
{
"ip": "8.8.8.8",
"ip_version": 4,
"summary": "This address belongs to Google LLC (a cloud/hosting network) in the United States. Its reverse DNS name is dns.google.",
"network": { "name": "GOGL", "handle": "NET-8-8-8-0-2", "range": "8.8.8.0 - 8.8.8.255", "cidr": ["8.8.8.0/24"], "country": "United States", "country_code": "US", "country_source": "address" },
"owner": { "organization": "Google LLC", "abuse_email": "network-abuse@google.com" },
"registration": { "registered": "2023-12-28", "last_changed": "2023-12-28", "registry": "ARIN" },
"hosting_network": true,
"reverse_dns": ["dns.google"],
"status": { "rdap": "ok", "reverse_dns": "ok", "rdap_via": "rdap.org" },
"errors": { "rdap": null, "reverse_dns": null },
"sources": { "rdap": "https://rdap.arin.net/registry/ip/8.8.8.8", "reverse_dns": "https://cloudflare-dns.com/dns-query" },
"fetched_at": "2026-11-16T19:20:48.593Z",
"cached": false
}
Erros: invalid_ip, not_public, rate_limited
GET /api/check/{ip}
Quem está por trás de um endereço: categoria, tipo de rede e dono, com as evidências.
Formato: JSON · text
Limite: 30 por minuto (mais o orçamento comum de 60 por minuto)
Verifica as listas publicadas descritas em Fontes de dados (nuvens, grandes empresas, robôs, scanners, Tor, VPNs, listas de bloqueio), além do registro e do DNS reverso com confirmação direta. Adicione .txt para texto simples e ?lang= para o idioma dos textos legíveis. Endereços privados e reservados recebem um 200 com a categoria reserved.
Parâmetros
{ip}(no caminho)- Um endereço IPv4 ou IPv6.
lang(query)- Idioma dos textos legíveis: en, it, de, es, fr, pt. Nomes de campos e códigos ficam sempre em inglês.
format(query)textpara texto simples (o mesmo que adicionar.txt).
Exemplo
curl https://iplover.com/api/check/8.8.8.8
curl https://iplover.com/api/check/8.8.8.8.txt
Campos principais
category- A correspondência mais forte, uma das categorias abaixo.
ispquer dizer que nenhuma lista bateu: uma rede comum. level- Quanta atenção merece:
bad,warn,info,goodouneutral. verdict,explanation,action- Três frases no idioma pedido: o que é, por quê e o que fazer.
matched- As fontes que bateram, com a evidência: uma lista, o DNS reverso ou o número da rede.
sources- Cada fonte e o resultado dela:
matched,not_matchedounot_checked. Uma fonte que não conseguimos verificar nunca conta como resultado limpo. owner- O registro: organização, faixa, contato de abuso e datas.
asn- O número da rede que anuncia o endereço, e o nome dela.
reverse_dns- O nome PTR, e se ele aponta de volta para o endereço (
forward_confirmed). country- Onde a faixa está registrada, não onde o aparelho está.
network- Tipo de rede (residencial, móvel, hospedagem, VPN, Tor…).
identifiedquando uma lista publicada diz isso,estimatedquando deduzimos, e marcado como estimativa. lists- Quantas fontes foram verificadas e o quanto as nossas cópias são recentes.
Categorias
category | Rótulo | level |
|---|---|---|
attacker | Atacou os nossos sensores | bad |
blocklisted | Em uma lista de bloqueio | bad |
tor | Nó de saída do Tor | warn |
relay | Relay de privacidade | info |
scanner | Scanner de internet conhecido | info |
bot | Rastreador verificado | good |
cloud | Provedor de nuvem ou hospedagem | info |
service | Rede própria de uma grande empresa | info |
isp | Rede de um provedor ou de uma empresa | neutral |
reserved | Endereço privado ou reservado | info |
unknown | Dados insuficientes | info |
Os rótulos seguem ?lang=. Um tipo de rede como VPN, Tor ou hospedagem não é sinal de abuso; só attacker e blocklisted falam de comportamento.
Resposta de exemplo
{
"ip": "8.8.8.8",
"ip_version": 4,
"category": "service",
"category_label": "Large company's own network",
"level": "info",
"verdict": "This address is part of Google's own network.",
"explanation": "It is in the IP ranges Google publishes for its own services (such as search, email or public DNS), not in the ranges it rents to cloud customers. …",
"action": "No action is needed based on these sources. If traffic from it misbehaves, report it to the abuse contact of Google.",
"matched": [{ "source": "google", "name": "Google IP ranges (goog.json)", "kind": "service", "evidence": "list", "detail": null }],
"sources": [{ "source": "aws", "name": "AWS IP address ranges", "kind": "cloud", "status": "not_matched", "updated_at": "2026-11-16T05:37:05Z" }, …],
"owner": { "organization": "Google LLC", "network": "GOGL", "cidr": ["8.8.8.0/24"], "range": "8.8.8.0 - 8.8.8.255", "abuse_email": "network-abuse@google.com", "registry": "ARIN", … },
"owner_status": "ok",
"asn": { "number": 15169, "name": "Google LLC" },
"reverse_dns": { "name": "dns.google", "forward_confirmed": true, "forward_addresses": [], "forward_error": false, "resolver": "cloudflare" },
"country": { "code": "US", "name": "United States", "source": "address" },
"network": {
"primary": "service",
"status": "identified",
"label": "Company's own network",
"explanation": "This address is in the IP ranges Google publishes for its own services, …",
"types": [{ "type": "service", "basis": "list", "source": "google", "provider": "Google", "label": "Company's own network", "attribution": null, … }],
"attribution": null,
"crawler": null,
"note": "The network type describes the network, not the person. …"
},
"providers": [{ "id": "ip2proxy", "name": "IP2Proxy", "status": "not_configured" }, …],
"lists": { "version": "89d308802d8e", "built_at": "2026-11-16T19:17:44.219Z", "newest_update": "2026-11-16T19:17:44.219Z", "checked": 36, "not_checked": 1, … },
"checked_at": "2026-11-16T19:31:38.854Z",
"language": "en",
"note": "No source is complete. …"
}
Erros: invalid_ip, rate_limited
GET /api/verify-bot
Se um robô é mesmo quem o user agent diz.
Formato: JSON · text
Limite: 30 por minuto (mais o orçamento comum de 60 por minuto)
Informe ip, ua ou os dois. Com um endereço, comparamos com as faixas publicadas do robô e com o DNS reverso com confirmação direta. Sem endereço, só dizemos qual robô o user agent afirma ser. /api/verify-bot.txt retorna texto simples. Requisições sem endereço não contam para o limite.
Parâmetros
ip(query)- O endereço que enviou a requisição (opcional).
ua(query)- O User-Agent que ele enviou (opcional), até 1000 caracteres.
lang(query)- Idioma dos textos legíveis: en, it, de, es, fr, pt. Nomes de campos e códigos ficam sempre em inglês.
Exemplo
curl "https://iplover.com/api/verify-bot?ip=66.249.66.1&ua=Googlebot"
curl "https://iplover.com/api/verify-bot.txt?ip=66.249.66.1&ua=Googlebot"
Campos principais
verdict- A resposta: um dos valores abaixo.
claim,botclaimé o robô que o user agent nomeia;boté o robô a que o veredito se refere.identified- Robôs cujas faixas publicadas ou cujo DNS reverso batem com o endereço.
evidence- A verificação do DNS reverso e as listas consultadas, com as datas.
network- O tipo de rede do endereço, como em
/api/check.
Vereditos
verified- O endereço está nas faixas publicadas do robô, ou o DNS reverso dele está confirmado no domínio do operador.
spoofed- O user agent diz ser um robô que publica como verificá-lo, e o endereço não bate: provavelmente falso.
different- O endereço pertence a outro robô conhecido, não ao que ele diz ser.
unverified- O robô informado não publica nada para conferir, ou a lista dele não estava disponível: não dá para afirmar.
notbot- Não diz ser nenhum robô, e o endereço não está nas faixas de nenhum robô.
claim- Só foi informado um user agent: o robô que ele diz ser.
noclaim- Só foi informado um user agent, e ele não nomeia nenhum robô conhecido.
Resposta de exemplo
{
"ip": "66.249.66.1",
"user_agent": "Googlebot",
"verdict": "verified",
"reason": null,
"claim": { "slug": "googlebot", "name": "Googlebot", "operator": "Google", "category": "search", "tokens": ["Googlebot"], "robots": "yes", "verify": "ip" },
"bot": { "slug": "googlebot", … },
"identified": [{ "slug": "googlebot", "name": "Googlebot", "source": "googlebot", "list": "Google common crawlers (Googlebot)", "evidence": "list", … }],
"evidence": {
"reverse_dns": { "name": "crawl-66-249-66-1.googlebot.com", "forward_confirmed": true, "operator_domain": true, … },
"lists": [{ "id": "googlebot", "name": "Google common crawlers (Googlebot)", "fetched_at": "2026-11-16T19:17:44.219Z", "source_time": "2026-11-16T15:45:57.000000", "count": 317, … }]
},
"network": { "primary": "service", "status": "identified", "label": "Company's own network", "crawler": { "name": "Googlebot", "source": "googlebot", "evidence": "list", … }, … },
"owner": "Google LLC",
"asn": { "number": 15169, "name": "Google LLC" },
"known_bots": 34,
"checked_at": "2026-11-16T19:32:09.527Z"
}
Erros: empty, invalid_ip, rate_limited
POST /api/classify
O tipo de rede de até 100 endereços em uma só requisição.
Formato: JSON
Limite: 30 por minuto
Usa só as nossas cópias das listas publicadas: nenhum registro, servidor DNS ou outro serviço é consultado. Por isso é rápido, mas não traz dono nem DNS reverso. O corpo pode ter no máximo 16 KB. Duplicados são unidos, e entradas que não são endereços voltam em invalid. O nosso verificador de logs usa este endpoint.
Parâmetros
ips(corpo JSON)- Uma lista de endereços:
{"ips": ["…"]}. lang(query)- Idioma dos textos legíveis: en, it, de, es, fr, pt. Nomes de campos e códigos ficam sempre em inglês.
Exemplo
curl -X POST https://iplover.com/api/classify \
-H "Content-Type: application/json" \
-d '{"ips": ["8.8.8.8", "185.220.101.1"]}'
Campos principais
results- Uma entrada por endereço:
category,level,verdict,matched(ids das fontes) enetwork. invalid- Entradas que não são endereços IP.
Resposta de exemplo
{
"results": [
{ "ip": "8.8.8.8", "category": "service", "category_label": "Large company's own network", "level": "info", "verdict": "This address is part of Google's own network.", "matched": ["google"], "network": { "primary": "service", "status": "identified", "label": "Company's own network", … } },
{ "ip": "185.220.101.1", "category": "tor", "category_label": "Tor exit node", "level": "warn", "verdict": "This is a Tor exit node.", "matched": ["tor", "x4bnet-vpn"], "network": { "primary": "tor", "status": "identified", "label": "Tor exit node", "types": [{ "type": "tor", … }, { "type": "vpn", "label": "Known VPN range (community list)", "attribution": "Source: X4BNet lists_vpn (CC BY-SA 4.0)", … }], … } }
],
"invalid": [],
"checked_at": "2026-11-16T19:21:02.311Z",
"note": "Network types from published lists only. Nothing you send is stored. …"
}
Erros: invalid_json, no_ips, invalid_ip, method_not_allowed, too_large, too_many, no_public_ips, rate_limited, unavailable
GET /api/asn/index
- GET
/api/asn/{gen}/v{family}/{shard}/{hash} - GET
/api/asn/n/{shard}/{hash}
Uma tabela endereço → rede, em pedaços pequenos, para consultas no navegador.
Formato: JSON · binary · text
Limite: 30 por minuto (só contam as requisições que o nosso cache não consegue responder)
O nosso teste de WebRTC e o verificador de logs usam essa tabela para achar a rede de um endereço sem enviá-lo a lugar nenhum: baixe o índice, pegue o último pedaço que começa no endereço ou antes dele, e procure nele. O formato binário está no arquivo OpenAPI, e há um leitor em /js/asnmap.js. Nomes e países das redes estão em 256 pedaços de texto: a rede n fica no pedaço n % 256. Reconstruída todos os dias a partir do iptoasn.com (domínio público). Se você precisa da tabela inteira, baixe direto do iptoasn.com.
Exemplo
curl https://iplover.com/api/asn/index
Resposta de exemplo
{
"gen": 1,
"fetched_at": "2026-11-16T09:37:04.503Z",
"source_date": "2026-11-01T09:38:43.000Z",
"source": "https://iptoasn.com/",
"license": "PDDL 1.0 (public domain)",
"rows": { "v4": 405962, "v6": 94218 },
"v4": [0, 93810688, 136380928, …],
"v6": ["0000000000000000", …],
"h4": ["9c1e04aa", …],
"h6": ["51f0c2d7", …],
"hn": ["0be2a1c4", …]
}
Erros: not_found, rate_limited, unavailable
Erros
Os erros vêm em JSON, com um código error estável e uma message legível. A mensagem está em inglês e o texto pode mudar, então use o código. Endpoints de texto simples retornam a mensagem como texto, com o mesmo código de status.
HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json; charset=utf-8
{
"error": "rate_limited",
"message": "Too many checks. Try again in a minute."
}
| Código | Status | Significado |
|---|---|---|
invalid_ip | 400 | Não é um endereço IPv4 nem IPv6. |
empty | 400 | Nem ip nem ua foram informados. |
invalid_json | 400 | O corpo não é um JSON válido. |
no_ips | 400 | Falta a lista ips, ou ela está vazia. |
method_not_allowed | 405 | Método errado: use POST. |
not_found | 404 | Esse pedaço não existe, ou a tabela ainda não foi criada. |
too_large | 413 | O corpo passa de 16 KB. |
too_many | 413 | Mais de 100 endereços. |
not_public | 422 | Um endereço privado, reservado ou de uso especial. kind diz qual. |
no_public_ips | 422 | Só endereços privados ou reservados. |
rate_limited | 429 | Requisições demais: espere os segundos indicados em Retry-After (60). |
unavailable | 503 | Um problema temporário do nosso lado: tente de novo em um minuto. |
Limites de requisições
- Os limites valem por visitante: um endereço IPv4, ou um /64 de IPv6 (uma conexão costuma controlar um /64 inteiro).
- Cada endpoint permite 30 requisições por minuto. Os endpoints que contatam outros servidores (
/json/<ip>,/api/checke/api/verify-botcom um endereço) também dividem um orçamento comum de 60 por minuto, para que usar vários ao mesmo tempo não o multiplique. /ipe/jsonnão têm limite. Na tabela de redes, só contam as requisições que o nosso cache não consegue responder.- Acima do limite, você recebe
429comRetry-After: 60. Espere e depois continue: não tente de novo em um loop contínuo. - Os contadores ficam em cada local da Cloudflare e são aproximados. Se o abuso exigir, vamos reduzi-los e avisar aqui.
Exemplos de código
Cada exemplo verifica um endereço e espera quando atinge o limite.
curl
# -f faz o curl falhar em 4xx e 5xx; --retry espera e tenta de novo com 429
curl -sf https://iplover.com/api/check/8.8.8.8 || echo "failed: see the status code"
curl -s --retry 3 --retry-delay 60 https://iplover.com/json
Python
# pip install requests
import time
import requests
def check(ip, lang="en"):
while True:
r = requests.get(f"https://iplover.com/api/check/{ip}",
params={"lang": lang}, timeout=20,
headers={"User-Agent": "my-app/1.0 (+https://example.com)"})
if r.status_code == 429: # rate limited: wait, then retry
time.sleep(int(r.headers.get("Retry-After", "60")))
continue
r.raise_for_status()
return r.json()
result = check("8.8.8.8")
print(result["category"], "-", result["verdict"])
# Up to 100 addresses at once, from the lists only
r = requests.post("https://iplover.com/api/classify",
json={"ips": ["8.8.8.8", "185.220.101.1"]}, timeout=20)
for item in r.json()["results"]:
print(item["ip"], item["category"])
JavaScript
// Works in browsers (CORS is open), Node 18+, Deno and Workers.
async function check(ip, lang = "en") {
for (;;) {
const res = await fetch(`https://iplover.com/api/check/${encodeURIComponent(ip)}?lang=${lang}`);
if (res.status === 429) {
// Rate limited: wait Retry-After seconds, then retry.
const wait = Number(res.headers.get("Retry-After") || 60);
await new Promise((resolve) => setTimeout(resolve, wait * 1000));
continue;
}
const body = await res.json();
if (!res.ok) throw new Error(`${body.error}: ${body.message}`);
return body;
}
}
const result = await check("8.8.8.8");
console.log(result.category, result.verdict, result.network?.label);
Versões e mudanças
- A versão atual é a 1.3.0. Não há versão na URL.
- Podemos adicionar campos e valores novos a qualquer momento: ignore os que você não conhece.
- Não vamos remover nem renomear um campo documentado, nem mudar o significado dele, sem avisar aqui com pelo menos 30 dias de antecedência, exceto para conter abuso ou cumprir a lei.
- Os textos legíveis (vereditos, rótulos, mensagens) podem ser reescritos a qualquer momento. Não faça parsing deles: use os códigos.
Mudanças
- 1.3.0 ():
asnganhacountryeregistry: o país e o registro da alocação a que o endereço pertence (pela Team Cymru), não uma localização. O nome do dono agora vem dos objetos role do RIPE quando o titular é só uma conta de manutenção, e um 404 do rdap.org agora consulta também o registro. - 1.2.0 (): O tipo de rede agora pode vir do nome de DNS reverso do endereço (por exemplo
dynamic.pool-…oumob-…) e de palavras de provedor de internet nos nomes da rede; um novo campoevidencediz de onde. - 1.1.0 (): O tipo de rede agora considera todos os nomes da rede (organização e nome no registro, nome do ASN), usa uma lista da comunidade de data centers, diz “Provedor residencial ou empresarial (estimativa)” em vez de “Não identificado” quando os nomes não batem com nada, e tem um novo campo
confidence. - 1.0.0 (): Primeira versão documentada.
Uso livre e uso justo
- Grátis para uso pessoal e comercial, sem chave. Não há garantia nem garantia de disponibilidade: veja os termos de uso.
- Fique dentro dos limites, guarde em cache o que puder e envie um User-Agent com o nome do seu app e uma forma de contato.
- Não use para varrer faixas de endereços nem para montar ou revender uma cópia dos nossos dados. Não use como único motivo para bloquear pessoas: um tipo de rede não é prova de abuso.
- Os resultados incluem dados das fontes listadas em Fontes de dados, cada uma com seus próprios termos. Algumas pedem crédito: mantenha o texto de
attributionquando mostrar esses resultados. - Podemos bloquear sem aviso o tráfego que prejudique o serviço. Dar crédito é bem-vindo, mas não obrigatório.
O que acontece com o que você envia
Não guardamos nem registramos os endereços ou user agents que você envia, nem o seu próprio endereço.
Para responder, /json/<ip>, /api/check e /api/verify-bot enviam o endereço ao rdap.org e aos serviços RDAP dos registros da internet, e o consultam por resolvedores DNS públicos (Cloudflare, ou Google como alternativa), que perguntam à Team Cymru o número da rede. /api/classify e a tabela de redes não enviam nada a ninguém. A Cloudflare, nossa hospedagem, processa cada requisição: veja a política de privacidade.
As outras URLs em /api/ (como /api/email-domain, /api/health e /report.json) atendem às nossas próprias páginas e ao monitoramento. Elas não fazem parte desta API e podem mudar sem aviso.