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
spaceRows or
space_rows with nextCursor or next_cursor before requesting the next page.
Find Spaces by keyword, host, or topic
UseGET /x/spaces/search when you know a topic or host but not a Space ID.
queryType picks how it finds Spaces.LatestandTopreturn public Spaces about your query. A Space can be live, scheduled, or ended.Livelists Spaces on air now andUpcominglists scheduled ones. Both match words in Space titles.
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 getWWW-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 forRetry-After, then retry.429 Rate limit exceeded
The Xquik tier limit blocked the request. UseRetry-After when present. Otherwise, use the JSON retryAfter field.424 Dependency failed
The opt-in normalized contract returns 424 when the read service fails. Sendxquik-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?
CallGET /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?
Sendq=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. Readstate 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." }