Documentation API
API REST publique pour la géolocalisation IP, les outils réseau et la vérification de sécurité.
https://mon-ip.devClé API
L'API est accessible publiquement sans authentification. Pour bénéficier de limites plus élevées, créez un compte et générez une clé API depuis votre tableau de bord. Ouvrir le tableau de bord →
Transmettez votre clé via le header Authorization :
Rate limiting
Les requêtes sont limitées selon votre niveau d'accès. En cas de dépassement, l'API retourne une erreur 429 Too Many Requests.
Chaque réponse inclut des headers pour suivre votre consommation :
X-RateLimit-LimitNombre max de requêtes autorisées par heureX-RateLimit-RemainingRequêtes restantes dans la fenêtre couranteX-RateLimit-ResetTimestamp UNIX de réinitialisation du compteurCodes d'erreur
En cas d'erreur, la réponse contient un champ error avec un message descriptif.
Terminal (curl)
Sans clé ni paramètre : interrogez directement la racine du site depuis curl, wget, HTTPie ou PowerShell. Réponses non mises en cache, CORS autorisé.
/ Renvoie votre adresse IP publique en texte brut, suivie d’un saut de ligne, lorsque la requête vient d’un client en ligne de commande (curl, wget, HTTPie, PowerShell…). Le chemin /ip renvoie la même réponse depuis n’importe quel client.
/json Géolocalisation et informations réseau de votre IP, au format JSON indenté (lisible directement dans le terminal).
ipstringAdresse IP analyséeipTypestringVersion : IPv4 ou IPv6ipClassstringClasse d'IP (A, B, C)hostnamestringReverse DNScountrystringPayscountryCodestringCode pays ISO 3166-1 (2 lettres)citystringVillecontinentstringContinentpostalCodestringCode postal (si connu)latitudenumberLatitude approximativelongitudenumberLongitude approximativetimezonestringFuseau horaire (IANA)providerstringFournisseur d’accès ou opérateurasnnumberNuméro de système autonome (AS)/{ip}/json Mêmes informations pour n’importe quelle adresse IPv4 ou IPv6 passée dans le chemin. Les champs absents ne sont pas renvoyés.
iprequisAdresse IPv4 ou IPv6 à analyser, dans le chemin (ex : 8.8.8.8)IP & Géolocalisation
/api/v1/json Retourne les informations de géolocalisation, FAI et sécurité de l'IP du client.
ipstringAdresse IPv4ipv6stringAdresse IPv6 (si disponible)hostnamestringReverse DNStypestringType d'IP (Residential, Business, etc.)classstringClasse d'IP (A, B, C)locationobjectcountry, countryCode, city, continent, latitude, longitude, timezone, postalCodenetworkobjectprovider, asnsecurityobjectIndicateurs de sécurité (proxy, VPN, Tor, etc.)/api/v1/ipv6 Détecte si le client se connecte en IPv4 ou IPv6.
ipstringAdresse IP du clientis_ipv4booleantrue si IPv4is_ipv6booleantrue si IPv6 natifprotocolstring"IPv4" ou "IPv6"timestampstringHorodatage ISO 8601DNS & Domaines
/api/v1/dns Effectue une résolution DNS pour un type d’enregistrement donné.
hostrequisNom de domaine (ex: google.com)record_typerequisType : A, AAAA, MX, NS, TXT, CNAME, SOA, PTR, SRVhoststringDomaine interrogérecordsarrayListe d'enregistrements : record_type, value, ttl/api/v1/whois Retourne les informations WHOIS d'un domaine ou d'une IP.
targetrequisDomaine ou IP (ex: google.com)targetstringCible interrogéerawstringRéponse WHOIS bruteparsedobjectdomain_name, registrar, creation_date, expiration_date, name_servers, status, dnsseccachedbooleantrue si le résultat provient du cache/api/v1/ssl Vérifie le certificat SSL/TLS d'un domaine en se connectant au port 443.
hostrequisNom de domaine (ex: google.com)hoststringDomaine testévalidbooleantrue si le certificat est validedays_remainingnumberJours avant expirationsubjectstringSujet (CN)issuerstringÉmetteur (CN)issuer_orgstringOrganisation de l'émetteurvalid_fromstringDate de début (ISO 8601)valid_tostringDate d'expiration (ISO 8601)serialstringNuméro de sériefingerprintstringEmpreinte SHA-256protocolstringProtocole TLS (ex: TLSv1.3)bitsnumber | nullTaille de clé en bitsalt_namesstring[]Noms alternatifs (SAN)Sécurité
/api/v1/blacklist Vérifie si une adresse IPv4 est listée dans 8 listes noires DNS.
iprequisAdresse IPv4 (ex: 8.8.8.8)ipstringIP testéetotalnumberNombre de listes testéeslistednumberNombre de listes où l’IP apparaîtcleanbooleantrue si l'IP n'est dans aucune listeresultsarrayDétail par liste : name, zone, listedRéseau
/api/v1/ping SSEEnvoie des paquets ICMP et retourne les résultats en temps réel via Server-Sent Events.
hostrequisHôte ou IP (ex: 8.8.8.8)countoptionnelNombre de paquets (défaut: 4)starthost, resolved_ipreplyseq, ip, time_ms, ttltimeoutseqdonealive, packets_sent, packets_received, packet_loss, min_ms, avg_ms, max_mserrormessage/api/v1/traceroute SSETrace le chemin réseau vers un hôte en temps réel via Server-Sent Events.
hostrequisHôte ou IP (ex: google.com)starthost, resolved_iphophop, ip, hostname, rtt_msdonetotal_hops, reachederrormessageEventSource / curl -NAccédez à votre IP depuis le terminal
Utilisez notre API ou la commande curl pour intégrer mon-ip.dev à vos scripts.