API v1

Documentation API

API REST publique pour la géolocalisation IP, les outils réseau et la vérification de sécurité.

RESTJSONSSECORS Base URLhttps://mon-ip.dev
Authentification

Clé 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 :

Header HTTP
Authorization: Bearer mk_votre_cle_api
Exemple · curl
$ curl https://mon-ip.dev/api/v1/json -H "Authorization: Bearer mk_a1b2c3d4e5f6..."
Limites

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.

TierPar heurePar jourClés max
Public100 / IP500 / IP—
Free1 00010 0005
Probientôt10 000100 00020
Headers de réponse

Chaque réponse inclut des headers pour suivre votre consommation :

X-RateLimit-LimitNombre max de requêtes autorisées par heure
X-RateLimit-RemainingRequêtes restantes dans la fenêtre courante
X-RateLimit-ResetTimestamp UNIX de réinitialisation du compteur
Erreurs

Codes d'erreur

En cas d'erreur, la réponse contient un champ error avec un message descriptif.

400Paramètre manquant ou invalide
401Clé API invalide ou révoquée
429Limite de requêtes dépassée (rate limit)
502Erreur de connexion au service interne
500Erreur interne du serveur
429 Too Many Requests
{
"error": "Rate limit exceeded",
"limit": 100,
"reset": 1709913600
}

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é.

GET /

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.

Requête
$ curl mon-ip.dev
Réponse · text/plain
203.0.113.42
GET /json

Géolocalisation et informations réseau de votre IP, au format JSON indenté (lisible directement dans le terminal).

Réponse JSON
ipstringAdresse IP analysée
ipTypestringVersion : IPv4 ou IPv6
ipClassstringClasse d'IP (A, B, C)
hostnamestringReverse DNS
countrystringPays
countryCodestringCode pays ISO 3166-1 (2 lettres)
citystringVille
continentstringContinent
postalCodestringCode postal (si connu)
latitudenumberLatitude approximative
longitudenumberLongitude approximative
timezonestringFuseau horaire (IANA)
providerstringFournisseur d’accès ou opérateur
asnnumberNuméro de système autonome (AS)
Requête
$ curl mon-ip.dev/json
Réponse · application/json
{
"ip": "203.0.113.42",
"ipType": "IPv4",
"ipClass": "C",
"hostname": "42.113.0.203.example.net",
"country": "France",
"countryCode": "FR",
"city": "Paris",
"continent": "Europe",
"latitude": 48.8566,
"longitude": 2.3522,
"timezone": "Europe/Paris",
"provider": "Orange SA",
"asn": 3215
}
GET /{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.

Paramètres
iprequisAdresse IPv4 ou IPv6 à analyser, dans le chemin (ex : 8.8.8.8)
Requête
$ curl mon-ip.dev/8.8.8.8/json
Réponse · application/json
{
"ip": "8.8.8.8",
"ipType": "IPv4",
"ipClass": "A",
"country": "United States",
"countryCode": "US",
"city": "Mountain View",
"continent": "North America",
"latitude": 37.422,
"longitude": -122.085,
"provider": "Google LLC",
"asn": 15169
}

IP & Géolocalisation

GET /api/v1/json

Retourne les informations de géolocalisation, FAI et sécurité de l'IP du client.

Réponse JSON
ipstringAdresse IPv4
ipv6stringAdresse IPv6 (si disponible)
hostnamestringReverse DNS
typestringType d'IP (Residential, Business, etc.)
classstringClasse d'IP (A, B, C)
locationobjectcountry, countryCode, city, continent, latitude, longitude, timezone, postalCode
networkobjectprovider, asn
securityobjectIndicateurs de sécurité (proxy, VPN, Tor, etc.)
Requête
$ curl https://mon-ip.dev/api/v1/json
Réponse · application/json
{
"ip": "203.0.113.42",
"hostname": "42.113.0.203.example.net",
"type": "Residential",
"class": "C",
"location": {
"country": "France",
"countryCode": "FR",
"city": "Paris",
"latitude": 48.8566,
"longitude": 2.3522,
"timezone": "Europe/Paris"
},
"network": { "provider": "Orange SA", "asn": "AS3215" },
"security": { "proxy": false, "vpn": false, "tor": false }
}
GET /api/v1/ipv6

Détecte si le client se connecte en IPv4 ou IPv6.

Réponse JSON
ipstringAdresse IP du client
is_ipv4booleantrue si IPv4
is_ipv6booleantrue si IPv6 natif
protocolstring"IPv4" ou "IPv6"
timestampstringHorodatage ISO 8601
Requête
$ curl https://mon-ip.dev/api/v1/ipv6
Réponse · application/json
{
"ip": "203.0.113.42",
"is_ipv4": true,
"is_ipv6": false,
"protocol": "IPv4",
"timestamp": "2026-03-09T14:30:00Z"
}

DNS & Domaines

GET /api/v1/dns

Effectue une résolution DNS pour un type d’enregistrement donné.

Paramètres
hostrequisNom de domaine (ex: google.com)
record_typerequisType : A, AAAA, MX, NS, TXT, CNAME, SOA, PTR, SRV
Réponse JSON
hoststringDomaine interrogé
recordsarrayListe d'enregistrements : record_type, value, ttl
Requête
$ curl "https://mon-ip.dev/api/v1/dns?host=google.com&record_type=MX"
Réponse · application/json
{
"host": "google.com",
"records": [
{ "record_type": "MX", "value": "10 smtp.google.com", "ttl": 300 }
]
}
GET /api/v1/whois

Retourne les informations WHOIS d'un domaine ou d'une IP.

Paramètres
targetrequisDomaine ou IP (ex: google.com)
Réponse JSON
targetstringCible interrogée
rawstringRéponse WHOIS brute
parsedobjectdomain_name, registrar, creation_date, expiration_date, name_servers, status, dnssec
cachedbooleantrue si le résultat provient du cache
Requête
$ curl https://mon-ip.dev/api/v1/whois?target=google.com
Réponse · application/json
{
"target": "google.com",
"parsed": {
"domain_name": "google.com",
"registrar": "MarkMonitor Inc.",
"creation_date": "1997-09-15",
"expiration_date": "2028-09-14",
"name_servers": ["ns1.google.com", "ns2.google.com"],
"dnssec": "unsigned"
},
"cached": false
}
GET /api/v1/ssl

Vérifie le certificat SSL/TLS d'un domaine en se connectant au port 443.

Paramètres
hostrequisNom de domaine (ex: google.com)
Réponse JSON
hoststringDomaine testé
validbooleantrue si le certificat est valide
days_remainingnumberJours avant expiration
subjectstringSujet (CN)
issuerstringÉmetteur (CN)
issuer_orgstringOrganisation de l'émetteur
valid_fromstringDate de début (ISO 8601)
valid_tostringDate d'expiration (ISO 8601)
serialstringNuméro de série
fingerprintstringEmpreinte SHA-256
protocolstringProtocole TLS (ex: TLSv1.3)
bitsnumber | nullTaille de clé en bits
alt_namesstring[]Noms alternatifs (SAN)
Requête
$ curl https://mon-ip.dev/api/v1/ssl?host=google.com
Réponse · application/json
{
"host": "google.com",
"valid": true,
"days_remaining": 62,
"subject": "*.google.com",
"issuer": "GTS CA 1C3",
"protocol": "TLSv1.3",
"alt_names": ["*.google.com", "google.com"]
}

Sécurité

GET /api/v1/blacklist

Vérifie si une adresse IPv4 est listée dans 8 listes noires DNS.

Paramètres
iprequisAdresse IPv4 (ex: 8.8.8.8)
Réponse JSON
ipstringIP testée
totalnumberNombre de listes testées
listednumberNombre de listes où l’IP apparaît
cleanbooleantrue si l'IP n'est dans aucune liste
resultsarrayDétail par liste : name, zone, listed
Requête
$ curl https://mon-ip.dev/api/v1/blacklist?ip=8.8.8.8
Réponse · application/json
{
"ip": "8.8.8.8",
"total": 8,
"listed": 0,
"clean": true,
"results": [
{ "name": "Spamhaus ZEN", "zone": "zen.spamhaus.org", "listed": false }
]
}

Réseau

GET /api/v1/ping SSE

Envoie des paquets ICMP et retourne les résultats en temps réel via Server-Sent Events.

Paramètres
hostrequisHôte ou IP (ex: 8.8.8.8)
countoptionnelNombre de paquets (défaut: 4)
Événements SSE
starthost, resolved_ip
replyseq, ip, time_ms, ttl
timeoutseq
donealive, packets_sent, packets_received, packet_loss, min_ms, avg_ms, max_ms
errormessage
Requête
$ curl -N "https://mon-ip.dev/api/v1/ping?host=8.8.8.8&count=4"
Réponse · text/event-stream
data: {"type":"start","host":"8.8.8.8","resolved_ip":"8.8.8.8"}
data: {"type":"reply","seq":1,"ip":"8.8.8.8","time_ms":12.4,"ttl":118}
data: {"type":"reply","seq":2,"ip":"8.8.8.8","time_ms":11.8,"ttl":118}
data: {"type":"done","alive":true,"packets_sent":4,"packets_received":4,"packet_loss":0,"min_ms":11.2,"avg_ms":12.0,"max_ms":12.8}
GET /api/v1/traceroute SSE

Trace le chemin réseau vers un hôte en temps réel via Server-Sent Events.

Paramètres
hostrequisHôte ou IP (ex: google.com)
Événements SSE
starthost, resolved_ip
hophop, ip, hostname, rtt_ms
donetotal_hops, reached
errormessage
Requête
$ curl -N https://mon-ip.dev/api/v1/traceroute?host=google.com
Réponse · text/event-stream
data: {"type":"start","host":"google.com","resolved_ip":"142.250.179.110"}
data: {"type":"hop","hop":1,"ip":"192.168.1.1","hostname":"gateway","rtt_ms":1.2}
data: {"type":"hop","hop":2,"ip":"10.0.0.1","hostname":"isp-router","rtt_ms":5.4}
data: {"type":"done","total_hops":12,"reached":true}
CORSTous les endpoints acceptent les requêtes cross-origin (CORS).
SSELes endpoints ping et traceroute utilisent Server-Sent Events. EventSource / curl -N
KEYVotre clé API est affichée une seule fois lors de sa création. Conservez-la précieusement.
SECLes clés API sont chiffrées en AES-256-GCM au repos.
CLIcurl mon-ip.dev renvoie uniquement l’IP : idéal dans un script (IP=$(curl -s mon-ip.dev)).
Retour à l'accueil

Accédez à votre IP depuis le terminal

Utilisez notre API ou la commande curl pour intégrer mon-ip.dev à vos scripts.

API JSON →