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

Lỗi

Read the docs

Câu hỏi thường gặp

Tôi có cần tài khoản để dùng API không?

Không — quét tức thì và lịch sử 45 ngày hoạt động không cần đăng ký; API Key mở khóa lịch sử dài hơn.

Giới hạn tần suất của API là gì?

≤20 tên miền mới được lưu mỗi IP mỗi ngày; tối đa một ảnh chụp mỗi tên miền mỗi giờ.

Làm sao để có lịch sử dài hơn?

Nâng cấp lên Pro (90 ngày) hoặc Agency (365 ngày) và gửi API Key qua header x-api-key.