GET https://xquik.com/api/v1/x/broadcasts/{id}
Get broadcast returns one X (Twitter) broadcast, live or ended. A broadcast is the live video X hosts at x.com/i/broadcasts.
The endpoint is GET /api/v1/x/broadcasts/{id}.
Read a broadcast’s state, times, and audience
UseGET /x/broadcasts/{id} when you hold a broadcast ID or a broadcast URL.
A broadcast is an X live video. For an audio Space, use
Get Space.statetells a broadcast that has not started from a running or ended one.scheduledStart,startedAt, andendedAtgive its times.totalWatchedcounts the accounts that watched, live or after.totalWatchingis the audience X counts now.isAvailableForReplaysays whether X offers a recording.widthandheightgive the video size in pixels.tweetis the post that announces the broadcast, with its text, counts, and author.tweetIdis its ID.creatoris the broadcaster’s full profile.periscopeUsernames the same account as X’s live video service does.
Path parameters
Query parameters
Headers
Response
200 OK
400 Invalid broadcast ID
The path is not a broadcast ID or a broadcast URL. The request costs nothing.401 Unauthenticated
Missing or invalid API key. Check thex-api-key header value.402 Payment required
Account keys get account options. Guest keys get guest top-up only. Anonymous calls receive a direct MPPWWW-Authenticate: Payment challenge plus a guest wallet creation action.
No checkout starts automatically. Confirm any payment action.404 Broadcast not found
X knows no such broadcast. The request costs nothing.502 X API unavailable
The read service returned an error. Retry after a short delay.503 Service busy
Xquik is busy. Wait forRetry-After, then retry. The request costs nothing.429 Rate limit exceeded
You exceeded your tier rate limit. Wait for theRetry-After header before retrying.424 Dependency failed
The normalized v1 response contract can return 424 when the read service is unavailable.Twitter broadcast API questions
How do I get a Twitter broadcast by its link?
URL-encode the broadcast link and pass it asid. You can also pass the ID from the
link. x.com/i/broadcasts/1nGeLMWbkpaKX holds the ID 1nGeLMWbkpaKX.How many people watched a broadcast?
ReadtotalWatched for everyone who watched, live or after. totalWatching is
the audience X counts now.Does reading a broadcast count as a view?
No. Reading a broadcast adds no view, so its counts stay as X shows them.What is the difference between a broadcast and a Space?
A broadcast is a live video. A Space is a live audio room. Read a Space with Get Space.Does this replace X’s official API?
No. This page documents Xquik, an independent third-party service. It does not document X’s official API.Response examples
- 400
{ "error": "invalid_broadcast_id", "message": "Send a broadcast ID or URL, such as x.com/i/broadcasts/1nGeLMWbkpaKX." } - 401
{ "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." } - 402
{ "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 404
{ "error": "broadcast_not_found", "message": "Broadcast not found. Check the broadcast ID or x.com/i/broadcasts URL." } - 424
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 } - 502
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 503
{ "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }