CertH certH

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.

Endpoint
Response
—

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

خطأ

Read the docs

الأسئلة الشائعة

هل أحتاج إلى حساب لاستخدام الواجهة؟

لا — الفحص الفوري وسجل 45 يومًا يعملان دون تسجيل؛ ومفتاح API يفتح سجلًا أطول.

ما حدود معدل استخدام الواجهة؟

≤20 نطاقًا جديدًا محفوظًا لكل IP يوميًا؛ ولقطة واحدة على الأكثر لكل نطاق في الساعة.

كيف أحصل على سجل أطول؟

قم بالترقية إلى Pro (90 يومًا) أو Agency (365 يومًا) وأرسل مفتاح API عبر ترويسة x-api-key.