Verificar minha conexão

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.

Versão 1.3.0 · Arquivo OpenAPI 3.1 · URL base https://iplover.com

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

EndpointO que retornaLimite
GET /ipSeu endereço público em texto simples.Nenhum
GET /jsonSeu 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-botSe um robô é mesmo quem o user agent diz.30 por minuto
mais o orçamento comum de 60 por minuto
POST /api/classifyO tipo de rede de até 100 endereços em uma só requisição.30 por minuto
GET /api/asn/indexUma 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)
text para 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. isp quer dizer que nenhuma lista bateu: uma rede comum.
level
Quanta atenção merece: bad, warn, info, good ou neutral.
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_matched ou not_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…). identified quando uma lista publicada diz isso, estimated quando deduzimos, e marcado como estimativa.
lists
Quantas fontes foram verificadas e o quanto as nossas cópias são recentes.

Categorias

categoryRótulolevel
attackerAtacou os nossos sensoresbad
blocklistedEm uma lista de bloqueiobad
torNó de saída do Torwarn
relayRelay de privacidadeinfo
scannerScanner de internet conhecidoinfo
botRastreador verificadogood
cloudProvedor de nuvem ou hospedageminfo
serviceRede própria de uma grande empresainfo
ispRede de um provedor ou de uma empresaneutral
reservedEndereço privado ou reservadoinfo
unknownDados insuficientesinfo

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, bot
claim é 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) e network.
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ódigoStatusSignificado
invalid_ip400Não é um endereço IPv4 nem IPv6.
empty400Nem ip nem ua foram informados.
invalid_json400O corpo não é um JSON válido.
no_ips400Falta a lista ips, ou ela está vazia.
method_not_allowed405Método errado: use POST.
not_found404Esse pedaço não existe, ou a tabela ainda não foi criada.
too_large413O corpo passa de 16 KB.
too_many413Mais de 100 endereços.
not_public422Um endereço privado, reservado ou de uso especial. kind diz qual.
no_public_ips422Só endereços privados ou reservados.
rate_limited429Requisições demais: espere os segundos indicados em Retry-After (60).
unavailable503Um 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/check e /api/verify-bot com 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.
  • /ip e /json nã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 429 com Retry-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 (): asn ganha country e registry: 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-… ou mob-…) e de palavras de provedor de internet nos nomes da rede; um novo campo evidence diz 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 attribution quando 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.