Controlla la mia connessione

API di iplover

Endpoint gratuiti in JSON e testo semplice: il tuo indirizzo, chi c'è dietro qualsiasi indirizzo, il suo tipo di rete e se un crawler è davvero chi dice di essere. Nessuna chiave, nessuna registrazione, e CORS è aperto, quindi puoi usarla anche dal browser.

Versione 1.3.0 · File OpenAPI 3.1 · URL di base https://iplover.com

Per iniziare

Da un terminale, senza configurare nulla:

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"

Endpoint

EndpointCosa restituisceLimite
GET /ipIl tuo indirizzo pubblico in testo semplice.Nessuno
GET /jsonIl tuo indirizzo, la posizione approssimativa e la rete.Nessuno
GET /json/{ip}Il record del registro e il DNS inverso di qualsiasi indirizzo pubblico.30 al minuto
più il budget comune di 60 al minuto
GET /api/check/{ip}Chi c'è dietro un indirizzo: categoria, tipo di rete e proprietario, con le prove.30 al minuto
più il budget comune di 60 al minuto
GET /api/verify-botSe un crawler è davvero chi dice il suo user agent.30 al minuto
più il budget comune di 60 al minuto
POST /api/classifyIl tipo di rete di un massimo di 100 indirizzi in una sola richiesta.30 al minuto
GET /api/asn/indexUna tabella indirizzo → rete, in piccoli pezzi, per cercare nel browser.30 al minuto
contano solo le richieste a cui la nostra cache non può rispondere

GET /ip

Il tuo indirizzo pubblico in testo semplice.

Formato: text
Limite: Nessuno

curl iplover.com dà la stessa risposta: i client da riga di comando (curl, Wget, HTTPie, xh, PowerShell) ricevono solo l'indirizzo sulla home page. Entrambi funzionano anche in HTTP semplice, per gli script che non seguono i reindirizzamenti.

Esempio

curl iplover.com
curl https://iplover.com/ip
Esempio di risposta
203.0.113.7

GET /json

Il tuo indirizzo, la posizione approssimativa e la rete.

Formato: JSON
Limite: Nessuno

La posizione è la stima di Cloudflare per la tua connessione: di solito la città del gateway del tuo provider, non casa tua. Una VPN o una rete mobile la spostano.

Esempio

curl https://iplover.com/json
Esempio di risposta
{
  "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}

Il record del registro e il DNS inverso di qualsiasi indirizzo pubblico.

Formato: JSON
Limite: 30 al minuto (più il budget comune di 60 al minuto)

Interroghiamo il registro regionale (RDAP) e un resolver DNS pubblico. Se una parte non riesce, resta vuota e status ed errors spiegano perché. Le risposte complete restano in cache per un'ora. Gli indirizzi privati e riservati ricevono un 422 con il loro kind.

Parametri

{ip} (nel percorso)
Un indirizzo IPv4 o IPv6.

Esempio

curl https://iplover.com/json/8.8.8.8
Esempio di risposta
{
  "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
}

Errori: invalid_ip, not_public, rate_limited

GET /api/check/{ip}

Chi c'è dietro un indirizzo: categoria, tipo di rete e proprietario, con le prove.

Formato: JSON · text
Limite: 30 al minuto (più il budget comune di 60 al minuto)

Controlla gli elenchi pubblicati descritti in Fonti dei dati (cloud, grandi aziende, crawler, scanner, Tor, VPN, blocklist), più il registro e il DNS inverso con conferma diretta. Aggiungi .txt per il testo semplice e ?lang= per la lingua dei testi leggibili. Gli indirizzi privati e riservati ricevono un 200 con la categoria reserved.

Parametri

{ip} (nel percorso)
Un indirizzo IPv4 o IPv6.
lang (query)
Lingua dei testi leggibili: en, it, de, es, fr, pt. I nomi dei campi e i codici sono sempre in inglese.
format (query)
text per il testo semplice (come aggiungere .txt).

Esempio

curl https://iplover.com/api/check/8.8.8.8
curl https://iplover.com/api/check/8.8.8.8.txt

Campi principali

category
La corrispondenza più forte, una delle categorie qui sotto. isp significa che nessun elenco corrisponde: una rete normale.
level
Quanta attenzione merita: bad, warn, info, good o neutral.
verdict, explanation, action
Tre frasi nella lingua richiesta: cos'è, perché e cosa fare.
matched
Le fonti che corrispondono, con la prova: un elenco, il DNS inverso o il numero di rete.
sources
Ogni fonte e il suo risultato: matched, not_matched o not_checked. Una fonte che non abbiamo potuto controllare non conta mai come risultato pulito.
owner
Il record del registro: organizzazione, intervallo, contatto abuse e date.
asn
Il numero della rete che annuncia l'indirizzo, e il suo nome.
reverse_dns
Il nome PTR, e se punta di nuovo all'indirizzo (forward_confirmed).
country
Dove è registrato l'intervallo, non dove si trova il dispositivo.
network
Tipo di rete (residenziale, mobile, hosting, VPN, Tor…). identified quando lo dice un elenco pubblicato, estimated quando lo deduciamo, e indicato come stima.
lists
Quante fonti sono state controllate e quanto sono recenti le nostre copie.

Categorie

categoryEtichettalevel
attackerHa attaccato i nostri sensoribad
blocklistedIn una blocklistbad
torNodo di uscita Torwarn
relayRelay per la privacyinfo
scannerScanner di Internet notoinfo
botCrawler verificatogood
cloudProvider cloud o hostinginfo
serviceRete propria di una grande aziendainfo
ispRete di un provider o di un'aziendaneutral
reservedIndirizzo privato o riservatoinfo
unknownDati insufficientiinfo

Le etichette seguono ?lang=. Un tipo di rete come VPN, Tor o hosting non è un segno di abuso; solo attacker e blocklisted riguardano il comportamento.

Esempio di risposta
{
  "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. …"
}

Errori: invalid_ip, rate_limited

GET /api/verify-bot

Se un crawler è davvero chi dice il suo user agent.

Formato: JSON · text
Limite: 30 al minuto (più il budget comune di 60 al minuto)

Indica ip, ua o entrambi. Con un indirizzo, lo confrontiamo con gli intervalli pubblicati dal bot e con il DNS inverso con conferma diretta. Senza, ti diciamo solo quale bot dichiara di essere lo user agent. /api/verify-bot.txt restituisce testo semplice. Le richieste senza indirizzo non contano per il limite.

Parametri

ip (query)
L'indirizzo che ha inviato la richiesta (facoltativo).
ua (query)
Lo User-Agent che ha inviato (facoltativo), fino a 1000 caratteri.
lang (query)
Lingua dei testi leggibili: en, it, de, es, fr, pt. I nomi dei campi e i codici sono sempre in inglese.

Esempio

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"

Campi principali

verdict
La risposta: uno dei valori qui sotto.
claim, bot
claim è il bot nominato dallo user agent; bot è il bot a cui si riferisce il verdetto.
identified
I bot i cui intervalli pubblicati o il cui DNS inverso corrispondono all'indirizzo.
evidence
Il controllo del DNS inverso e gli elenchi consultati, con le loro date.
network
Il tipo di rete dell'indirizzo, come in /api/check.

Verdetti

verified
L'indirizzo è negli intervalli pubblicati dal bot, oppure il suo DNS inverso è confermato sotto il dominio dell'operatore.
spoofed
Lo user agent dichiara un bot che pubblica come verificarlo, e l'indirizzo non corrisponde: probabilmente falso.
different
L'indirizzo appartiene a un bot noto diverso da quello dichiarato.
unverified
Il bot dichiarato non pubblica nulla con cui verificarlo, oppure il suo elenco non era disponibile: non possiamo dirlo.
notbot
Nessun bot dichiarato, e l'indirizzo non è negli intervalli di alcun bot.
claim
È stato indicato solo lo user agent: il bot che dichiara di essere.
noclaim
È stato indicato solo lo user agent, e non nomina nessun bot noto.
Esempio di risposta
{
  "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"
}

Errori: empty, invalid_ip, rate_limited

POST /api/classify

Il tipo di rete di un massimo di 100 indirizzi in una sola richiesta.

Formato: JSON
Limite: 30 al minuto

Usa solo le nostre copie degli elenchi pubblicati: non interroga registri, server DNS o altri servizi. Per questo è veloce, ma non dà proprietario né DNS inverso. Il corpo può essere al massimo di 16 KB. I duplicati vengono uniti e le voci che non sono indirizzi tornano in invalid. La nostra verifica log usa questo endpoint.

Parametri

ips (corpo JSON)
Un elenco di indirizzi: {"ips": ["…"]}.
lang (query)
Lingua dei testi leggibili: en, it, de, es, fr, pt. I nomi dei campi e i codici sono sempre in inglese.

Esempio

curl -X POST https://iplover.com/api/classify \
  -H "Content-Type: application/json" \
  -d '{"ips": ["8.8.8.8", "185.220.101.1"]}'

Campi principali

results
Una voce per indirizzo: category, level, verdict, matched (id delle fonti) e network.
invalid
Le voci che non sono indirizzi IP.
Esempio di risposta
{
  "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. …"
}

Errori: 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}

Una tabella indirizzo → rete, in piccoli pezzi, per cercare nel browser.

Formato: JSON · binary · text
Limite: 30 al minuto (contano solo le richieste a cui la nostra cache non può rispondere)

Il nostro test WebRTC e la verifica log la usano per trovare la rete di un indirizzo senza inviarlo a nessuno: scarica l'indice, prendi l'ultimo pezzo che inizia prima dell'indirizzo (o proprio lì) e cercalo al suo interno. Il formato binario è descritto nel file OpenAPI e un lettore è in /js/asnmap.js. Nomi e paesi delle reti sono in 256 pezzi di testo: la rete n è nel pezzo n % 256. Ricostruita ogni giorno da iptoasn.com (pubblico dominio). Se ti serve la tabella intera, scaricala da iptoasn.com.

Esempio

curl https://iplover.com/api/asn/index
Esempio di risposta
{
  "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", …]
}

Errori: not_found, rate_limited, unavailable

Errori

Gli errori sono in JSON, con un codice error stabile e un message leggibile. Il messaggio è in inglese e il testo può cambiare, quindi basati sul codice. Gli endpoint in testo semplice restituiscono il messaggio come testo, con lo stesso codice di stato.

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."
}
CodiceStatoSignificato
invalid_ip400Non è un indirizzo IPv4 o IPv6.
empty400Non sono stati indicati né ip né ua.
invalid_json400Il corpo non è JSON valido.
no_ips400Manca l'elenco ips, oppure è vuoto.
method_not_allowed405Metodo sbagliato: usa POST.
not_found404Il pezzo non esiste, oppure la tabella non è ancora pronta.
too_large413Il corpo supera 16 KB.
too_many413Più di 100 indirizzi.
not_public422Un indirizzo privato, riservato o per usi speciali. kind dice quale.
no_public_ips422Solo indirizzi privati o riservati.
rate_limited429Troppe richieste: aspetta i secondi indicati in Retry-After (60).
unavailable503Un problema temporaneo da parte nostra: riprova tra un minuto.

Limiti di richieste

  • I limiti valgono per visitatore: un indirizzo IPv4, oppure un /64 IPv6 (di solito una connessione controlla un intero /64).
  • Ogni endpoint consente 30 richieste al minuto. Gli endpoint che contattano altri server (/json/<ip>, /api/check e /api/verify-bot con un indirizzo) condividono anche un budget comune di 60 al minuto, così usarne diversi insieme non lo moltiplica.
  • /ip e /json non hanno limiti. Per la tabella delle reti contano solo le richieste a cui la nostra cache non può rispondere.
  • Oltre il limite ricevi 429 con Retry-After: 60. Aspetta, poi continua: non riprovare in un ciclo continuo.
  • I contatori sono tenuti in ogni sede di Cloudflare e sono approssimativi. Se l'abuso lo rende necessario, li abbasseremo e lo scriveremo qui.

Esempi di codice

Ogni esempio controlla un indirizzo e aspetta quando riceve il limite di richieste.

curl

# -f fa fallire curl su 4xx e 5xx; --retry aspetta e riprova su 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);

Versioni e modifiche

  • La versione attuale è la 1.3.0. Nell'URL non c'è nessuna versione.
  • Possiamo aggiungere nuovi campi e nuovi valori in qualsiasi momento: ignora quelli che non conosci.
  • Non rimuoveremo né rinomineremo un campo documentato, e non ne cambieremo il significato, senza annunciarlo qui almeno 30 giorni prima, salvo per fermare un abuso o rispettare la legge.
  • I testi leggibili (verdetti, etichette, messaggi) possono cambiare formulazione in qualsiasi momento. Non analizzarli: usa i codici.

Modifiche

  • 1.3.0 (): asn ha due nuovi campi, country e registry: il paese e il registro dell'allocazione a cui appartiene l'indirizzo (da Team Cymru), non una posizione. Il nome del proprietario ora viene dagli oggetti role di RIPE quando il registrante è solo un account di manutenzione, e un 404 di rdap.org ora interroga anche il registro.
  • 1.2.0 (): Il tipo di rete ora può derivare dal nome DNS inverso dell'indirizzo (per esempio dynamic.pool-… o mob-…) e dalle parole da provider internet nei nomi della rete; un nuovo campo evidence dice da quale.
  • 1.1.0 (): Il tipo di rete ora considera tutti i nomi della rete (organizzazione e nome nel registro, nome dell'ASN), usa un elenco di data center della comunità, indica «ISP residenziale o aziendale (stima)» invece di «Non identificato» quando i nomi non corrispondono a nulla, e ha un nuovo campo confidence.
  • 1.0.0 (): Prima versione documentata.

Uso libero e uso corretto

  • Gratis per uso personale e commerciale, senza chiave. Non c'è garanzia né garanzia di disponibilità: vedi i termini di utilizzo.
  • Resta entro i limiti, metti in cache quello che puoi e invia uno User-Agent con il nome della tua app e un modo per contattarti.
  • Non usarla per scansionare intervalli di indirizzi né per costruire o rivendere una copia dei nostri dati. Non usarla come unico motivo per bloccare le persone: un tipo di rete non è una prova di abuso.
  • I risultati includono dati delle fonti elencate in Fonti dei dati, ognuna con le proprie condizioni. Alcune chiedono di essere citate: mantieni il testo di attribution quando mostri quei risultati.
  • Possiamo bloccare senza preavviso il traffico che danneggia il servizio. Una citazione è gradita ma non obbligatoria.

Cosa succede a ciò che invii

Non conserviamo né registriamo gli indirizzi o gli user agent che invii, né il tuo indirizzo.

Per rispondere, /json/<ip>, /api/check e /api/verify-bot inviano l'indirizzo a rdap.org e ai servizi RDAP dei registri internet, e lo cercano tramite resolver DNS pubblici (Cloudflare, o Google come riserva), che chiedono a Team Cymru il numero di rete. /api/classify e la tabella delle reti non inviano nulla a nessuno. Cloudflare, che ci ospita, elabora ogni richiesta: vedi l'informativa sulla privacy.

Gli altri URL sotto /api/ (come /api/email-domain, /api/health e /report.json) servono le nostre pagine e il monitoraggio. Non fanno parte di questa API e possono cambiare senza preavviso.