X

X Broadcasts API

Endpoints related to live broadcasts and their chat — 13 operation(s) in the X-published contract.

GitHub OpenAPI

Operations 13

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /2/broadcasts List my live-video broadcasts · List broadcasts #
Ask an LLM
“How can I see all the live-video broadcasts I've run on X?”
“Can I fetch just a few of my broadcasts by their IDs instead of paging?”
Tell an agent
List my recent live-video broadcasts.
Fetch my broadcasts with IDs {ids}.
GET /2/broadcasts/scheduled List my scheduled broadcasts · List scheduled broadcasts #
Ask an LLM
“Which upcoming broadcasts do I have scheduled?”
“Can I filter my scheduled broadcasts to a start-time window?”
Tell an agent
Show all broadcasts I have scheduled.
List scheduled broadcasts starting between {oldest_start_time} and {newest_start_time}.
POST /2/broadcasts/scheduled Schedule a live broadcast · Create a scheduled broadcast #
Ask an LLM
“How do I schedule a live-video broadcast ahead of time?”
“Can I set up a recurring broadcast that I publish manually when ready?”
Tell an agent
Schedule a broadcast on source {source_id} from {scheduled_start_ms} to {scheduled_end_ms}.
Schedule {title} on ingest {source_id} from {scheduled_start_ms} to {scheduled_end_ms} with replay enabled.
DELETE /2/broadcasts/scheduled/{id} Delete a scheduled broadcast · Delete a scheduled broadcast #
Ask an LLM
“Can I cancel a broadcast I scheduled earlier?”
“Can I delete a scheduled broadcast by its ID?”
Tell an agent destructive · confirm first
Delete scheduled broadcast {id}.
Cancel the scheduled broadcast {id} with roll forward {roll_forward}.
GET /2/broadcasts/scheduled/{id} Get one scheduled broadcast · Get a scheduled broadcast #
Ask an LLM
“How do I look up the details of a single scheduled broadcast?”
“What start and end times are set on my scheduled broadcast?”
Tell an agent
Show scheduled broadcast {id}.
Get the schedule details for broadcast {id}.
PUT /2/broadcasts/scheduled/{id} Reschedule a scheduled broadcast · Update a scheduled broadcast #
Ask an LLM
“How do I move a scheduled broadcast to a new time?”
“Do I need to resend every field when editing a scheduled broadcast?”
Tell an agent
Reschedule broadcast {id} ({scheduled_broadcast_id}) to run {scheduled_start_ms} to {scheduled_end_ms}.
Retitle scheduled broadcast {id} to {title}, keeping start {scheduled_start_ms}, end {scheduled_end_ms}, id {scheduled_broadcast_id}.
POST /2/broadcasts/scheduled/{id}/live Go live on a manually published broadcast · Go live on a scheduled broadcast #
Ask an LLM
“How do I start a scheduled broadcast that was set to manual publish?”
“Why is my go-live call rejected when the broadcast wasn't created with manual publish?”
Tell an agent
Go live now on scheduled broadcast {id}.
Publish my manual-publish broadcast {id}.
GET /2/broadcasts/{id} Get one of my broadcasts · Get a broadcast #
Ask an LLM
“How can I retrieve the details of a single live-video broadcast I own?”
“What fields can I request for one broadcast?”
Tell an agent
Get broadcast {id}.
Show broadcast {id} with fields {fields}.
GET /2/broadcasts/{id}/chat Read a broadcast's chat history · Get broadcast chat history #
Ask an LLM
“How do I pull the chat messages from one of my broadcasts?”
“Are broadcast chat messages returned newest first?”
Tell an agent
Show the chat history for broadcast {id}.
Get the latest {max_results} chat messages from broadcast {id}.
POST /2/broadcasts/{id}/chat Post a chat message in a live broadcast · Send a chat message to a live broadcast #
Ask an LLM
“Can I post a comment into my own live broadcast's chat?”
“Can I reply to a specific chat message during a live broadcast?”
Tell an agent
Say {text} in the chat of broadcast {id}.
Reply {text} to chat message {reply_to} in broadcast {id}.
POST /2/broadcasts/{id}/chat/mutes Mute or time out a viewer in broadcast chat · Mute or time out a user in a broadcast chat #
Ask an LLM
“How do I stop a viewer from posting in my live broadcast chat?”
“Can I time a user out of chat until a certain time instead of muting them forever?”
Tell an agent
Mute user {user_id} in broadcast {id}'s chat.
Time out {user_id} in broadcast {id} until {end_at_ms}.
DELETE /2/broadcasts/{id}/chat/mutes/{user_id} Unmute a viewer in broadcast chat · Unmute a user in a broadcast chat #
Ask an LLM
“How do I let a muted viewer talk in my broadcast chat again?”
“Can I lift a chat timeout early on a live broadcast?”
Tell an agent destructive · confirm first
Unmute {user_id} in broadcast {id}'s chat.
Let user {user_id} post again in live broadcast {id}.
DELETE /2/broadcasts/{id}/chat/{message_id} Remove a chat message from a live broadcast · Remove a chat message from a live broadcast #
Ask an LLM
“What's the way to delete an offensive message from my live broadcast chat?”
“Can I remove a single chat message while the broadcast is running?”
Tell an agent destructive · confirm first
Remove chat message {message_id} from broadcast {id}.
Delete message {message_id} in my live broadcast {id}'s chat.

Documentation

📖
Documentation
https://developer.x.com/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/openapi/x-broadcasts-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/x:x-broadcasts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

x-broadcasts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: X API v2 core endpoints
  version: '2.168'
  title: X API v2 Broadcasts API
  termsOfService: https://developer.x.com/en/developer-terms/agreement-and-policy.html
  contact:
    name: X Developers
    url: https://developer.x.com/
  license:
    name: X Developer Agreement and Policy
    url: https://developer.x.com/en/developer-terms/agreement-and-policy.html
servers:
- description: X API
  url: https://api.x.com
tags:


# --- truncated at 32 KB (91 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/x/refs/heads/main/openapi/x-broadcasts-api-openapi.yml