X live status API to check if a user is live

{
  "live": false,
  "userId": "11348282",
  "userName": "NASA",
  "broadcast": {
    "id": "1DxLdZyVPMMxm",
    "title": "NASA's SpaceX Crew-12 Re-Entry & Splashdown",
    "state": "Ended",
    "startedAt": "2026-10-08T14:20:33.863Z",
    "endedAt": "2026-10-08T16:38:16.770Z"
  }
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "user_not_found",
  "message": "X user not found. Check the username."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

users

{id}

live

X live status API to check if a user is live

curl --request GET \
  --url https://xquik.com/api/v1/x/users/{id}/live

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/users/{id}/live"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "live": true,
  "broadcast": {
    "id": "<string>",
    "title": "<string>",
    "state": "<string>",
    "startedAt": "<string>",
    "endedAt": "<string>",
    "totalWatching": 123
  },
  "userId": "<string>",
  "userName": "<string>"
}

1 credit per check · All plans from $0.00012/credit · Supports guest paid reads

curl "https://xquik.com/api/v1/x/users/nasa/live" \
  -H "x-api-key: xq_your_api_key_here" | jq

const response = await fetch("https://xquik.com/api/v1/x/users/nasa/live", {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const body = await response.json();
if (!response.ok) throw new Error(JSON.stringify(body));

if (body.live) {
  console.log(`@${body.userName} is live: ${body.broadcast.title}`);
} else if (body.broadcast === null) {
  console.log(`@${body.userName} has no broadcast`);
} else {
  console.log(`@${body.userName} last broadcast ended at ${body.broadcast.endedAt}`);
}

import requests

response = requests.get(
    "https://xquik.com/api/v1/x/users/nasa/live",
    headers={"x-api-key": "xq_your_api_key_here"},
)
body = response.json()
if not response.ok:
    raise RuntimeError(body)

broadcast = body["broadcast"]
if body["live"]:
    print(f'@{body["userName"]} is live: {broadcast["title"]}')
elif broadcast is None:
    print(f'@{body["userName"]} has no broadcast')
else:
    print(f'@{body["userName"]} last broadcast ended at {broadcast.get("endedAt")}')

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 same fields as Get broadcast. It is null when X shows no broadcast for the user. Poll it to alert your team when a creator goes live, or to log when a brand’s streams start and end.

Path parameters

string

required

User ID, username with or without @, or URL-encoded profile URL, such as x.com/nasa. See path IDs.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

boolean

true while the user’s latest broadcast is running.

object | null

The user’s latest broadcast, live or ended, or null when X shows none. See Get broadcast for every field.

string

Broadcast ID.

string

Broadcast title.

string

Such as NotStarted, Running, or Ended, as X names it.

string

When the broadcast started, as ISO 8601.

string

When the broadcast ended, as ISO 8601. Omitted while it runs.

number

Viewers watching, as X counts them.

string

ID of the user.

string

Username of the user.

400 Invalid input

{ "error": "invalid_user_id" }

Send a user ID, a username, or a profile URL.

404 User not found

{ "error": "user_not_found", "message": "X user not found. Check the username." }

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.

{ "error": "unauthenticated" }

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

{ "error": "x_api_unavailable" }

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

Related. Get broadcast · Get user · Get Space

{
  "live": false,
  "userId": "11348282",
  "userName": "NASA",
  "broadcast": {
    "id": "1DxLdZyVPMMxm",
    "title": "NASA's SpaceX Crew-12 Re-Entry & Splashdown",
    "state": "Ended",
    "startedAt": "2026-10-08T14:20:33.863Z",
    "endedAt": "2026-10-08T16:38:16.770Z"
  }
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "user_not_found",
  "message": "X user not found. Check the username."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

X live status API to check if a user is live

curl --request GET \
  --url https://xquik.com/api/v1/x/users/{id}/live

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/users/{id}/live"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "live": true,
  "broadcast": {
    "id": "<string>",
    "title": "<string>",
    "state": "<string>",
    "startedAt": "<string>",
    "endedAt": "<string>",
    "totalWatching": 123
  },
  "userId": "<string>",
  "userName": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

X live status API to check if a user is live

Is a user live right now?

Path parameters

Headers

Response

200 OK

400 Invalid input

404 User not found

401 Unauthenticated

402 Payment required

502 X API unavailable

​Is a user live right now?

​Path parameters

​Headers

​Response

​200 OK

​400 Invalid input

​404 User not found

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

Is a user live right now?

Path parameters

Headers

Response

200 OK

400 Invalid input

404 User not found

401 Unauthenticated

402 Payment required

502 X API unavailable