v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB
Spaces

Get broadcast details

Get details of a live video broadcast on Twitter. Returns broadcast metadata including title, current state, media key, dimensions, viewer counts, and timestamps. Useful for monitoring live content on the platform.

get/v1/twitter/spaces/broadcast/{broadcast_id}

Path parameters

broadcast_idstring required
Example:1rmGPkBbVzqKN

The unique ID of the broadcast.

Response

Successfully retrieved broadcast details.

idstring required

Unique broadcast identifier.

titlestring nullable

Title of the broadcast.

statestring nullable

Current state of the broadcast (e.g., running, ended).

media_keystring nullable

Media key for the broadcast stream.

created_atstring nullable

Timestamp when the broadcast was created.

started_atstring nullable

Timestamp when the broadcast started.

widthinteger nullable

Video width in pixels.

heightinteger nullable

Video height in pixels.

total_viewersinteger nullable

Total number of viewers.

Example response

{
  "id": "1rmGPkBbVzqKN"
}