API Docs

REST endpoints for the LiveTube live event intelligence API. Base URL: https://api.livetube.ai. All responses are JSON. Authentication via Authorization: Bearer YOUR_KEY header. Get a free dev key.

Quickstart

curl https://api.livetube.ai/v1/events/flagship \
  -H "Authorization: Bearer YOUR_KEY"

Returns one richly-attributed live event with cluster + claim + trust data. Try it now in the playground — no key needed for sample calls.

Endpoints

GET/v1/events

Paginated list of clustered live events.

Query params: limit, offset, topic, region, min_confidence

GET/v1/events/flagship

Single highest-signal LIVE event meeting the showcase quality bar (≥10 sources + ≥1 verified). Falls back to evergreen if none qualifies.

GET/v1/events/{event_id}

Full event detail: cluster + sources + AI briefing + region.

GET/v1/events/{event_id}/claims

Per-event claims with consensus tier (confirmed ≥4 sources / developing 2-3 / unconfirmed 1) and contradiction detection.

GET/v1/events/{event_id}/timeline

Time-ordered evolution of an event: claim arrivals, source confirmations, status transitions.

GET/v1/events/categories

Event counts and total viewers per topic (Storm Chasing, Conflict, Politics, Natural Disaster, Space, Civil Unrest, …).

GET/v1/channels/reliability

Channel reliability scores: claims_made, claims_confirmed, ELO-derived reliability_score.

Query params: min_claims, limit

Response shape

{
  "id": "dc542c9f-...",
  "title": "Donald Trump escorted out of...",
  "topic": "Politics",
  "status": "LIVE",
  "severity": "critical",
  "confidence_score": 70,
  "source_count": 67,
  "verified_source_count": 5,
  "total_viewers": 135689,
  "region": "Middle East",
  "thumbnail_url": "https://...",
  "created_at": "2026-04-26T01:19:19Z"
}

Need production rate limits, webhooks, or bulk archive search? Contact for production.