API & Data Access
TopAIThreats.com provides six machine-readable endpoints that expose the full taxonomy, incident database, knowledge graph, and citation index. All endpoints return static data generated at build time and are available under the CC BY 4.0 (opens in new tab) licence.
Access: All endpoints are public, require no authentication, and support CORS (Access-Control-Allow-Origin: *).
Caching: JSON endpoints use Cache-Control: public, max-age=3600 (1 hour). The RSS feed and llms.txt use 24-hour caching.
Freshness: Data is regenerated on every site build (triggered by new incidents or taxonomy updates). Each response includes a generated timestamp.
Endpoints by Category
Taxonomy API
Full domain and pattern hierarchy with severity, likelihood, and framework mappings.
/api/threats.json Incidents API
All documented incidents with metadata, threat classifications, sources, and outcomes.
/api/incidents.json Knowledge Graph & Citations
Relationship graph of domains, patterns, incidents, and glossary terms, plus pre-formatted citation strings.
/api/graph.json/api/citations.json Feeds & LLM Integration
RSS feed for incident updates and a plain-text reference file optimised for large language models.
/rss.xml/llms.txt Quick Reference
| Endpoint | Format | Purpose | Cache |
|---|---|---|---|
/api/threats.json | JSON | Full taxonomy (8 domains, 42 patterns) | 1 hour |
/api/incidents.json | JSON | All 56 incidents with sources | 1 hour |
/api/graph.json | JSON | Knowledge graph (nodes + edges) | 1 hour |
/api/citations.json | JSON | Pre-formatted citation strings | 1 hour |
/rss.xml | RSS 2.0 | Incident update feed | 1 hour |
/llms.txt | Plain text | LLM reference document | 24 hours |
Roadmap
Planned additions
The following interactive tools are under consideration for future development. They are not yet available.
- Risk Assessment Checklist — An interactive questionnaire that maps organisational AI usage to relevant threat patterns and severity levels
- Incident Reporting Template — A structured form for submitting new incident candidates, aligned with the frontmatter schema
- Taxonomy Comparison Tool — A side-by-side viewer for comparing taxonomy dimensions and their coverage
6 endpoints across 4 categories · All data licensed CC BY 4.0 (opens in new tab) · View taxonomy