API v3 Developer Center

Build AI-ready intelligence applications with OpenTrojan API v3. Every response carries source, confidence, freshness and lineage so consumed knowledge is attributable and trustworthy.

Endpoints

GET /api/v3/query?q={entityId}

Query API

Look up an intelligence entity with its relations and lineage.

Returns: data, source, confidence, freshness, lineage
GET /api/v3/stream?limit=10

Intelligence Stream

Stream recent temporal events across the intelligence network.

Returns: items (each with source, confidence, freshness, lineage)
GET /api/v3/evidence/:id

Evidence API

Fetch the evidence supporting a claim or entity with authoritative fields.

Returns: evidence, source, confidence, freshness, lineage
GET /api/v3/timeline/:entityId

Timeline API

Temporal view of how an entity changed over time (Knowledge Graph 4.0).

Returns: timeline, relations, source, confidence, freshness, lineage

Response contract

Every intelligence payload includes these fields for provenance-aware consumption:

sourceconfidencefreshnesslineage

Example

GET /api/v3/query?q=CVE-2021-44228
{
  "data": { "entity": { "id": "CVE-2021-44228", "title": "Log4Shell" } },
  "source": "nvd,pipeline,entity,ai_answer",
  "confidence": 0.5,
  "freshness": 0.8,
  "lineage": [ ... ],
  "requiresReview": true
}