API access

The TrueCite Public API gives programmatic access to your scan data, MentionShare scores, competitor analysis, and Fix Generator content — and supports triggering new AEO scans from your own workflows via POST /api/v1/scans. It is available on Enterprise plans only. All v1 endpoints are served from https://truecite.ai/api/v1 — there is no separate API subdomain.

The API also supports outbound webhooks — subscribe to scan.completed, mention.dropped, competitor.detected, authority.captured, crawler_check.completed, llms_check.completed, schema_audit.completed, and ai_seo_audit.completed events to receive real-time payloads delivered to your own HTTPS endpoint. Each delivery is signed with HMAC-SHA256 via the X-TrueCite-Signature-256 header so you can verify authenticity. See the REST API Reference → Webhooks for payload shapes and a verification code example. If you prefer polling over webhooks, use GET /api/v1/scans/status/{jobId} to check the status of a scan you triggered via POST /api/v1/scans — it returns per-engine results, tasksSucceeded, and tasksFailed as tasks complete.

Authority Capture is also accessible via API on Pro and Enterprise plans. Use POST /api/v1/authority to trigger a capture from a URL or text transcript, GET /api/v1/authority/status/{jobId} to poll completion, and GET /api/v1/authority/{id}/blocks to retrieve the generated FAQ blocks, answer paragraphs, and JSON-LD schema. Regenerate blocks without re-fetching content via POST /api/v1/authority/{id}/regenerate.

Crawler Check and LLMs.txt Check are also available via API. Use POST /api/v1/crawler-check to run an AI bot access audit for any domain and GET /api/v1/crawler-check/status/{jobId} to poll completion. Similarly, POST /api/v1/llms-check audits a domain's llms.txt, llms-full.txt, and bot permissions — poll via GET /api/v1/llms-check/status/{jobId}. Both feature history endpoints (GET /api/v1/crawler-check and GET /api/v1/llms-check) return paginated results ordered by most recent.

Schema Audit is available via API on Enterprise plans. Use POST /api/v1/schema-audit to trigger a Schema.org structured data scan for any URL and GET /api/v1/schema-audit/status/{jobId} to poll completion. The result includes a score, schemas found and missing, OG/meta tag analysis, fix recommendations, and page metadata. Retrieve any past result by row ID via GET /api/v1/schema-audit/{id}, or browse history via GET /api/v1/schema-audit. The schema_audit.completed webhook fires automatically when a job finishes.

AI SEO Audit is also available via API. Use POST /api/v1/ai-seo-audit to trigger a full-site crawl of the business website (no URL body needed — the business website from your settings is used). Poll progress via GET /api/v1/ai-seo-audit/status/{jobId}. When complete, retrieve paginated results via GET /api/v1/ai-seo-audit (ordered by overall_score ASC — lowest-scoring pages first) or fetch a single page by row ID via GET /api/v1/ai-seo-audit/{pageId}. The ai_seo_audit.completed webhook fires when the audit finishes, with totalPages, pagesCompleted, and avgScore.

Authentication uses a Bearer token in the Authorization header. Keys are in the format tc_live_<32 hex chars> and are shown only once at creation time. The rate limit is 100 requests per hour per key; exceeded requests return 429 Too Many Requests with a Retry-After header.

Getting an API key

Last updated: June 2026 — TrueCite documentation is updated with every product release.