Skip to main content
GET https://xquik.com/api/v1/x/broadcasts/{id}
1 credit per call · All plans from $0.00012/creditDirect MPP at USD 0.00015 per call
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}.
The Node.js and Python snippets build 1 row per broadcast. Each call costs 1 credit. A refused request costs nothing.

Read a broadcast’s state, times, and audience

Use GET /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.
  • state tells a broadcast that has not started from a running or ended one.
  • scheduledStart, startedAt, and endedAt give its times.
  • totalWatched counts the accounts that watched, live or after. totalWatching is the audience X counts now.
  • isAvailableForReplay says whether X offers a recording.
  • width and height give the video size in pixels.
  • tweet is the post that announces the broadcast, with its text, counts, and author. tweetId is its ID.
  • creator is the broadcaster’s full profile. periscopeUser names the same account as X’s live video service does.
Reading a broadcast adds no view to it. A field X leaves empty is left out.

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 the x-api-key header value.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. Anonymous calls receive a direct MPP WWW-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 for Retry-After, then retry. The request costs nothing.

429 Rate limit exceeded

You exceeded your tier rate limit. Wait for the Retry-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

URL-encode the broadcast link and pass it as id. You can also pass the ID from the link. x.com/i/broadcasts/1nGeLMWbkpaKX holds the ID 1nGeLMWbkpaKX.

How many people watched a broadcast?

Read totalWatched 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.
Next steps. Get User for the broadcaster’s latest profile, or Get Space for an audio Space.

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." }