Twitter spaces search API: find X spaces by keyword

{
  "spaces": [
    {
      "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"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}

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

Twitter spaces search API: find X spaces by keyword

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

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/spaces/search"

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

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

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

	fmt.Println(string(body))

}

{
  "spaces": [
    {
      "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": [
        {}
      ]
    }
  ],
  "has_next_page": true,
  "next_cursor": "<string>"
}

Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page, Xquik returns fewer results. If zero paid results are affordable, it returns 402 insufficient_credits.

1 credit per Space returned · All plans from $0.00012/credit

curl -G https://xquik.com/api/v1/x/spaces/search \
  --data-urlencode "q=from:solana" \
  -H "x-api-key: xq_your_api_key_here" | jq

const query = "from:solana";
const params = new URLSearchParams({ q: query });
const response = await fetch(`https://xquik.com/api/v1/x/spaces/search?${params}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
const nextCursor = data.has_next_page ? data.next_cursor : null;
const spaceRows = data.spaces.map((space, index) => ({
  search_query: query,
  result_rank: index + 1,
  space_id: space.id,
  space_title: space.title ?? null,
  space_state: space.state ?? null,
  started_at: space.startedAt ?? null,
  live_listeners: space.totalLiveListeners ?? null,
  host_usernames: space.admins.map((host) => host.username),
  next_cursor: nextCursor,
}));

import requests

query = "from:solana"
response = requests.get(
    "https://xquik.com/api/v1/x/spaces/search",
    params={"q": query},
    headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
next_cursor = data["next_cursor"] if data["has_next_page"] else None
space_rows = [
    {
        "search_query": query,
        "result_rank": index + 1,
        "space_id": item["id"],
        "space_title": item.get("title"),
        "space_state": item.get("state"),
        "started_at": item.get("startedAt"),
        "live_listeners": item.get("totalLiveListeners"),
        "host_usernames": [host["username"] for host in item["admins"]],
        "next_cursor": next_cursor,
    }
    for index, item in enumerate(data["spaces"])
]

The Node.js and Python snippets build 1 row per Space. Store spaceRows or space_rows with nextCursor or next_cursor before requesting the next page.

Find Spaces by keyword, host, or topic

Use GET /x/spaces/search when you know a topic or a host but not a Space ID. It returns the public Spaces that posts matching your query share. A Space can be live, scheduled, or ended. Each page reads up to pageSize posts, 20 by default, and returns each Space once, in the order the posts share them. Posts often share the same Space, so a page returns fewer Spaces. Send pageSize=100 to read a search fastest. Follow next_cursor while has_next_page is true. Each Space carries the id that Get Space takes. Store the id, since a title can change. Use state to tell a live Space from a scheduled or ended one. A Space X limits to subscribers or a community stays out of the results. An empty spaces array with has_next_page: false means X has no more Spaces for your query. It costs nothing.

Query parameters

string

required

Words, hashtags, or X search operators, such as from:solana. The search adds filter:spaces. Alias: query.

string

default:"Latest"

Latest sorts by post time. Top ranks by engagement. Any case works. Aliases: result_type, sort_order, type, search_type, product, category & section.

string

Pagination cursor from a previous response. Omit for the first page.

integer

default:"20"

Posts a page reads, 20 at a time. Range: 1-100. Posts often share the same Space, so a page returns fewer Spaces. Send 100 to read a search fastest. Aliases: limit, count, max_results, maxItems, max_items & per_page.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object[]

Public Spaces, in the order the posts share them. 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.

boolean

Whether more results are available.

string

Cursor for the next page.

{
  "spaces": [
    {
      "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,
      "admins": [
        {
          "id": "951329744804392960",
          "username": "solana",
          "name": "Solana"
        }
      ],
      "speakers": [],
      "listeners": []
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}

400 Missing query

{ "error": "missing_query", "message": "Search query required. Use q." }

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.

503 Service busy

{ "error": "x_api_unavailable" }

Xquik is busy, or X failed to return 1 of the page’s Spaces. The call costs nothing. Wait for Retry-After, then retry.

429 Rate limit exceeded

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

The Xquik tier limit blocked the request. Use Retry-After when present. Otherwise, use the JSON retryAfter field.

424 Dependency failed

{ "error": "x_api_unavailable" }

The opt-in normalized contract returns 424 when the read service fails. Send xquik-api-contract: 2026-04-29 to opt in. Default v1 returns 502.

Twitter Spaces search questions

How do I search Twitter Spaces by keyword?

Call GET /x/spaces/search with your words in q. Each result is a public Space with its ID, title, state, times, and hosts.

How do I find the Spaces 1 account hosted or shared?

Send q=from:username. The search returns the Spaces that account’s posts share.

How much does a Space search cost?

Each returned Space costs 1 credit. An empty page costs nothing.

Does Space search return live Spaces only?

No. It returns live, scheduled, and ended Spaces. Read state to tell them apart.

Why does a page hold fewer Spaces than `pageSize`?

A page reads up to pageSize posts and returns each Space once. Several posts can share 1 Space, and limited Spaces stay out.

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. Pass a Space id to Get Space to read that Space again, such as when it goes live or ends. For a live video, use Get broadcast.

{
  "spaces": [
    {
      "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"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}

{
  "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": "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 search API: find X spaces by keyword

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

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/spaces/search"

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

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

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

	fmt.Println(string(body))

}

{
  "spaces": [
    {
      "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": [
        {}
      ]
    }
  ],
  "has_next_page": true,
  "next_cursor": "<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

Twitter spaces search API: find X spaces by keyword

Find Spaces by keyword, host, or topic

Query parameters

Headers

Response

200 OK

400 Missing query

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Twitter Spaces search questions

How do I search Twitter Spaces by keyword?

How do I find the Spaces 1 account hosted or shared?

How much does a Space search cost?

Does Space search return live Spaces only?

Why does a page hold fewer Spaces than `pageSize`?

Does this replace X’s official API?

​Find Spaces by keyword, host, or topic

​Query parameters

​Headers

​Response

​200 OK

​400 Missing query

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​Twitter Spaces search questions

​How do I search Twitter Spaces by keyword?

​How do I find the Spaces 1 account hosted or shared?

​How much does a Space search cost?

​Does Space search return live Spaces only?

​Why does a page hold fewer Spaces than pageSize?

​Does this replace X’s official API?

Find Spaces by keyword, host, or topic

Query parameters

Headers

Response

200 OK

400 Missing query

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Twitter Spaces search questions

How do I search Twitter Spaces by keyword?

How do I find the Spaces 1 account hosted or shared?

How much does a Space search cost?

Does Space search return live Spaces only?

Why does a page hold fewer Spaces than `pageSize`?

Does this replace X’s official API?