Skip to main content
GET https://xquik.com/api/v1/x/spaces/{id}/replay
1 credit per call · All plans from $0.00012/creditDirect MPP at USD 0.00015 per call
Get Space replay returns the recording X plays back once a Space is over. The endpoint is GET /api/v1/x/spaces/{id}/replay.
Each call costs 1 credit. A refused request costs nothing.

Get the recording of an ended Space

Use GET /x/spaces/{id}/replay once a Space is over, in state Ended or TimedOut. Check state and isAvailableForReplay with Get Space first.
  • An ended Space with a recording returns its HLS playlist in replay.url.
  • A live or scheduled Space answers 409 space_not_ended. Its replay is ready after it ends.
  • A Space whose host kept no recording answers 404 replay_unavailable.
  • A Space cancelled before it started answers 404 space_canceled.
replay.url is an HLS playlist. Play it in a player that reads HLS. Or pass it to a tool that saves HLS streams.

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid Space ID

{ "error": "invalid_space_id", "message": "Send a Space ID or URL, such as x.com/i/spaces/1OGwblLjnQMKB." } The path is not a Space ID or a Space URL. The request costs nothing.

401 Unauthenticated

Missing or invalid API key. Check the x-api-key header value.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. Anonymous calls receive a direct MPP WWW-Authenticate: Payment challenge plus a guest wallet creation action. No checkout starts automatically. Confirm any payment action.

404 No replay

{ "error": "replay_unavailable", "message": "This Space has no replay. Its host kept no recording." } The host kept no recording. The request costs nothing.

404 Space cancelled

{ "error": "space_canceled", "message": "This Space was canceled before it started. It has no replay." } The host cancelled the Space before it started, so there is nothing to replay. The request costs nothing.

404 Space not found

X (Twitter) has no such Space, or limits it to subscribers or a community. The request costs nothing.

409 Space not ended

The Space is live or scheduled. Call again after it ends. The request costs nothing.

502 X API unavailable

The read service returned an error. Retry after a short delay.

503 Service busy

X returned no playback URL, or Xquik is busy. Wait for Retry-After, then retry. The request costs nothing.

429 Rate limit exceeded

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

The normalized v1 response contract can return 424 when the read service is unavailable.

Twitter Spaces replay questions

How do I get the recording of an X (Twitter) Space?

Call GET /x/spaces/{id}/replay with the Space ID or its URL. An ended Space with a recording returns its HLS playlist in replay.url.

Can I get the stream of a live Space?

No. A live or scheduled Space answers 409 space_not_ended. Call again after it ends.

Why does an ended Space have no replay?

Its host kept no recording. Check isAvailableForReplay with Get Space before you call.

How much does a replay lookup cost?

Each replay returned costs 1 credit. A refused request costs nothing.

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. Get Space for the Space’s state & listener counts. Search Spaces to find more Spaces. Get broadcast for a live video.

Response examples

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 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." }
  • 404 { "error": "not_found", "message": "Resource not found." }
  • 409 { "error": "space_not_ended", "message": "This Space has not ended. Its replay is ready after it ends." }
  • 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." }