Twitter spaces replay API: get a recording URL

{
  "replay": {
    "url": "https://prod-fastly-us-east-1.video.pscp.tv/Transcoding/v1/hls/example/audio-space/playlist.m3u8?type=replay",
    "streamType": "HLS",
    "status": "LIVE_PUBLIC"
  }
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "space_not_ended",
  "message": "This Space has not ended. Its replay is ready after it ends."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

spaces

{id}

replay

Twitter spaces replay API: get a recording URL

curl --request GET \
  --url https://xquik.com/api/v1/x/spaces/{id}/replay

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/spaces/{id}/replay"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "replay": {
    "url": "<string>",
    "streamType": "<string>",
    "status": "<string>"
  }
}

1 credit per call · All plans from $0.00012/credit · Direct MPP: 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.

curl https://xquik.com/api/v1/x/spaces/1OGwblLjnQMKB/replay \
  -H "x-api-key: xq_your_api_key_here" | jq

const spaceId = "1OGwblLjnQMKB";
const response = await fetch(`https://xquik.com/api/v1/x/spaces/${spaceId}/replay`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
if (!response.ok) throw new Error(JSON.stringify(data));
const replayRow = {
  space_id: spaceId,
  replay_url: data.replay.url,
  stream_type: data.replay.streamType ?? null,
  stream_status: data.replay.status ?? null,
};
process.stdout.write(`${JSON.stringify(replayRow)}\n`);

import json
import requests

space_id = "1OGwblLjnQMKB"
response = requests.get(
    f"https://xquik.com/api/v1/x/spaces/{space_id}/replay",
    headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
if not response.ok:
    raise RuntimeError(data)
replay = data["replay"]
replay_row = {
    "space_id": space_id,
    "replay_url": replay["url"],
    "stream_type": replay.get("streamType"),
    "stream_status": replay.get("status"),
}
print(json.dumps(replay_row))

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

string

required

X Space ID, or the URL-encoded Space URL, such as x.com/i/spaces/1OGwblLjnQMKB.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here authenticates paid_reads guest keys. Direct MPP uses the Payment ... credential. Get it from the WWW-Authenticate: Payment challenge.

Response

200 OK

object

Recording of an ended Space. Replay object fields.

string

HLS playlist of the recording.

string

Stream format, as X names it.

string

Stream status, as X names it.

{
  "replay": {
    "url": "https://prod-fastly-us-east-1.video.pscp.tv/Transcoding/v1/hls/example/audio-space/playlist.m3u8?type=replay",
    "streamType": "HLS",
    "status": "LIVE_PUBLIC"
  }
}

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

{ "error": "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

{ "error": "not_found", "message": "Resource not found." }

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

409 Space not ended

{
  "error": "space_not_ended",
  "message": "This Space has not ended. Its replay is ready after it ends."
}

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

502 X API unavailable

{ "error": "x_api_unavailable" }

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

503 Service busy

{ "error": "x_api_unavailable" }

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

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

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

424 Dependency failed

{ "error": "x_api_unavailable" }

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 a 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, or Get broadcast for a live video.

{
  "replay": {
    "url": "https://prod-fastly-us-east-1.video.pscp.tv/Transcoding/v1/hls/example/audio-space/playlist.m3u8?type=replay",
    "streamType": "HLS",
    "status": "LIVE_PUBLIC"
  }
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "space_not_ended",
  "message": "This Space has not ended. Its replay is ready after it ends."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

Twitter spaces replay API: get a recording URL

curl --request GET \
  --url https://xquik.com/api/v1/x/spaces/{id}/replay

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/spaces/{id}/replay"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "replay": {
    "url": "<string>",
    "streamType": "<string>",
    "status": "<string>"
  }
}

​Get the recording of an ended Space

​Path parameters

​Headers

​Response

​200 OK

​400 Invalid Space ID

​401 Unauthenticated

​402 Payment required

​404 No replay

​404 Space cancelled

​404 Space not found

​409 Space not ended

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​Twitter Spaces replay questions

​How do I get the recording of a Twitter Space?

​Can I get the stream of a live Space?

​Why does an ended Space have no replay?

​How much does a replay lookup cost?

​Does this replace X’s official API?

Get the recording of an ended Space

Path parameters

Headers

Response

200 OK

400 Invalid Space ID

401 Unauthenticated

402 Payment required

404 No replay

404 Space cancelled

404 Space not found

409 Space not ended

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

Twitter Spaces replay questions

How do I get the recording of a Twitter Space?

Can I get the stream of a live Space?

Why does an ended Space have no replay?

How much does a replay lookup cost?

Does this replace X’s official API?