Skip to main content
The X Livestream API enables authorized third-party applications and services to create and manage live video broadcasts on X.
The Livestream API is only available under the Enterprise plan. If you are interested in access, fill out the Enterprise interest form.
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