ipcheckerpro-API

curl -s https://ipcheckerpro.com/api/v1/ip

curl -s "https://ipcheckerpro.com/api/v1/ip/1.1.1.1?whois=1&blacklists=1"

curl -s "https://ipcheckerpro.com/api/v1/asn/13335?whois=1"

curl -s "https://ipcheckerpro.com/api/v1/dns?name=example.com&type=MX"

curl -s -X POST https://ipcheckerpro.com/api/v1/bulk -H "Content-Type: application/json" -d '["1.1.1.1","8.8.8.8"]'

curl -s https://ipcheckerpro.com/api/v1/stats/live

curl -s https://ipcheckerpro.com/api/v1/stats/weekly

curl -s -H "X-API-Key: YOUR_KEY" \
  "https://ipcheckerpro.com/api/v1/ip/1.1.1.1?checks=native,risk"

# usage of the key
curl -s -H "X-API-Key: YOUR_KEY" https://ipcheckerpro.com/api/v1/key

const res = await fetch('https://ipcheckerpro.com/api/v1/ip/1.1.1.1', {
  headers: { 'X-API-Key': 'YOUR_KEY' }
});
const data = await res.json();
console.log(data.location.country, data.network.name, res.headers.get('X-RateLimit-Remaining'));

import requests

r = requests.get('https://ipcheckerpro.com/api/v1/ip/1.1.1.1',
                 headers={'X-API-Key': 'YOUR_KEY'}, timeout=10)
r.raise_for_status()
data = r.json()
print(data['location']['country'], data['classification'], r.headers['X-RateLimit-Remaining'])

$ctx = stream_context_create(['http' => ['header' => "X-API-Key: YOUR_KEY\r\n"]]);
$json = file_get_contents('https://ipcheckerpro.com/api/v1/ip/1.1.1.1', false, $ctx);
$data = json_decode($json, true);
echo $data['location']['country'], ' ', $data['network']['name'];

Überblick

Maschinenlesbare Beschreibung: /api/v1/openapi.json (OpenAPI 3.1).

Die API liefert dieselben Daten wie die Website als JSON: Standort, Netzwerk und Klassifizierung jeder IP-Adresse, den Registry-Eintrag dahinter, Sperrlisten-Status, ASN-Details und DNS-Records. Sie braucht weder Schlüssel noch Anmeldung.

• Basis-URL: https://ipcheckerpro.com/api/v1
• Format: JSON, UTF-8, nur GET
• Limits: 60 Anfragen pro Minute und IP-Adresse für die IP- und ASN-Endpunkte, 30 pro Minute für den DNS-Endpunkt
• CORS: Jede Antwort trägt Access-Control-Allow-Origin: *, Browser können sie also direkt aufrufen
• Attribution: Wenn Sie die Daten anzeigen, nennen Sie „IP geolocation by DB-IP“ mit Link zu db-ip.com (siehe Attribution unten)

Endpunkte

GET /api/v1/ip

Liefert das Profil der eigenen Adresse des Aufrufers. Die Antwort ist mit Cache-Control: private, no-store markiert und daher immer frisch.

curl -s https://ipcheckerpro.com/api/v1/ip

GET /api/v1/ip/{ip}

Liefert das Profil jeder öffentlichen IPv4- oder IPv6-Adresse. Optionale Query-Parameter:

• whois=1 ergänzt ein whois-Objekt mit dem über RDAP geholten Registry-Eintrag.
• blacklists=1 führt die acht DNS-Sperrlisten-Prüfungen aus (nur IPv4) und füllt das blacklists-Objekt.

Antworten sind 300 Sekunden cachebar. Sperrlisten-Ergebnisse werden auf unserer Seite eine Stunde gecacht, Registry-Einträge 24 Stunden.

curl -s "https://ipcheckerpro.com/api/v1/ip/1.1.1.1?whois=1&blacklists=1"

GET /api/v1/asn/{asn}

Liefert Details zu einem autonomen System. Die Nummer kann mit oder ohne AS-Präfix angegeben werden. Mit whois=1 wird der Registry-Eintrag in einem registry-Objekt ergänzt. Antworten sind eine Stunde cachebar.

curl -s "https://ipcheckerpro.com/api/v1/asn/13335?whois=1"

GET /api/v1/dns?name=&type=

Liefert die DNS-Records eines Hostnamens. type ist einer von A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA oder PTR; Standard ist A. Antworten sind 60 Sekunden cachebar.

curl -s "https://ipcheckerpro.com/api/v1/dns?name=example.com&type=MX"

Aufbau der Antwort

Eine erfolgreiche IP-Anfrage liefert ein Objekt mit diesen Feldern. Unbekannte Werte sind null. Die Werte unten sind illustrativ; führen Sie die Anfrage aus, um die aktuellen Daten einer Adresse zu sehen.

{
  "ip": "1.1.1.1",
  "version": 4,
  "private": false,
  "hostname": "one.one.one.one",
  "location": {
    "country_code": "AU",
    "country": "Australia",
    "region": "Queensland",
    "city": "Brisbane",
    "latitude": -27.4679,
    "longitude": 153.028,
    "timezone": "Australia/Brisbane",
    "continent": "OC",
    "eu": false
  },
  "network": {
    "asn": 13335,
    "name": "CLOUDFLARENET",
    "prefix": "1.1.1.0/24",
    "country_code": "US",
    "type": "hosting"
  },
  "classification": "hosting",
  "flags": {
    "hosting": true,
    "tor": false,
    "vpn_provider": false,
    "spamhaus_drop": null,
    "datacenter": "Cloudflare",
    "mobile": false
  },
  "blacklists": { "checked": 8, "listed": 0 },
  "sources": {
    "geolocation": "DB-IP Lite (CC BY 4.0)",
    "asn": "iptoasn.com / DB-IP Lite"
  }
}

Hinweise zu den Feldern:

• version ist 4 oder 6. private ist true für Loopback-, Link-Local- und private Bereiche; solche Adressen haben weder location noch network.
• hostname ist der PTR-Record (Reverse DNS) oder null.
• network.type ist die aus ASN-Name und öffentlichen Listen abgeleitete Netzwerkklassifizierung: isp, mobile, hosting, education, government, business oder unknown.
• classification ist das Gesamturteil: residential, mobile, hosting, vpn, tor, education, government, business, private oder unknown.
• flags.spamhaus_drop ist der passende DROP-Bereich als String oder null. flags.datacenter ist der passende Anbietername aus der Rechenzentrumsliste oder null.
• blacklists ist null, sofern nicht blacklists=1 angegeben wurde.
• whois (mit whois=1) enthält handle, name, type, start, end, cidr, country, parent, status, entities, events, remarks, links und registry.

Eine ASN-Anfrage liefert asn, name, country_code, type, ipv4_prefixes, ipv4_addresses, ipv6_prefixes, prefixes_sample (bis zu 20 CIDR-Strings), registry (mit whois=1, sonst null) und source.

Eine DNS-Anfrage liefert name, type und records, ein Array von { "name", "ttl", "value" }-Objekten.

Fehler

Fehler sind JSON-Objekte mit einem error-Code und meist einer message:

Status	error	Bedeutung
400	invalid_ip	Das Pfadsegment ist keine gültige IPv4- oder IPv6-Adresse
400	invalid_asn	Das ASN ist keine Zahl
400	invalid_query	name ist kein Hostname oder type wird nicht unterstützt
404	not_found	Für dieses ASN sind keine angekündigten Präfixe bekannt
429	rate_limited	Limit überschritten; warten und erneut versuchen

Beispiele

JavaScript (Browser oder Node)

const res = await fetch("https://ipcheckerpro.com/api/v1/ip/8.8.8.8?whois=1");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data.location.country, data.network.name, data.classification);

Python

import requests

r = requests.get("https://ipcheckerpro.com/api/v1/ip/8.8.8.8", params={"blacklists": 1}, timeout=10)
r.raise_for_status()
data = r.json()
print(data["location"]["country"], data["network"]["name"], data["blacklists"])

curl mit der eigenen Adresse des Aufrufers

curl -s https://ipcheckerpro.com/api/v1/ip | jq '{ip, country: .location.country, type: .network.type}'

Attribution

Die Geolokalisierungsdaten stammen von DB-IP Lite, lizenziert unter Creative Commons Attribution 4.0. Wenn Sie Daten aus dieser API Nutzern anzeigen, zeigen Sie den Text „IP geolocation by DB-IP“ mit einem Link zu https://db-ip.com in der Nähe der Daten. ASN-Daten stammen von iptoasn.com (gemeinfrei) und DB-IP Lite. Sperrlisten- und Registry-Ergebnisse gehören ihren jeweiligen Betreibern und werden für Ihren eigenen Gebrauch zurückgegeben, nicht zur Weiterverbreitung als Datensatz.

Fair Use

Die obigen Limits gelten pro aufrufender IP-Adresse. Wenn Sie mehr brauchen, cachen Sie Antworten auf Ihrer Seite; Standort- und Netzwerkdaten einer Adresse ändern sich innerhalb eines Tages selten. Nutzen Sie die API nicht, um eine Kopie der zugrunde liegenden Datenbanken aufzubauen. Die vollständigen Regeln zur zulässigen Nutzung stehen in den Nutzungsbedingungen.

Änderungen

Die API ist im Pfad versioniert. Felder können ohne Ankündigung zu Antworten hinzugefügt werden; bestehende Felder werden innerhalb von v1 weder umbenannt noch entfernt. Änderungen an Limits, Endpunkten oder Verhalten werden auf dieser Seite angekündigt, bevor sie wirksam werden.