API v1

API-Dokumentation

Öffentliche REST-API für IP-Geolokalisierung, Netzwerktools und Sicherheitsüberprüfung.

RESTJSONSSECORS Basis-URLhttps://mon-ip.dev
Authentifizierung

API-Schlüssel

Die API ist öffentlich ohne Authentifizierung zugänglich. Für höhere Limits erstellen Sie ein Konto und generieren einen API-Schlüssel in Ihrem Dashboard. Dashboard öffnen →

Übermitteln Sie Ihren Schlüssel über den Authorization-Header:

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

Rate Limiting

Anfragen sind je nach Zugangsstufe begrenzt. Bei Überschreitung gibt die API einen 429 Too Many Requests Fehler zurück.

StufePro StundePro TagMax. Schlüssel
Public100 / IP500 / IP—
Free1 00010 0005
Prodemnächst10 000100 00020
Antwort-Header

Jede Antwort enthält Header zur Verfolgung Ihres Verbrauchs:

X-RateLimit-LimitMaximale erlaubte Anfragen pro Stunde
X-RateLimit-RemainingVerbleibende Anfragen im aktuellen Fenster
X-RateLimit-ResetUNIX-Zeitstempel des Zähler-Resets
Fehler

Fehlercodes

Im Fehlerfall enthält die Antwort ein error-Feld mit einer beschreibenden Nachricht.

400Fehlender oder ungültiger Parameter
401Ungültiger oder widerrufener API-Schlüssel
429Anfragelimit überschritten (Rate Limit)
502Verbindungsfehler zum internen Dienst
500Interner Serverfehler
429 Too Many Requests
{
"error": "Rate limit exceeded",
"limit": 100,
"reset": 1709913600
}

Terminal (curl)

Ohne Schlüssel und Parameter: Fragen Sie die Startseite direkt mit curl, wget, HTTPie oder PowerShell ab. Antworten werden nicht zwischengespeichert, CORS ist erlaubt.

GET /

Gibt Ihre öffentliche IP-Adresse als reinen Text mit Zeilenumbruch zurück, wenn die Anfrage von einem Kommandozeilen-Client stammt (curl, wget, HTTPie, PowerShell…). Der Pfad /ip liefert dieselbe Antwort für jeden Client.

Anfrage
$ curl mon-ip.dev
Antwort · text/plain
203.0.113.42
GET /json

Geolokalisierung und Netzwerkdaten Ihrer IP als eingerücktes JSON (direkt im Terminal lesbar).

JSON-Antwort
ipstringGeprüfte IP-Adresse
ipTypestringVersion: IPv4 oder IPv6
ipClassstringIP-Klasse (A, B, C)
hostnamestringReverse DNS
countrystringLand
countryCodestringLändercode nach ISO 3166-1 (2 Buchstaben)
citystringStadt
continentstringKontinent
postalCodestringPostleitzahl (falls bekannt)
latitudenumberUngefährer Breitengrad
longitudenumberUngefährer Längengrad
timezonestringZeitzone (IANA)
providerstringInternetanbieter oder Netzbetreiber
asnnumberNummer des autonomen Systems (AS)
Anfrage
$ curl mon-ip.dev/json
Antwort · 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

Dieselben Daten für jede im Pfad angegebene IPv4- oder IPv6-Adresse. Fehlende Felder werden weggelassen.

Parameter
iperforderlichZu prüfende IPv4- oder IPv6-Adresse im Pfad (z. B. 8.8.8.8)
Anfrage
$ curl mon-ip.dev/8.8.8.8/json
Antwort · 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 & Geolokalisierung

GET /api/v1/json

Gibt Geolokalisierungs-, ISP- und Sicherheitsinformationen der Client-IP zurück.

JSON-Antwort
ipstringIPv4-Adresse
ipv6stringIPv6-Adresse (falls verfügbar)
hostnamestringReverse DNS
typestringIP-Typ (Residential, Business, etc.)
classstringIP-Klasse (A, B, C)
locationobjectcountry, countryCode, city, continent, latitude, longitude, timezone, postalCode
networkobjectprovider, asn
securityobjectSicherheitsindikatoren (Proxy, VPN, Tor, etc.)
Anfrage
$ curl https://mon-ip.dev/api/v1/json
Antwort · 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

Erkennt, ob der Client über IPv4 oder IPv6 verbunden ist.

JSON-Antwort
ipstringClient-IP-Adresse
is_ipv4booleantrue wenn IPv4
is_ipv6booleantrue wenn natives IPv6
protocolstring"IPv4" oder "IPv6"
timestampstringISO 8601 Zeitstempel
Anfrage
$ curl https://mon-ip.dev/api/v1/ipv6
Antwort · application/json
{
"ip": "203.0.113.42",
"is_ipv4": true,
"is_ipv6": false,
"protocol": "IPv4",
"timestamp": "2026-03-09T14:30:00Z"
}

DNS & Domains

GET /api/v1/dns

Führt eine DNS-Auflösung für einen bestimmten Eintragstyp durch.

Parameter
hosterforderlichDomainname (z.B. google.com)
record_typeerforderlichTyp: A, AAAA, MX, NS, TXT, CNAME, SOA, PTR, SRV
JSON-Antwort
hoststringAbgefragte Domain
recordsarrayListe von Einträgen: record_type, value, ttl
Anfrage
$ curl "https://mon-ip.dev/api/v1/dns?host=google.com&record_type=MX"
Antwort · application/json
{
"host": "google.com",
"records": [
{ "record_type": "MX", "value": "10 smtp.google.com", "ttl": 300 }
]
}
GET /api/v1/whois

Gibt die WHOIS-Informationen einer Domain oder IP zurück.

Parameter
targeterforderlichDomain oder IP (z.B. google.com)
JSON-Antwort
targetstringAbgefragtes Ziel
rawstringRohe WHOIS-Antwort
parsedobjectdomain_name, registrar, creation_date, expiration_date, name_servers, status, dnssec
cachedbooleantrue wenn das Ergebnis aus dem Cache stammt
Anfrage
$ curl https://mon-ip.dev/api/v1/whois?target=google.com
Antwort · 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

Prüft das SSL/TLS-Zertifikat einer Domain durch Verbindung zu Port 443.

Parameter
hosterforderlichDomainname (z.B. google.com)
JSON-Antwort
hoststringGetestete Domain
validbooleantrue wenn das Zertifikat gültig ist
days_remainingnumberTage bis zum Ablauf
subjectstringBetreff (CN)
issuerstringAussteller (CN)
issuer_orgstringOrganisation des Ausstellers
valid_fromstringStartdatum (ISO 8601)
valid_tostringAblaufdatum (ISO 8601)
serialstringSeriennummer
fingerprintstringSHA-256-Fingerabdruck
protocolstringTLS-Protokoll (z.B. TLSv1.3)
bitsnumber | nullSchlüsselgröße in Bits
alt_namesstring[]Alternative Namen (SAN)
Anfrage
$ curl https://mon-ip.dev/api/v1/ssl?host=google.com
Antwort · 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"]
}

Sicherheit

GET /api/v1/blacklist

Prüft, ob eine IPv4-Adresse in 8 DNS-Blacklists aufgeführt ist.

Parameter
iperforderlichIPv4-Adresse (z.B. 8.8.8.8)
JSON-Antwort
ipstringGetestete IP
totalnumberAnzahl getesteter Listen
listednumberAnzahl der Listen, in denen die IP erscheint
cleanbooleantrue wenn die IP in keiner Liste steht
resultsarrayDetail pro Liste: name, zone, listed
Anfrage
$ curl https://mon-ip.dev/api/v1/blacklist?ip=8.8.8.8
Antwort · application/json
{
"ip": "8.8.8.8",
"total": 8,
"listed": 0,
"clean": true,
"results": [
{ "name": "Spamhaus ZEN", "zone": "zen.spamhaus.org", "listed": false }
]
}

Netzwerk

GET /api/v1/ping SSE

Sendet ICMP-Pakete und gibt die Ergebnisse in Echtzeit über Server-Sent Events zurück.

Parameter
hosterforderlichHost oder IP (z.B. 8.8.8.8)
countoptionalAnzahl der Pakete (Standard: 4)
SSE-Ereignisse
starthost, resolved_ip
replyseq, ip, time_ms, ttl
timeoutseq
donealive, packets_sent, packets_received, packet_loss, min_ms, avg_ms, max_ms
errormessage
Anfrage
$ curl -N "https://mon-ip.dev/api/v1/ping?host=8.8.8.8&count=4"
Antwort · 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

Verfolgt den Netzwerkpfad zu einem Host in Echtzeit über Server-Sent Events.

Parameter
hosterforderlichHost oder IP (z.B. google.com)
SSE-Ereignisse
starthost, resolved_ip
hophop, ip, hostname, rtt_ms
donetotal_hops, reached
errormessage
Anfrage
$ curl -N https://mon-ip.dev/api/v1/traceroute?host=google.com
Antwort · 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}
CORSAlle Endpunkte akzeptieren Cross-Origin-Anfragen (CORS).
SSEDie Ping- und Traceroute-Endpunkte verwenden Server-Sent Events. EventSource / curl -N
KEYIhr API-Schlüssel wird nur einmal bei der Erstellung angezeigt. Bewahren Sie ihn sicher auf.
SECAPI-Schlüssel werden mit AES-256-GCM im Ruhezustand verschlüsselt.
CLIcurl mon-ip.dev liefert nur die IP – ideal für Skripte (IP=$(curl -s mon-ip.dev)).
Zurück zur Startseite

Ihre IP direkt im Terminal

Nutzen Sie unsere API oder den curl-Befehl, um mon-ip.dev in Ihre Skripte einzubinden.

JSON-API →