Twitch

Get Twitch clip transcript

Get the transcript for a Twitch clip by URL.

GET/v1/twitch/clips/transcript
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
urlstringrequiredquery

Link to the Twitch clip whose transcript should be returned.

min 1 chars · max 4096 chars

useAiFallbackbooleanoptionalquery

When true and the clip has no captions, transcribes the audio with AI at no extra cost. Defaults to false, which returns captions only.

Response fields
13

Endpoint-specific response payload.

datalookupStatus
string

Whether the clip was found.

one of: found, not_found

Clip identity when the clip was found; otherwise null.

dataclipid
string

Twitch clip id.

min 1 chars

dataclipurl
string

Canonical public URL of the clip.

min 1 chars

datatranscript
stringnullable

Plain transcript text. Null when the clip has no captions and AI was not requested, or no speech was detected.

datatranscriptSource
stringnullable

Where the transcript came from; null when there is none.

one of: captions, ai, null

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

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/twitch/clips/transcript?url=https://www.twitch.tv/mish/clip/WrongMagnificentTomatoCorgiDerp-C720OEMqocSPbrqA" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Twitch clip transcript.