API v1

Documentazione API

API REST pubblica per geolocalizzazione IP, strumenti di rete e verifica della sicurezza.

RESTJSONSSECORS URL Basehttps://mon-ip.dev
Autenticazione

Chiave API

L'API è accessibile pubblicamente senza autenticazione. Per limiti più alti, crea un account e genera una chiave API dalla tua dashboard. Apri la dashboard →

Trasmetti la tua chiave tramite l'header Authorization:

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

Rate limiting

Le richieste sono limitate in base al tuo livello di accesso. In caso di superamento, l'API restituisce un errore 429 Too Many Requests.

LivelloPer oraPer giornoChiavi max
Public100 / IP500 / IP—
Free1 00010 0005
Proin arrivo10 000100 00020
Header di risposta

Ogni risposta include header per monitorare il tuo consumo:

X-RateLimit-LimitNumero massimo di richieste consentite all'ora
X-RateLimit-RemainingRichieste rimanenti nella finestra corrente
X-RateLimit-ResetTimestamp UNIX di reset del contatore
Errori

Codici di errore

In caso di errore, la risposta contiene un campo error con un messaggio descrittivo.

400Parametro mancante o non valido
401Chiave API non valida o revocata
429Limite di richieste superato (rate limit)
502Errore di connessione al servizio interno
500Errore interno del server
429 Too Many Requests
{
"error": "Rate limit exceeded",
"limit": 100,
"reset": 1709913600
}

Terminale (curl)

Senza chiave né parametri: interroga direttamente la radice del sito da curl, wget, HTTPie o PowerShell. Risposte non memorizzate in cache, CORS consentito.

GET /

Restituisce il tuo indirizzo IP pubblico in testo semplice, seguito da un a capo, quando la richiesta proviene da un client a riga di comando (curl, wget, HTTPie, PowerShell…). Il percorso /ip restituisce la stessa risposta da qualsiasi client.

Richiesta
$ curl mon-ip.dev
Risposta · text/plain
203.0.113.42
GET /json

Geolocalizzazione e informazioni di rete del tuo IP, in JSON indentato (leggibile direttamente nel terminale).

Risposta JSON
ipstringIndirizzo IP analizzato
ipTypestringVersione: IPv4 o IPv6
ipClassstringClasse di IP (A, B, C)
hostnamestringReverse DNS
countrystringPaese
countryCodestringCodice paese ISO 3166-1 (2 lettere)
citystringCittà
continentstringContinente
postalCodestringCodice postale (se noto)
latitudenumberLatitudine approssimativa
longitudenumberLongitudine approssimativa
timezonestringFuso orario (IANA)
providerstringProvider o operatore
asnnumberNumero di sistema autonomo (AS)
Richiesta
$ curl mon-ip.dev/json
Risposta · 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

Le stesse informazioni per qualsiasi indirizzo IPv4 o IPv6 indicato nel percorso. I campi assenti non vengono restituiti.

Parametri
iprichiestoIndirizzo IPv4 o IPv6 da analizzare, nel percorso (es.: 8.8.8.8)
Richiesta
$ curl mon-ip.dev/8.8.8.8/json
Risposta · 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 e Geolocalizzazione

GET /api/v1/json

Restituisce le informazioni di geolocalizzazione, ISP e sicurezza dell'IP del client.

Risposta JSON
ipstringIndirizzo IPv4
ipv6stringIndirizzo IPv6 (se disponibile)
hostnamestringReverse DNS
typestringTipo di IP (Residential, Business, ecc.)
classstringClasse di IP (A, B, C)
locationobjectcountry, countryCode, city, continent, latitude, longitude, timezone, postalCode
networkobjectprovider, asn
securityobjectIndicatori di sicurezza (proxy, VPN, Tor, ecc.)
Richiesta
$ curl https://mon-ip.dev/api/v1/json
Risposta · 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

Rileva se il client si connette tramite IPv4 o IPv6.

Risposta JSON
ipstringIndirizzo IP del client
is_ipv4booleantrue se IPv4
is_ipv6booleantrue se IPv6 nativo
protocolstring"IPv4" o "IPv6"
timestampstringTimestamp ISO 8601
Richiesta
$ curl https://mon-ip.dev/api/v1/ipv6
Risposta · application/json
{
"ip": "203.0.113.42",
"is_ipv4": true,
"is_ipv6": false,
"protocol": "IPv4",
"timestamp": "2026-03-09T14:30:00Z"
}

DNS e Domini

GET /api/v1/dns

Esegue una risoluzione DNS per un tipo di record specificato.

Parametri
hostrichiestoNome di dominio (es: google.com)
record_typerichiestoTipo: A, AAAA, MX, NS, TXT, CNAME, SOA, PTR, SRV
Risposta JSON
hoststringDominio interrogato
recordsarrayElenco di record: record_type, value, ttl
Richiesta
$ curl "https://mon-ip.dev/api/v1/dns?host=google.com&record_type=MX"
Risposta · application/json
{
"host": "google.com",
"records": [
{ "record_type": "MX", "value": "10 smtp.google.com", "ttl": 300 }
]
}
GET /api/v1/whois

Restituisce le informazioni WHOIS di un dominio o di un IP.

Parametri
targetrichiestoDominio o IP (es: google.com)
Risposta JSON
targetstringObiettivo interrogato
rawstringRisposta WHOIS grezza
parsedobjectdomain_name, registrar, creation_date, expiration_date, name_servers, status, dnssec
cachedbooleantrue se il risultato proviene dalla cache
Richiesta
$ curl https://mon-ip.dev/api/v1/whois?target=google.com
Risposta · 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

Verifica il certificato SSL/TLS di un dominio connettendosi alla porta 443.

Parametri
hostrichiestoNome di dominio (es: google.com)
Risposta JSON
hoststringDominio testato
validbooleantrue se il certificato è valido
days_remainingnumberGiorni alla scadenza
subjectstringSoggetto (CN)
issuerstringEmittente (CN)
issuer_orgstringOrganizzazione dell'emittente
valid_fromstringData di inizio (ISO 8601)
valid_tostringData di scadenza (ISO 8601)
serialstringNumero di serie
fingerprintstringImpronta SHA-256
protocolstringProtocollo TLS (es: TLSv1.3)
bitsnumber | nullDimensione chiave in bit
alt_namesstring[]Nomi alternativi (SAN)
Richiesta
$ curl https://mon-ip.dev/api/v1/ssl?host=google.com
Risposta · 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"]
}

Sicurezza

GET /api/v1/blacklist

Verifica se un indirizzo IPv4 è elencato in 8 blacklist DNS.

Parametri
iprichiestoIndirizzo IPv4 (es: 8.8.8.8)
Risposta JSON
ipstringIP testato
totalnumberNumero di liste testate
listednumberNumero di liste in cui appare l'IP
cleanbooleantrue se l'IP non è in nessuna lista
resultsarrayDettaglio per lista: name, zone, listed
Richiesta
$ curl https://mon-ip.dev/api/v1/blacklist?ip=8.8.8.8
Risposta · application/json
{
"ip": "8.8.8.8",
"total": 8,
"listed": 0,
"clean": true,
"results": [
{ "name": "Spamhaus ZEN", "zone": "zen.spamhaus.org", "listed": false }
]
}

Rete

GET /api/v1/ping SSE

Invia pacchetti ICMP e restituisce i risultati in tempo reale tramite Server-Sent Events.

Parametri
hostrichiestoHost o IP (es: 8.8.8.8)
countopzionaleNumero di pacchetti (predefinito: 4)
Eventi SSE
starthost, resolved_ip
replyseq, ip, time_ms, ttl
timeoutseq
donealive, packets_sent, packets_received, packet_loss, min_ms, avg_ms, max_ms
errormessage
Richiesta
$ curl -N "https://mon-ip.dev/api/v1/ping?host=8.8.8.8&count=4"
Risposta · 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

Traccia il percorso di rete verso un host in tempo reale tramite Server-Sent Events.

Parametri
hostrichiestoHost o IP (es: google.com)
Eventi SSE
starthost, resolved_ip
hophop, ip, hostname, rtt_ms
donetotal_hops, reached
errormessage
Richiesta
$ curl -N https://mon-ip.dev/api/v1/traceroute?host=google.com
Risposta · 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}
CORSTutti gli endpoint accettano richieste cross-origin (CORS).
SSEGli endpoint ping e traceroute utilizzano Server-Sent Events. EventSource / curl -N
KEYLa tua chiave API viene mostrata solo una volta alla creazione. Conservala con cura.
SECLe chiavi API sono crittografate con AES-256-GCM a riposo.
CLIcurl mon-ip.dev restituisce solo l’IP: ideale in uno script (IP=$(curl -s mon-ip.dev)).
Torna alla home

Ottieni il tuo IP dal terminale

Usa la nostra API o il comando curl per integrare mon-ip.dev nei tuoi script.

API JSON →