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).

Spaces is a pay-per-use add-on. Spaces calls are billed from your credit balance even on a subscription plan — they are not part of your plan's included calls.

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