Skip to main content
POST
X Spaces API

X Spaces

Look up an X Space, the live audio rooms hosted on X, from its link. Each Space returns its title, whether it is scheduled, live or ended, the scheduled start time, the hosts and co-hosts, the speakers who took the stage, how many people listened live, how many times the recording was replayed and whether a replay is available. Use it to report on Spaces you hosted or sponsored, track a competitor’s live audio program or build a list of the speakers active in your niche.
Provide X Space URLs in urls, using /i/spaces/. Scheduled, live and ended Spaces are supported. Each Space returns one row.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide X Space URLs in urls, using /i/spaces/{space_id}. Scheduled, live and ended Spaces are supported.

urls
string[]
required

Public profile or content URLs.

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object