Skip to main content
GET https://xquik.com/api/v1/x/spaces/search
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
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 host but not a Space ID. queryType picks how it finds Spaces.
  • Latest and Top return public Spaces about your query. A Space can be live, scheduled, or ended.
  • Live lists Spaces on air now and Upcoming lists scheduled ones. Both match words in Space titles.
For Latest and Top, each page returns up to pageSize Spaces, 20 by default. A page can hold fewer Spaces than pageSize. Send pageSize=100 to finish a search fastest. For Live and Upcoming, each page returns up to pageSize Spaces, in X’s order. Every row is the same full Space that Get Space returns. 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. Results leave out a Space X (Twitter) limits to subscribers or a community. An empty spaces with has_next_page: false means X has no more Spaces for your query. It costs nothing.

Query parameters

Choose fields

Headers

Response

200 OK

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.

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.

503 Service busy

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

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

424 Dependency failed

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 X (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?

Limited Spaces stay out, so a page can hold fewer rows.

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. For example, read it when the Space goes live or ends. For a live video, use Get broadcast.

Response examples

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