CertH Public API
Plug CertH TLS grading into your tooling, CI or dashboards. The free tier needs no signup; an API Key unlocks full history.
Instant scan
POST /api/scan
Real-time TLS grade for any domain — 0-100 score and A+ to F, no auth required.
Score history
GET /api/public/domains/:domain/history
45 days free; API Key unlocks 90 days (Pro) / 365 days (Agency).
Leaderboard data
GET /api/leaderboard
Global TLS health rankings with grade, industry and region filters plus pagination.
Try it live
Call the public endpoints right here — no signup, no copy-paste. Requests go out from this page and return live data.
—
Requests are sent same-origin; POST /api/scan persists under throttling (≤20 new domains per IP daily, ≤1 snapshot per domain per hour).
Auth & free tier
· Instant scan & 45-day history: no auth, works out of the box.
· Deeper history: sign in at thedashboardto get a free API Key (ch_ prefix), send it via the x-api-key header.
· Rate limits: ≤20 new domains persisted per IP daily; at most 1 snapshot per domain per hour.
Full API reference
Error
Preguntas frecuentes
¿Necesito una cuenta para usar la API?
No: el escaneo instantáneo y el historial de 45 días funcionan sin registro; una API Key desbloquea historial más profundo.
¿Cuáles son los límites de la API?
≤20 dominios nuevos guardados por IP al día; como máximo una instantánea por dominio y hora.
¿Cómo obtengo más historial?
Pasa a Pro (90 días) o Agency (365 días) y envía tu API Key en la cabecera x-api-key.