Twitter spaces API: get an X space's details

{
  "space": {
    "id": "1OGwblLjnQMKB",
    "title": "Extending the Network to the Edge",
    "state": "Ended",
    "startedAt": "2026-03-11T17:00:26.227Z",
    "endedAt": "2026-03-11T17:49:29.190Z"
  }
}

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

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

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

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "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

spaces

{id}

Twitter spaces API: get an X space's details

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

package main

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

func main() {

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

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

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

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

	fmt.Println(string(body))

}

{
  "space": {
    "id": "<string>",
    "title": "<string>",
    "state": "<string>",
    "createdAt": "<string>",
    "scheduledStart": "<string>",
    "startedAt": "<string>",
    "endedAt": "<string>",
    "updatedAt": "<string>",
    "totalLiveListeners": 123,
    "totalReplayWatched": 123,
    "participantCount": 123,
    "isAvailableForReplay": true,
    "isAvailableForClipping": true,
    "isLocked": true,
    "isEmployeeOnly": true,
    "disallowJoin": true,
    "noIncognito": true,
    "contentType": "<string>",
    "conversationControls": 123,
    "maxAdminCapacity": 123,
    "mediaKey": "<string>",
    "mentionedUserIds": [
      "<string>"
    ],
    "tweetId": "<string>",
    "tweet": {},
    "creator": {},
    "admins": [
      {}
    ],
    "speakers": [
      {}
    ],
    "listeners": [
      {}
    ],
    "sharings": [
      {}
    ]
  }
}

1 credit per call · All plans from $0.00012/credit · Direct MPP: USD 0.00015 per call

Get Space returns one public X Space as X shows it: live, scheduled, or ended. The endpoint is GET /api/v1/x/spaces/{id}.

curl https://xquik.com/api/v1/x/spaces/1OGwblLjnQMKB \
  -H "x-api-key: xq_your_api_key_here" | jq

const spaceId = "1OGwblLjnQMKB";
const response = await fetch(`https://xquik.com/api/v1/x/spaces/${spaceId}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
if (!response.ok) throw new Error(JSON.stringify(data));
const { space } = data;
const spaceRow = {
  space_id: space.id,
  space_title: space.title ?? null,
  space_state: space.state ?? null,
  started_at: space.startedAt ?? null,
  ended_at: space.endedAt ?? null,
  live_listeners: space.totalLiveListeners ?? null,
  replay_listeners: space.totalReplayWatched ?? null,
  host_usernames: space.admins.map((host) => host.username),
  speaker_usernames: space.speakers.map((speaker) => speaker.username),
};
process.stdout.write(`${JSON.stringify(spaceRow)}\n`);

import json
import requests

space_id = "1OGwblLjnQMKB"
response = requests.get(
    f"https://xquik.com/api/v1/x/spaces/{space_id}",
    headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
if not response.ok:
    raise RuntimeError(data)
space = data["space"]
space_row = {
    "space_id": space["id"],
    "space_title": space.get("title"),
    "space_state": space.get("state"),
    "started_at": space.get("startedAt"),
    "ended_at": space.get("endedAt"),
    "live_listeners": space.get("totalLiveListeners"),
    "replay_listeners": space.get("totalReplayWatched"),
    "host_usernames": [host["username"] for host in space["admins"]],
    "speaker_usernames": [speaker["username"] for speaker in space["speakers"]],
}
print(json.dumps(space_row))

The Node.js and Python snippets build 1 row per Space. Each call costs 1 credit. A refused request costs nothing.

Read a Space’s state, audience, and stage

Use GET /x/spaces/{id} when you hold a Space ID or a Space URL. Find Space IDs with Search Spaces.

state tells a scheduled Space from a live or ended one.
isAvailableForReplay says whether X offers a recording. Get it with Get Space replay once the Space is over.
totalLiveListeners counts the accounts that listened live. totalReplayWatched counts the accounts that played the recording.
participantCount is the audience now, while the Space is live.
admins, speakers, and listeners name the accounts X lists on the stage and in the audience.
sharings lists the posts the hosts and speakers shared in the Space, with who shared each and when.
tweet is the post that announces the Space, with its text, counts, and author.

X names a Space’s hosts, speakers, and listeners without follower counts, so their rows carry none. Pass a username to Get User for the full profile. A field X leaves empty is left out. A Space X limits to subscribers or a community answers 404. A Space is a live audio room. For a live video at x.com/i/broadcasts, use Get broadcast.

Path parameters

string

required

X Space ID, or the URL-encoded Space URL, such as x.com/i/spaces/1OGwblLjnQMKB.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here authenticates paid_reads guest keys. Direct MPP uses the Payment ... credential. Get it from the WWW-Authenticate: Payment challenge.

Response

200 OK

object

The Space. Space object fields.

string

Space ID.

string

Space title.

string

NotStarted (scheduled), Running (live), Ended, Canceled (scheduled, never started) or TimedOut (closed by X, not by its host).

string

When the Space was made.

string

When the Space was set to start.

string

When the Space went live.

string

When the Space ended.

string

When X last changed the Space.

number

Accounts that listened live.

number

Accounts that played the recording.

number

Accounts in the Space now, while it is live.

boolean

Whether X offers a recording.

boolean

Whether listeners may clip the Space.

boolean

Whether the host locked the Space.

boolean

Whether only X employees may join.

boolean

Whether X lets no more accounts join.

boolean

Whether anonymous listening is off.

string

Audio or video kind, as X names it.

number

X’s code for who may speak.

number

Most hosts and co-hosts the Space allows.

string

X’s media key for the Space’s audio.

string[]

IDs of the accounts the host tagged.

string

ID of the post that announces the Space.

object

The post that announces the Space, with the fields of Get Tweet. Present only when X names the post.

object

Profile of the account that made the Space. It uses the fields of Get User.

object[]

Hosts and co-hosts. Each has id, username and name, plus profilePicture, badge fields and joinedAt when X sends them.

object[]

Accounts X lists as speakers, with the same fields as admins.

object[]

Accounts X lists as listeners, with the same fields as admins.

object[]

Posts the hosts and speakers shared in the Space, in X’s order. Present only when X lists them. Each has id, X’s ID of the sharing, plus sharedAt and updatedAt. sharedBy is the profile that shared it, with the fields of Get User. tweet is the post, with the fields of Get Tweet. X leaves out tweet when it no longer shows the post.

{
  "space": {
    "id": "1OGwblLjnQMKB",
    "title": "Extending the Network to the Edge",
    "state": "Ended",
    "startedAt": "2026-03-11T17:00:26.227Z",
    "endedAt": "2026-03-11T17:49:29.190Z",
    "totalLiveListeners": 841,
    "totalReplayWatched": 609,
    "creator": {
      "id": "951329744804392960",
      "username": "solana",
      "name": "Solana"
    },
    "admins": [
      {
        "id": "951329744804392960",
        "username": "solana",
        "name": "Solana"
      }
    ],
    "speakers": [],
    "listeners": []
  }
}

400 Invalid Space ID

{
  "error": "invalid_space_id",
  "message": "Send a Space ID or URL, such as x.com/i/spaces/1OGwblLjnQMKB."
}

The path is not a Space ID or a Space URL. The request costs nothing.

401 Unauthenticated

{ "error": "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 Space not found

{ "error": "not_found", "message": "Resource not found." }

X has no such Space, or X limits it to subscribers or a community. The request costs nothing.

502 X API unavailable

{ "error": "x_api_unavailable" }

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

503 Service busy

{ "error": "x_api_unavailable" }

X failed to return the Space, or Xquik is busy. Retry after a short delay. The request costs nothing.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

Twitter Spaces API questions

How do I get a Twitter Space by its link?

URL-encode the Space link and pass it as id, or pass the Space ID from the link. x.com/i/spaces/1OGwblLjnQMKB holds the ID 1OGwblLjnQMKB.

How many people listened to a Space?

Read totalLiveListeners for the live audience and totalReplayWatched for the recording. While a Space is live, participantCount is the audience now.

Who hosted or spoke in a Space?

admins holds the hosts and co-hosts. speakers holds the accounts X lists as speakers.

Which posts were shared in a Space?

Read sharings. Each sharing has the post as tweet, the account that shared it as sharedBy, and the time as sharedAt.

Why does a Space return 404?

X no longer has the Space, or X limits it to subscribers or a community.

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 Space replay for an ended Space’s recording, Search Spaces to find more Spaces, Get User for a host’s full profile, or Get broadcast for a live video.

{
  "space": {
    "id": "1OGwblLjnQMKB",
    "title": "Extending the Network to the Edge",
    "state": "Ended",
    "startedAt": "2026-03-11T17:00:26.227Z",
    "endedAt": "2026-03-11T17:49:29.190Z"
  }
}

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

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

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

{
  "error": "not_found",
  "message": "Resource not found."
}

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

Twitter spaces API: get an X space's details

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

package main

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

func main() {

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

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

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

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

	fmt.Println(string(body))

}

{
  "space": {
    "id": "<string>",
    "title": "<string>",
    "state": "<string>",
    "createdAt": "<string>",
    "scheduledStart": "<string>",
    "startedAt": "<string>",
    "endedAt": "<string>",
    "updatedAt": "<string>",
    "totalLiveListeners": 123,
    "totalReplayWatched": 123,
    "participantCount": 123,
    "isAvailableForReplay": true,
    "isAvailableForClipping": true,
    "isLocked": true,
    "isEmployeeOnly": true,
    "disallowJoin": true,
    "noIncognito": true,
    "contentType": "<string>",
    "conversationControls": 123,
    "maxAdminCapacity": 123,
    "mediaKey": "<string>",
    "mentionedUserIds": [
      "<string>"
    ],
    "tweetId": "<string>",
    "tweet": {},
    "creator": {},
    "admins": [
      {}
    ],
    "speakers": [
      {}
    ],
    "listeners": [
      {}
    ],
    "sharings": [
      {}
    ]
  }
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Twitter spaces API: get an X space's details

Read a Space’s state, audience, and stage

Path parameters

Headers

Response

200 OK

400 Invalid Space ID

401 Unauthenticated

402 Payment required

404 Space not found

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Twitter Spaces API questions

How do I get a Twitter Space by its link?

How many people listened to a Space?

Who hosted or spoke in a Space?

Which posts were shared in a Space?

Why does a Space return 404?

Does this replace X’s official API?

​Read a Space’s state, audience, and stage

​Path parameters

​Headers

​Response

​200 OK

​400 Invalid Space ID

​401 Unauthenticated

​402 Payment required

​404 Space not found

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​Twitter Spaces API questions

​How do I get a Twitter Space by its link?

​How many people listened to a Space?

​Who hosted or spoke in a Space?

​Which posts were shared in a Space?

​Why does a Space return 404?

​Does this replace X’s official API?

Read a Space’s state, audience, and stage

Path parameters

Headers

Response

200 OK

400 Invalid Space ID

401 Unauthenticated

402 Payment required

404 Space not found

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Twitter Spaces API questions

How do I get a Twitter Space by its link?

How many people listened to a Space?

Who hosted or spoke in a Space?

Which posts were shared in a Space?

Why does a Space return 404?

Does this replace X’s official API?