Spaces

Search X Spaces by keyword, host or topic

Changed on

Returns public Spaces each once, as GET /x/spaces/{id} serves them. Latest & Top find the Spaces that matching posts share, live, scheduled or ended. Live & Upcoming read X's own Spaces search, in X's order. They find live or scheduled Spaces by the words in their titles. Costs 1 credit per Space.

get/x/spaces/search

Request

  • Base URL: https://xquik.com/api/v1
  • URL: https://xquik.com/api/v1/x/spaces/search
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer
    • none

Query parameters

qstring required
Example:from:solana

Words, hashtags or X search operators, such as from:solana. Latest & Top add filter:spaces. Live & Upcoming match title words only, without operators. Alias query. X searches up to 512 characters, and the Spaces filter takes 14 of them.

queryType'Latest' | 'Top' | 'Live' | 'Upcoming'

Latest finds Spaces in the newest posts. Top finds them in the most engaging posts. Live lists Spaces on air now. Upcoming lists scheduled ones, as X's Spaces search does. Any case works. Aliases result_type, sort_order, type, search_type, product, category & section.

cursorstring

Pagination cursor for collection results. Also read as next_cursor, next_token, pagination_token or continuation_token.

pageSizeinteger

For Latest & Top, the posts a page reads, 20 at a time (1-100, default 20). Posts often share the same Space, so a page returns fewer Spaces. Send 100 to read a search fastest. For Live & Upcoming, the most Spaces a page returns. Its aliases are limit, count, max_results, maxItems, max_items & per_page.

fieldsstring
Example:id,text,author.username

Fields to keep in each row, comma-separated. Use dots for nested fields, such as author.username. A list keeps the field in each item. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name answers 400 unknown_field with the valid names, before any read. The price stays the same. SDK row types then hold only the named fields. A longer URL fails at the edge before Xquik reads it.

omitstring
Example:entities,media

Fields to drop from each row, comma-separated. It takes the same names as fields. With fields, it drops from the kept fields. A longer URL fails at the edge before Xquik reads it.

Response

Spaces found

has_next_pageboolean required
next_cursorstring required

Cursor for the next page. Send it unchanged.

Example response

{
  "spaces": [
    {
      "id": "1OGwblLjnQMKB",
      "title": "Extending the Network to the Edge",
      "state": "Ended",
      "admins": [],
      "speakers": [],
      "listeners": []
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}

Changes

  • e415dde519c2Revision changes
    • info

      added the optional property ///////////// to the response with the status

    • info

      added the optional property /////////////// to the response with the status

    • info

      added the optional property /////////////// to the response with the status

    • info

      added the optional property /////////////// to the response with the status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property ///////////// to the response with the status

    • info

      added the optional property ///////////// to the response with the status

    • info

      added the optional property ///////////// to the response with the status

  • 245194cd4ea7Revision changes
    • warning

      added the new topup_in_progress enum value to the ///// response property for the response status

    • warning

      added the new topup_in_progress enum value to the ////// response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the ////// response property for the response status

    • warning

      added the new topup_in_progress enum value to the /////// response property for the response status

    • warning

      added the new topup_in_progress enum value to the ////// response property for the response status

    • warning

      added the new topup_in_progress enum value to the /////// response property for the response status