Skip to main content
The X Livestream API enables authorized third-party applications and services to create and manage live video broadcasts on X. It provides a complete set of endpoints for the broadcast lifecycle:
  • Managing persistent RTMP/RTMPS stream sources (ingest points)
  • Creating, publishing (going live), monitoring, and ending broadcasts
  • Creating and managing scheduled broadcasts with one-time and recurring schedules
  • Reading live chat via the X Activity API
  • Sending chat messages to live broadcasts
  • Moderating live chat by removing messages and muting users
Endpoints are hosted under https://api.x.com.

Get started

Prerequisites, Enterprise access, and credentials.

Typical workflow

From stream source to live broadcast, step by step.

​
Core concepts

Two resources form the core of the API:
  • Stream Source — A persistent RTMP/RTMPS ingest point (an ingest URL plus a unique stream key). You create a source once for an encoder/region and reuse it across many broadcasts. A source exists independently of any broadcast.
  • Broadcast — An ephemeral live session bound to a source. A broadcast moves through a lifecycle (NOT_STARTED → RUNNING → ENDED) and represents a single “go live” event that viewers watch on X.
The typical flow is: create a source → start your encoder → create a broadcast → publish (go live) → end. Sources are reusable; broadcasts are one-time sessions. You can also schedule broadcasts in advance — one-time or recurring — with the Livestream Scheduling API. Scheduled broadcasts publish automatically at their scheduled start time or wait for an explicit go-live request.

​
Key identifiers