Check-Host.cc

Documentación de la API

Diagnóstico de red distribuido desde más de 65 nodos globales — Ping, MTR, DNS, HTTP, TCP y UDP — además de metadatos de host, WHOIS e informes históricos. Cada endpoint de abajo es editable y ejecutable en tu navegador contra la API en producción.

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
¿Para qué sirve esto?

El uso anónimo cubre la mayoría de casos. Se aplican límites moderados por IP y por destino — consulta la tabla completa en /about si necesitas los números exactos.

Una clave API (formato UUID) eleva esos límites con una cuota mensual por clave. Las claves son gratuitas — Check-Host es un proyecto sin ánimo de lucro y los límites existen solo para evitar abusos, no para monetizar. Si tienes un caso legítimo que excede el nivel anónimo, contacta con soporte.

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.

Privacidad: la clave vive únicamente en el localStorage de tu navegador en esta página y solo se envía a api.check-host.cc.

Inicio rápido

Enviar una comprobación es asíncrono: (1) POST a un endpoint de monitorización para obtener un UUID, (2) sondea /report/{uuid} hasta que todos los nodos hayan respondido. La mayoría termina en 1–10 segundos. Los endpoints de abajo hacen el polling automáticamente al pulsar Ejecutar.

Patrón de 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 .

Consultas

8 endpoints

IP, geolocalización, WHOIS y la lista de nodos en vivo.

Comprobaciones globales

12 endpoints

Lanza una comprobación Ping / TCP / UDP / HTTP / DNS / MTR desde más de 65 nodos globales — cada llamada devuelve un UUID y luego hace polling automático en /report/{uuid}.

Atajos GET rápidos

URLs directas para comprobaciones simples — sin selección de región ni modo en vivo (usa POST arriba para eso).

Network Intelligence

3 endpoints

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 endpoints

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 endpoints

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.

Informes

3 endpoints

Obtén el informe JSON o las imágenes de estado renderizadas de una comprobación ya enviada.