Skip to main content
GET https://xquik.com/api/v1/x/users/{id}/live
1 credit per check · All plans from $0.00012/credit · Supports guest paid reads

Is a user live right now?

Use GET /x/users/{id}/live to check whether a user is broadcasting live video on X. Name the user by user ID, username, or profile URL. live is true while the user’s latest broadcast is running. broadcast is that latest broadcast, live or ended, with the fields of Get broadcast. It is null when X shows no broadcast for the user. Poll this endpoint to alert your team when a creator goes live. Polling also lets you log when a brand’s streams start and end.

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

{ "error": "invalid_user_id" } Send a user ID, a username, or a profile URL.

404 User not found

A user X does not know is free of charge.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.

502 X API unavailable

The read service returned an error. Retry after a short delay.

Response examples

200 example

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required." }
  • 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": "user_not_found", "message": "X user not found. Check the username." }
  • 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." }