Twitter Spaces Info API

Fetch X/Twitter Space metadata (title, host, state, listener counts) via API. $0.001 per call. GetXAPI Spaces info endpoint documentation.

GET/twitter/spaces/info

This endpoint costs $0.001 per API call.

Fetch metadata for an X (Twitter) Space, title, host, state, listener counts, and whether it can be downloaded. Synchronous (~1-2s).

Billed from your credits. Spaces info is charged at its standard per-call cost from your credit balance, spending your plan credits first and then your top-up wallet.

Query Parameters

Field	Type	Required	Description
`space_url`	string	Yes	A Space URL or ID, e.g. `https://x.com/i/spaces/1mrGmBvwaBqJy`

Notes

Returns the Space's metadata.
downloadable tells you whether the audio can be downloaded right now, true when the Space is Running, or Ended with replay enabled by the host. Pass the Space to Download Space to get the audio.

Response (200)

{
  "status": "success",
  "msg": "success",
  "data": {
    "space_id": "1mrGmBvwaBqJy",
    "title": "CommonPrefix <> XRP Ledger",
    "state": "Ended",
    "host_username": "Vet_X0",
    "host_name": "Vet",
    "started_at": "2025-12-23T18:30:26.256Z",
    "ended_at": "2025-12-23T19:49:17.692Z",
    "is_live": false,
    "is_replay_available": true,
    "total_live_listeners": 599,
    "total_replay_watched": 2935,
    "downloadable": true
  }
}

Response Fields

Field	Type	Description
`space_id`	string	The Space ID
`title`	string	Space title
`state`	string	`Running` \| `Ended` \| `NotStarted`
`host_username`	string	Host's @handle
`host_name`	string	Host's display name
`started_at` / `ended_at`	string	ISO 8601 timestamps (nullable)
`is_live`	boolean	Space is currently live
`is_replay_available`	boolean	Replay is available to download
`total_live_listeners`	number	Peak live listeners
`total_replay_watched`	number	Replay views
`downloadable`	boolean	Whether the Space's audio can be downloaded right now

Error Responses

400 - Missing space_url

{
  "error": "Missing required field: space_url"
}

Example

curl -X GET "https://api.getxapi.com/twitter/spaces/info?space_url=https://x.com/i/spaces/1mrGmBvwaBqJy" \
  -H "Authorization: Bearer API_KEY"

Space Info