> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/twitch/clips-transcript>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/twitch/clips-transcript.mdx>

---

# 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` 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`.

## Request

- **Endpoint:** `GET /v1/twitch/clips/transcript`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by clip URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/twitch/clips/transcript/get)
- **Platform page:** [/platforms/twitch](https://www.socialfetch.dev/platforms/twitch)

## 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.
