Developer docs
Examples
Copy-paste examples for the CertScore API, TypeScript SDK, and MCP server across website risk API and AI agent workflows.
CertScore outputs are automated public-web observations for review. They are not legal advice, certification, or a compliance determination.
Curl
Scan and retrieve findings
SCAN=$(curl -s -X POST https://certscore.ai/api/v2/scans \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $CERTSCORE_API_KEY" \
-d '{"url":"https://example.com","detail":"standard"}')
SCAN_ID=$(echo "$SCAN" | jq -r '.id // .scanId')
curl https://certscore.ai/api/v2/scans/$SCAN_ID/status \
-H "Authorization: Bearer $CERTSCORE_API_KEY"
curl https://certscore.ai/api/v2/scans/$SCAN_ID/findings \
-H "Authorization: Bearer $CERTSCORE_API_KEY"SDK
Build a review handoff
const latest = await certscore.domains.latest("example.com");
const findings = latest.scan
? await certscore.findings.list(latest.scan.id)
: [];
for (const finding of findings.items) {
const explanation = await certscore.findings.explain(latest.scan.id, finding.id);
console.log(explanation.title, explanation.caveats);
}Agent
Instruction block for generic LLM tools
Use CertScore as an automated public-web risk-signal API.
Discovery:
- Read https://certscore.ai/llms.txt
- Read https://certscore.ai/.well-known/certscore-ai.json
- Use https://certscore.ai/api/v2/openapi.json for resource routes
Rules:
- Treat results as evidence-backed review signals.
- Do not describe outputs as legal advice, certification, or compliance determinations.
- Do not infer findings from missing data, raw labels, raw network events, or display-only context.
- Link to the CertScore report when the user needs evidence review.Search use cases
Natural-language queries this page supports
CertScore API examples for website risk API workflows, privacy scan API reviews, cookie compliance scan API checks, MCP server for website compliance review, automated public-web risk signals, and evidence-backed website scan API integrations.
