Check-Host.cc

API-Dokumentation

Verteilte Netzwerkdiagnose von 65+ globalen Knoten — Ping, MTR, DNS, HTTP, TCP und UDP — sowie Host-Metadaten, WHOIS und historische Prüfberichte. Jeder Endpunkt unten ist bearbeitbar und direkt im Browser ausführbar gegen die Live-API.

Wofür ist das?

Anonym funktioniert für die meisten Fälle. Es gelten konservative Rate-Limits pro IP und pro Ziel — siehe die vollständige Tabelle auf /about, wenn du die genauen Zahlen brauchst.

Ein API-Schlüssel (UUID-Format) erhöht diese Limits mit einer monatlichen Quote pro Schlüssel. Schlüssel sind kostenlos — Check-Host ist ein Non-Profit-Projekt, und die Limits dienen nur dem Missbrauchsschutz, nicht der Monetarisierung. Wenn du einen legitimen Anwendungsfall hast, der die anonyme Stufe übersteigt, melde dich beim Support.

Send the key as an Authorization: Bearer <key> header — the code samples below fill this in for you. For backward compatibility an apikey field in a POST body is still accepted; passing it in the URL query string is not.

Datenschutz: Der Schlüssel bleibt ausschließlich im localStorage deines Browsers auf dieser Seite und wird nur an api.check-host.cc gesendet.

Schnellstart

Eine Prüfung läuft asynchron: (1) POST an einen Monitoring-Endpunkt, um eine UUID zu erhalten, (2) /report/{uuid} abfragen, bis jeder Knoten geantwortet hat. Die meisten Prüfungen sind in 1–10 Sekunden fertig. Die Endpunkte unten machen das automatisch, wenn du auf Ausführen klickst.

Polling-Muster (bash)
# 1. Dispatch a check, capture the UUID
UUID=$(curl -s -X POST https://api.check-host.cc/ping \
  -H 'Content-Type: application/json' \
  -d '{"target":"check-host.cc","region":["DE"]}' | jq -r .uuid)

# 2. Poll until at least one node has reported
until curl -s "https://api.check-host.cc/report/$UUID" \
  | jq -e '.data | length >= 1' > /dev/null; do sleep 1; done

curl -s "https://api.check-host.cc/report/$UUID" | jq .

Abfragen

8 Endpunkte

IP, Geolokation, WHOIS und die Live-Knotenliste.

Globale Prüfungen

12 Endpunkte

Verteile eine Ping- / TCP- / UDP- / HTTP- / DNS- / MTR-Prüfung über 65+ globale Knoten — jeder Aufruf liefert eine UUID und fragt anschließend automatisch /report/{uuid} nach Ergebnissen ab.

GET-Kurzbefehle

Drop-in-URLs für einfache Prüfungen — kein Region-Targeting, kein Live-Modus (für beides POST oben verwenden).

Network Intelligence

3 Endpunkte

Dispatch deep, multi-stage scans (port + banner + body + TLS + threat-intel) of an IP, CIDR, domain or ASN. Asynchronous: submit, then poll the status endpoint. Open to guests, with per-IP and per-target hourly quotas.

Intelligence Data

8 Endpunkte

Read the aggregated intelligence we already hold for an entity — the same data that powers the /ip, /as, /domain … pages, as JSON. Open to guests with a per-IP rate limit; an API key lifts the limits.

Geo Intelligence

4 Endpunkte

Country, TLD and continent-level aggregates plus the global threat feed — the same data that powers the /country, /tld, /continent and /threats pages, as JSON. Open to guests with a per-IP rate limit; an API key lifts the limits.

Berichte

3 Endpunkte

Hole den JSON-Bericht oder gerenderte Statusbilder für eine zuvor gestartete Prüfung ab.