Vérifier ma connexion

API d'iplover

Des points d'accès gratuits en JSON et en texte brut : votre propre adresse, qui est derrière n'importe quelle adresse, son type de réseau, et si un robot d'exploration est bien celui qu'il prétend être. Sans clé ni inscription, avec CORS ouvert : vous pouvez aussi l'appeler depuis un navigateur.

Version 1.3.0 · Fichier OpenAPI 3.1 · URL de base https://iplover.com

Démarrage rapide

Depuis un terminal, sans rien configurer :

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"

Points d'accès

Point d'accèsCe qu'il renvoieLimite
GET /ipVotre adresse publique en texte brut.Aucune
GET /jsonVotre adresse, votre position approximative et votre réseau.Aucune
GET /json/{ip}L'enregistrement du registre et le DNS inverse de n'importe quelle adresse publique.30 par minute
plus le budget commun de 60 par minute
GET /api/check/{ip}Qui est derrière une adresse : catégorie, type de réseau et titulaire, avec les preuves.30 par minute
plus le budget commun de 60 par minute
GET /api/verify-botSi un robot d'exploration est bien celui que son user agent annonce.30 par minute
plus le budget commun de 60 par minute
POST /api/classifyLe type de réseau de 100 adresses au plus en une seule requête.30 par minute
GET /api/asn/indexUne table adresse → réseau, en petits morceaux, pour chercher dans le navigateur.30 par minute
seules comptent les requêtes auxquelles notre cache ne peut pas répondre

GET /ip

Votre adresse publique en texte brut.

Format: text
Limite: Aucune

curl iplover.com donne la même réponse : les clients en ligne de commande (curl, Wget, HTTPie, xh, PowerShell) reçoivent seulement l'adresse sur la page d'accueil. Les deux fonctionnent aussi en HTTP simple, pour les scripts qui ne suivent pas les redirections.

Exemple

curl iplover.com
curl https://iplover.com/ip
Exemple de réponse
203.0.113.7

GET /json

Votre adresse, votre position approximative et votre réseau.

Format: JSON
Limite: Aucune

La position est l'estimation de Cloudflare pour votre connexion : en général la ville de la passerelle de votre fournisseur, pas votre domicile. Un VPN ou un réseau mobile la déplace.

Exemple

curl https://iplover.com/json
Exemple de réponse
{
  "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}

L'enregistrement du registre et le DNS inverse de n'importe quelle adresse publique.

Format: JSON
Limite: 30 par minute (plus le budget commun de 60 par minute)

Nous interrogeons le registre régional (RDAP) et un résolveur DNS public. Si une partie échoue, elle reste vide et status et errors indiquent pourquoi. Les réponses complètes sont mises en cache une heure. Les adresses privées et réservées reçoivent un 422 avec leur kind.

Paramètres

{ip} (dans le chemin)
Une adresse IPv4 ou IPv6.

Exemple

curl https://iplover.com/json/8.8.8.8
Exemple de réponse
{
  "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
}

Erreurs: invalid_ip, not_public, rate_limited

GET /api/check/{ip}

Qui est derrière une adresse : catégorie, type de réseau et titulaire, avec les preuves.

Format: JSON · text
Limite: 30 par minute (plus le budget commun de 60 par minute)

Vérifie les listes publiées décrites dans Sources de données (clouds, grandes entreprises, robots d'exploration, scanners, Tor, VPN, listes de blocage), ainsi que le registre et le DNS inverse confirmé dans les deux sens. Ajoutez .txt pour du texte brut et ?lang= pour la langue des textes lisibles. Les adresses privées et réservées reçoivent un 200 avec la catégorie reserved.

Paramètres

{ip} (dans le chemin)
Une adresse IPv4 ou IPv6.
lang (query)
Langue des textes lisibles : en, it, de, es, fr, pt. Les noms de champs et les codes restent toujours en anglais.
format (query)
text pour du texte brut (comme ajouter .txt).

Exemple

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

Champs principaux

category
La correspondance la plus forte, l'une des catégories ci-dessous. isp signifie qu'aucune liste ne correspond : un réseau ordinaire.
level
L'attention qu'elle mérite : bad, warn, info, good ou neutral.
verdict, explanation, action
Trois phrases dans la langue demandée : ce que c'est, pourquoi, et que faire.
matched
Les sources qui correspondent, avec la preuve : une liste, le DNS inverse ou le numéro de réseau.
sources
Chaque source et son résultat : matched, not_matched ou not_checked. Une source que nous n'avons pas pu vérifier ne compte jamais comme un résultat sans problème.
owner
L'enregistrement du registre : organisation, plage, contact abuse et dates.
asn
Le numéro du réseau qui annonce l'adresse, et son nom.
reverse_dns
Le nom PTR, et s'il renvoie bien vers l'adresse (forward_confirmed).
country
Le pays où la plage est enregistrée, pas celui où se trouve l'appareil.
network
Type de réseau (résidentiel, mobile, hébergement, VPN, Tor…). identified quand une liste publiée le dit, estimated quand nous le déduisons, et alors signalé comme une estimation.
lists
Combien de sources ont été vérifiées, et la fraîcheur de nos copies.

Catégories

categoryLibellélevel
attackerA attaqué nos capteursbad
blocklistedSur une liste de blocagebad
torNœud de sortie Torwarn
relayRelais de confidentialitéinfo
scannerScanner d'Internet connuinfo
botRobot d'exploration vérifiégood
cloudFournisseur cloud ou hébergeurinfo
serviceRéseau propre d'une grande entrepriseinfo
ispRéseau d'un fournisseur d'accès ou d'une entrepriseneutral
reservedAdresse privée ou réservéeinfo
unknownDonnées insuffisantesinfo

Les libellés suivent ?lang=. Un type de réseau comme VPN, Tor ou hébergement n'est pas un signe d'abus ; seules attacker et blocklisted concernent le comportement.

Exemple de réponse
{
  "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. …"
}

Erreurs: invalid_ip, rate_limited

GET /api/verify-bot

Si un robot d'exploration est bien celui que son user agent annonce.

Format: JSON · text
Limite: 30 par minute (plus le budget commun de 60 par minute)

Indiquez ip, ua ou les deux. Avec une adresse, nous la comparons aux plages publiées du robot et au DNS inverse confirmé. Sans adresse, nous vous disons seulement quel robot le user agent prétend être. /api/verify-bot.txt renvoie du texte brut. Les requêtes sans adresse ne comptent pas dans la limite.

Paramètres

ip (query)
L'adresse qui a envoyé la requête (facultatif).
ua (query)
Le User-Agent qu'elle a envoyé (facultatif), jusqu'à 1000 caractères.
lang (query)
Langue des textes lisibles : en, it, de, es, fr, pt. Les noms de champs et les codes restent toujours en anglais.

Exemple

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"

Champs principaux

verdict
La réponse : l'une des valeurs ci-dessous.
claim, bot
claim est le robot que nomme le user agent ; bot est le robot dont parle le verdict.
identified
Les robots dont les plages publiées ou le DNS inverse correspondent à l'adresse.
evidence
La vérification du DNS inverse et les listes consultées, avec leurs dates.
network
Le type de réseau de l'adresse, comme dans /api/check.

Verdicts

verified
L'adresse est dans les plages publiées du robot, ou son DNS inverse est confirmé sous le domaine de l'opérateur.
spoofed
Le user agent annonce un robot qui publie comment le vérifier, et l'adresse ne correspond pas : probablement un faux.
different
L'adresse appartient à un autre robot connu que celui annoncé.
unverified
Le robot annoncé ne publie rien pour le vérifier, ou sa liste n'était pas disponible : impossible de trancher.
notbot
Aucun robot annoncé, et l'adresse n'est dans les plages d'aucun robot.
claim
Seul un user agent a été donné : le robot qu'il prétend être.
noclaim
Seul un user agent a été donné, et il ne nomme aucun robot connu.
Exemple de réponse
{
  "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"
}

Erreurs: empty, invalid_ip, rate_limited

POST /api/classify

Le type de réseau de 100 adresses au plus en une seule requête.

Format: JSON
Limite: 30 par minute

Utilise seulement nos copies des listes publiées : aucun registre, serveur DNS ou autre service n'est interrogé. C'est donc rapide, mais sans titulaire ni DNS inverse. Le corps fait au plus 16 Ko. Les doublons sont fusionnés, et les entrées qui ne sont pas des adresses reviennent dans invalid. Notre analyse de journaux utilise ce point d'accès.

Paramètres

ips (corps JSON)
Une liste d'adresses : {"ips": ["…"]}.
lang (query)
Langue des textes lisibles : en, it, de, es, fr, pt. Les noms de champs et les codes restent toujours en anglais.

Exemple

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

Champs principaux

results
Une entrée par adresse : category, level, verdict, matched (identifiants des sources) et network.
invalid
Les entrées qui ne sont pas des adresses IP.
Exemple de réponse
{
  "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. …"
}

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

Une table adresse → réseau, en petits morceaux, pour chercher dans le navigateur.

Format: JSON · binary · text
Limite: 30 par minute (seules comptent les requêtes auxquelles notre cache ne peut pas répondre)

Notre test WebRTC et l'analyse de journaux s'en servent pour trouver le réseau d'une adresse sans l'envoyer nulle part : téléchargez l'index, prenez le dernier morceau qui commence à l'adresse ou avant, et cherchez dedans. Le format binaire est décrit dans le fichier OpenAPI, et un lecteur se trouve dans /js/asnmap.js. Les noms et pays des réseaux sont dans 256 morceaux de texte : le réseau n est dans le morceau n % 256. Reconstruite chaque jour à partir d'iptoasn.com (domaine public). Si vous avez besoin de la table entière, téléchargez-la plutôt sur iptoasn.com.

Exemple

curl https://iplover.com/api/asn/index
Exemple de réponse
{
  "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", …]
}

Erreurs: not_found, rate_limited, unavailable

Erreurs

Les erreurs sont en JSON, avec un code error stable et un message lisible. Le message est en anglais et sa formulation peut changer : fiez-vous au code. Les points d'accès en texte brut renvoient le message sous forme de texte, avec le même code de statut.

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."
}
CodeStatutSignification
invalid_ip400Ce n'est pas une adresse IPv4 ou IPv6.
empty400Ni ip ni ua n'a été indiqué.
invalid_json400Le corps n'est pas du JSON valide.
no_ips400Pas de liste ips, ou elle est vide.
method_not_allowed405Mauvaise méthode : utilisez POST.
not_found404Ce morceau n'existe pas, ou la table n'est pas encore construite.
too_large413Le corps dépasse 16 Ko.
too_many413Plus de 100 adresses.
not_public422Une adresse privée, réservée ou à usage spécial. kind indique laquelle.
no_public_ips422Seulement des adresses privées ou réservées.
rate_limited429Trop de requêtes : attendez le nombre de secondes indiqué dans Retry-After (60).
unavailable503Un problème temporaire de notre côté : réessayez dans une minute.

Limites de requêtes

  • Les limites s'appliquent par visiteur : une adresse IPv4, ou un /64 IPv6 (une connexion contrôle généralement un /64 entier).
  • Chaque point d'accès autorise 30 requêtes par minute. Les points d'accès qui contactent d'autres serveurs (/json/<ip>, /api/check, et /api/verify-bot avec une adresse) partagent aussi un budget commun de 60 par minute, pour qu'en utiliser plusieurs à la fois ne le multiplie pas.
  • /ip et /json n'ont pas de limite. Pour la table des réseaux, seules comptent les requêtes auxquelles notre cache ne peut pas répondre.
  • Au-delà de la limite, vous recevez 429 avec Retry-After: 60. Attendez, puis continuez : ne réessayez pas en boucle serrée.
  • Les compteurs sont tenus dans chaque site de Cloudflare et sont approximatifs. Si des abus l'imposent, nous les abaisserons et l'indiquerons ici.

Exemples de code

Chaque exemple vérifie une adresse et attend quand la limite est atteinte.

curl

# -f fait échouer curl sur 4xx et 5xx ; --retry attend et réessaie sur 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);

Versions et changements

  • La version actuelle est la 1.3.0. L'URL ne contient pas de version.
  • Nous pouvons ajouter de nouveaux champs et de nouvelles valeurs à tout moment : ignorez ceux que vous ne connaissez pas.
  • Nous ne supprimerons ni ne renommerons un champ documenté, et n'en changerons pas le sens, sans l'annoncer ici au moins 30 jours à l'avance, sauf pour stopper un abus ou respecter la loi.
  • Les textes lisibles (verdicts, libellés, messages) peuvent être reformulés à tout moment. Ne les analysez pas : utilisez les codes.

Changements

  • 1.3.0 (): asn gagne country et registry : le pays et le registre de l'allocation dont fait partie l'adresse (d'après Team Cymru), pas une localisation. Le nom du titulaire vient désormais des objets role de RIPE quand le titulaire n'est qu'un compte de maintenance, et un 404 de rdap.org interroge désormais aussi le registre.
  • 1.2.0 (): Le type de réseau peut désormais venir du nom DNS inverse de l'adresse (par exemple dynamic.pool-… ou mob-…) et de mots de fournisseur d'accès dans les noms du réseau ; un nouveau champ evidence indique lequel.
  • 1.1.0 (): Le type de réseau tient désormais compte de tous les noms du réseau (organisation et nom au registre, nom de l'ASN), utilise une liste communautaire de centres de données, indique « FAI résidentiel ou professionnel (estimation) » au lieu de « Non identifié » quand les noms ne correspondent à rien, et a un nouveau champ confidence.
  • 1.0.0 (): Première version documentée.

Utilisation libre et raisonnable

  • Gratuite pour un usage personnel et commercial, sans clé. Aucune garantie, ni de disponibilité : voir les conditions d'utilisation.
  • Restez dans les limites, mettez en cache ce que vous pouvez, et envoyez un User-Agent qui nomme votre application avec un moyen de vous joindre.
  • Ne l'utilisez pas pour balayer des plages d'adresses, ni pour constituer ou revendre une copie de nos données. Ne l'utilisez pas comme seule raison de bloquer des personnes : un type de réseau n'est pas une preuve d'abus.
  • Les résultats contiennent des données des sources listées dans Sources de données, chacune sous ses propres conditions. Certaines demandent à être citées : conservez le texte attribution quand vous affichez ces résultats.
  • Nous pouvons bloquer sans préavis le trafic qui nuit au service. Nous citer est apprécié, mais pas obligatoire.

Ce que deviennent vos données

Nous ne conservons ni n'enregistrons les adresses ou les user agents que vous envoyez, ni votre propre adresse.

Pour répondre, /json/<ip>, /api/check et /api/verify-bot envoient l'adresse à rdap.org et aux services RDAP des registres internet, et la recherchent via des résolveurs DNS publics (Cloudflare, ou Google en secours), qui demandent à Team Cymru son numéro de réseau. /api/classify et la table des réseaux n'envoient rien à personne. Cloudflare, notre hébergeur, traite chaque requête : voir la politique de confidentialité.

Les autres URL sous /api/ (comme /api/email-domain, /api/health et /report.json) servent nos propres pages et la surveillance. Elles ne font pas partie de cette API et peuvent changer sans préavis.