Get Twitter Space stream URL

Get the HLS audio stream URL for an X Space by URL or id.

GET/v1/twitter/spaces/stream
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
urlstringrequiredquery

Space permalink or id.

min 1 chars · max 4096 chars

Response fields
14

Endpoint-specific response payload.

datalookupStatus
string

Whether the Space stream was found.

one of: found, not_found, unavailable

Stream details when a playlist URL is available.

datastreamhlsUrl
string

HLS playlist URL for the Space audio stream.

min 1 chars

datastreamstatus
stringnullable

Upstream stream status label when available.

datastreamstreamType
stringnullable

Stream protocol label when available, typically HLS.

datastreamshareUrl
stringnullable

Public broadcast/share URL when available.

datastreamspaceId
string

Space identifier used for the lookup.

min 1 chars

datastreamspaceState
string

Space lifecycle from the Space details lookup.

one of: running, ended, scheduled, canceled, unknown

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/twitter/spaces/stream?url=https://x.com/i/spaces/1YGNrbYyLROGw" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Space stream URL.