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.
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ès | Ce qu'il renvoie | Limite |
|---|---|---|
GET /ip | Votre adresse publique en texte brut. | Aucune |
GET /json | Votre 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-bot | Si 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/classify | Le type de réseau de 100 adresses au plus en une seule requête. | 30 par minute |
GET /api/asn/index | Une 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)textpour 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.
ispsignifie qu'aucune liste ne correspond : un réseau ordinaire. level- L'attention qu'elle mérite :
bad,warn,info,goodouneutral. 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_matchedounot_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…).
identifiedquand une liste publiée le dit,estimatedquand 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
category | Libellé | level |
|---|---|---|
attacker | A attaqué nos capteurs | bad |
blocklisted | Sur une liste de blocage | bad |
tor | Nœud de sortie Tor | warn |
relay | Relais de confidentialité | info |
scanner | Scanner d'Internet connu | info |
bot | Robot d'exploration vérifié | good |
cloud | Fournisseur cloud ou hébergeur | info |
service | Réseau propre d'une grande entreprise | info |
isp | Réseau d'un fournisseur d'accès ou d'une entreprise | neutral |
reserved | Adresse privée ou réservée | info |
unknown | Données insuffisantes | info |
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,botclaimest le robot que nomme le user agent ;botest 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) etnetwork. 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."
}
| Code | Statut | Signification |
|---|---|---|
invalid_ip | 400 | Ce n'est pas une adresse IPv4 ou IPv6. |
empty | 400 | Ni ip ni ua n'a été indiqué. |
invalid_json | 400 | Le corps n'est pas du JSON valide. |
no_ips | 400 | Pas de liste ips, ou elle est vide. |
method_not_allowed | 405 | Mauvaise méthode : utilisez POST. |
not_found | 404 | Ce morceau n'existe pas, ou la table n'est pas encore construite. |
too_large | 413 | Le corps dépasse 16 Ko. |
too_many | 413 | Plus de 100 adresses. |
not_public | 422 | Une adresse privée, réservée ou à usage spécial. kind indique laquelle. |
no_public_ips | 422 | Seulement des adresses privées ou réservées. |
rate_limited | 429 | Trop de requêtes : attendez le nombre de secondes indiqué dans Retry-After (60). |
unavailable | 503 | Un 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-botavec une adresse) partagent aussi un budget commun de 60 par minute, pour qu'en utiliser plusieurs à la fois ne le multiplie pas. /ipet/jsonn'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
429avecRetry-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 ():
asngagnecountryetregistry: 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-…oumob-…) et de mots de fournisseur d'accès dans les noms du réseau ; un nouveau champevidenceindique 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
attributionquand 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.