Check-Host.cc

Dokumentasi API

Diagnostik jaringan terdistribusi dari 65+ node global — Ping, MTR, DNS, HTTP, TCP, dan UDP — plus metadata host, WHOIS, dan laporan pemeriksaan lama. Setiap endpoint di bawah bisa diedit dan dijalankan langsung dari browser ke API live.

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
Ini untuk apa?

Anonim cukup untuk sebagian besar kebutuhan. Berlaku rate limit moderat per IP dan per target — kalau butuh angka pastinya, lihat tabel lengkap di /about.

Kunci API (format UUID) menaikkan batas itu dengan kuota bulanan per kunci. Kunci gratis — Check-Host adalah proyek nirlaba, dan batasannya hanya untuk mencegah penyalahgunaan, bukan untuk monetisasi. Kalau kebutuhan Anda melampaui tier anonim, hubungi 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.

Privasi: kunci hanya tinggal di localStorage browser Anda di halaman ini, dan hanya dikirim ke api.check-host.cc.

Mulai cepat

Pengiriman pemeriksaan bersifat asynchronous: (1) POST ke endpoint monitoring untuk mendapatkan UUID, (2) lalu polling /report/{uuid} sampai setiap node selesai melapor. Sebagian besar pemeriksaan selesai dalam 1–10 detik. Endpoint di bawah melakukan polling otomatis saat Anda klik Jalankan.

Pola polling (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 .

Lookup

8 endpoint

IP, geolokasi, WHOIS, dan daftar node real-time.

Pemeriksaan Global

12 endpoint

Kirim pemeriksaan Ping / TCP / UDP / HTTP / DNS / MTR dari 65+ node global — setiap panggilan mengembalikan UUID lalu melakukan polling otomatis ke /report/{uuid} untuk hasil.

Pintasan GET cepat

URL siap pakai untuk pemeriksaan sederhana — tanpa pemilihan region atau Live mode (untuk itu pakai POST di atas).

Network Intelligence

3 endpoint

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 endpoint

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 endpoint

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.

Laporan

3 endpoint

Ambil laporan JSON atau gambar status yang sudah dirender dari pemeriksaan yang sebelumnya dikirim.