Twitch hub

Twitch Clip Transcript API

Pass a public Twitch clip URL and get its transcript as plain text, with where it came from, in the shared Social Fetch JSON envelope.

GET /v1/twitch/clips/transcript

1 credit Failed requests are free

About this endpoint

GET /v1/twitch/clips/transcript takes a public clip url query param. On a completed 200 response, branch on data.lookupStatus first: found or not_found. When found, data.clip holds the clip id and URL, data.transcript the text, and data.transcriptSource says whether it came from the clip's captions or from ai.

Most clips have no captions. Set useAiFallback=true to transcribe the audio of those clips with AI, at no extra cost. Clip metadata and playable URLs are GET /v1/twitch/clips. Bill from meta.creditsCharged.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Twitch Clip Transcript API FAQ

How do I get a Twitch clip transcript via API?

Call GET /v1/twitch/clips/transcript with your Social Fetch API key (x-api-key) and a public clip url. Add useAiFallback=true to transcribe clips that have no captions. Read data.lookupStatus, then data.transcript.

How much does the Twitch Clip Transcript API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Why is the transcript null?

The clip has no captions and useAiFallback was not set, or no speech was found. Retry with useAiFallback=true to transcribe the audio with AI.

What URL formats does the Twitch Clip Transcript API accept?

Public Twitch clip links, including clips.twitch.tv/… and channel clip paths such as twitch.tv/{handle}/clip/…. VOD links are rejected with a hint.

How long can a clip be?

Any clip Twitch allows. Clips run 60 seconds at most, so every transcript, from captions or AI, costs the same flat price.