Get Broadcasts

GET /2/broadcasts returns the authenticated user’s broadcasts, or bulk-looks up broadcasts by ID with the ids query parameter.

GET /2/broadcasts

List Broadcasts

cURL

curl --request GET \
  --url https://api.x.com/2/broadcasts \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "available_for_replay": true,
      "broadcast_id": "<string>",
      "chat_option": 123,
      "created_at_ms": "<string>",
      "end_ms": "<string>",
      "height": 123,
      "id": "<string>",
      "image_url": "<string>",
      "image_url_medium": "<string>",
      "image_url_small": "<string>",
      "is_high_latency": true,
      "language": "<string>",
      "live_category_id": "<string>",
      "media_key": "<string>",
      "scheduled_end_ms": "<string>",
      "scheduled_start_ms": "<string>",
      "share_url": "<string>",
      "source_id": "<string>",
      "start_ms": "<string>",
      "state": "<string>",
      "title": "<string>",
      "total_watched": "<string>",
      "total_watching": "<string>",
      "tweet_id": "<string>",
      "twitter_user_id": "<string>",
      "updated_at_ms": "<string>",
      "width": 123
    }
  ],
  "errors": [
    {
      "detail": "<string>",
      "resource_type": "<string>",
      "title": "<string>",
      "type": "https://api.x.com/2/problems/resource-not-found",
      "parameter": "<string>",
      "resource_id": "<string>",
      "status": 123,
      "value": "<string>"
    }
  ],
  "meta": {
    "next_token": "<string>",
    "result_count": 123
  }
}

Returns broadcasts owned by the authenticated user. This route replaces the deprecated List Broadcasts (GET /2/users/:user_id/broadcasts) — the owning user ID is no longer part of the path, and ownership is still enforced through the authenticated user context.

The endpoint has two modes:

• List — call it with no ids to page through the authenticated user’s broadcasts using pagination_token.
• Bulk lookup — pass a comma-separated ids list (up to 100) to retrieve those specific broadcasts in a single request. Every returned broadcast must be owned by the authenticated user; IDs the caller does not own are omitted from data and reported in errors.

Use broadcast.fields to select which Broadcast fields to return. Many fields (image URLs, start_ms, tweet_id, viewer counts) only populate after the broadcast goes live or later in the lifecycle.

source_id is the source id of the stream source the broadcast streams from, the same value as the source’s id in Get Sources. Request it with broadcast.fields=source_id. It is omitted when the source has been deleted.

The announcement post is created asynchronously after going live, so tweet_id is typically not present immediately — re-fetch the broadcast a moment later to read it.

Authorizations

OAuth2UserTokenUserToken

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

broadcast.read

View your live broadcasts and their chat.

Query Parameters

ids · string[]

Comma-separated broadcast IDs to retrieve instead of listing broadcasts.

Required array length: 1 - 100 elements

Pattern: ^[a-zA-Z0-9]{1,24}$

max_results · integer<int32>

Required range: 1 <= x <= 100

pagination_token · string

Minimum string length: 1

broadcast.fields · enum<string>[]

A comma separated list of Broadcast fields to display. The fields available for a Broadcast object.

Minimum array length: 1

Available options: available_for_replay, broadcast_id, chat_option, created_at_ms, end_ms, height, id, image_url, image_url_medium, image_url_small, is_high_latency, language, live_category_id, media_key, scheduled_end_ms, scheduled_start_ms, share_url, source_id, start_ms, state, title, total_watched, total_watching, tweet_id, twitter_user_id, updated_at_ms, width

Response

200

application/json

The request has succeeded.

data · object[]

Show child attributes

errors · object[]

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Option 19

Option 20

Option 21

Option 22

Option 23

Option 24

Option 25

Option 26

Option 27

Option 28

Option 29

Option 30

Option 31

Option 32

Option 33

Option 34

Option 35

Option 36

Option 37

Option 38

Option 39

Option 40

Option 41

Option 42

Option 43

Option 44

Option 45

Option 46

Option 47

Option 48

Option 49

Option 50

Option 51

Option 52

Option 53

Option 54

Option 55

Option 56

Option 57

Option 58

Option 59

Option 60

Option 61

Show child attributes

meta · object

Show child attributes