checks

Submit content for evidence research (SSE stream)

Submit a URL or text for evidence research. Returns an SSE stream of pipeline progress events.

Input types: url (article analysis), text (direct claim or question).

Deep Research pipeline: extract claims → retrieve evidence → decompose into elements → map evidence with relationship labels (typically 60-120s).

SSE events emitted:

  • progress — stage name, percentage, time estimate
  • awaiting_selection — article mode: claims extracted, awaiting user selection
  • completed — pipeline finished, check ID in payload
  • error — pipeline failed

For URL inputs with multiple claims, the pipeline pauses after extraction. Call PATCH /checks/{id}/select-claims to resume with chosen claims.

Rate limit: 10/minute

post/api/v1/checks/stream

Request

  • Base URL: https://api.trueight.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.trueight.com/api/v1/checks/stream
  • Auth: none declared

Query parameters

tokenstring nullable

Request body

input_typestring required

Input type: 'url' (article analysis), 'text' (direct claim), 'image' (OCR), or 'video' (transcript)

contentstring nullable

Claim text (required when input_type is 'text'). Supports both statements and questions. Capped at 10,000 chars to prevent DoS via oversized inputs.

urlstring nullable

URL to analyse (required when input_type is 'url' or 'video'). HTTPS prefix is added automatically if omitted.

file_pathstring nullable

Server path for uploaded images (use POST /upload first)

user_querystring nullable

Optional Search Clarity question (max 200 chars). When provided, the pipeline generates a focused answer alongside the evidence landscape.

frozen_evidenceobject nullable

Pre-supplied evidence for replay testing (internal use only)

Response

Server-Sent Events stream of pipeline progress. Content-Type: text/event-stream

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.