Twitch Clip API
Twitch clip — curator vs channel, signedVideoUrl, unwrapped token, relatedClips (1 credit).
GET request to /v1/twitch/clip that responds with clean JSON and costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh. Start with 100 free credits — no credit card.What is the Twitch Clip API?
Pass a Twitch clip URL (or channel URL/username for a recent clip) and get a clean structured object — not Twitch's raw GraphQL envelope. Includes curator (who cut the clip) separate from channel (id, followers, isPartner, lastBroadcast), BCP-47 lowercase language (same as twitch/profile recentVideos), isFeatured/isPublished, videoOffsetSeconds, gameId/gameSlug/gameBoxArtUrl, videoQualities[{quality,frameRate,url,signedUrl}] with frameRate rounded to 2dp, videoUrl (unsigned source) plus signedVideoUrl (?sig=&token= — required for /nauth/ MP4s; unsigned returns 401), playbackAccessToken as parsed fields (signature, expires, expiresAt, clipUri, clipSlug, deviceId, version, authorization — no escaped JSON value string), and relatedClips[] from the same broadcaster. Flat broadcaster / broadcasterProfileImage kept as deprecated aliases of channel{}. Accepts cache / cacheMaxAge=1d|3d|7d|14d|30d. Flat 1 credit.
Try it
Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).
Parameters
curl "https://api.captapi.com/v1/twitch/clip?url=https%3A%2F%2Fwww.twitch.tv%2Fxqc%2Fclip%2FEnergeticEmpathicElephantJKanStyle-0sOlvgAod9mDhCw4" \
-H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."Edit the parameters and the code updates instantly. Switch languages and hit copy.
Example response
{
"success": true,
"data": {
"platform": "twitch",
"id": "3052590127",
"slug": "EnergeticEmpathicElephantJKanStyle-0sOlvgAod9mDhCw4",
"url": "https://www.twitch.tv/xqc/clip/EnergeticEmpathicElephantJKanStyle-0sOlvgAod9mDhCw4",
"embedUrl": "https://clips.twitch.tv/embed?clip=EnergeticEmpathicElephantJKanStyle-0sOlvgAod9mDhCw4",
"title": "the word",
"createdAt": "2026-07-12T23:00:58Z",
"durationSeconds": 44,
"views": 31603,
"thumbnail": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/thumb/thumb-0000000000-1920x1080.jpg",
"videoUrl": "https://d1ndex63qxojbr.cloudfront.net/nauth/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/h264/1080/index.mp4",
"videoQualities": [
{
"quality": "1080",
"frameRate": 60,
"url": "https://d1ndex63qxojbr.cloudfront.net/nauth/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/h264/1080/index.mp4"
},
{
"quality": "720",
"frameRate": 60.02308654785156,
"url": "https://d1ndex63qxojbr.cloudfront.net/nauth/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/h264/720/index.mp4"
}
],
"language": "EN",
"isFeatured": false,
"isPublished": true,
"videoOffsetSeconds": 1677,
"game": "Just Chatting",
"gameId": "509658",
"gameSlug": "just-chatting",
"gameBoxArtUrl": "https://static-cdn.jtvnw.net/ttv-boxart/509658-285x380.jpg",
"broadcaster": "xqc",
"broadcasterProfileImage": "https://static-cdn.jtvnw.net/jtv_user_pictures/xqc-profile_image-9298dca608632101-150x150.jpeg",
"channel": {
"id": "71092938",
"username": "xqc",
"name": "xQc",
"url": "https://www.twitch.tv/xqc",
"profileImage": "https://static-cdn.jtvnw.net/jtv_user_pictures/xqc-profile_image-9298dca608632101-150x150.jpeg",
"followers": 12531017,
"isPartner": true,
"lastBroadcast": {
"startedAt": "2026-08-02T06:29:57.736501Z",
"title": "🧑🌾LIVE🧑🌾HERE🧑🌾LOCK IN🧑🌾DRAMA🧑🌾NEWS🧑🌾VIDEOSV🧑🌾REACTS🧑🌾TRHNIGS🧑🌾GAMES🧑🌾VIDEOGAMES🧑🌾MAYBE EVEN THINGS AND SUCH"
}
},
"curator": {
"id": "768198835",
"username": "puertoricanporo",
"name": "puertoricanporo",
"url": "https://www.twitch.tv/puertoricanporo",
"profileImage": "https://static-cdn.jtvnw.net/jtv_user_pictures/15b6d728-aa8b-47be-a3a3-6474f3bea71e-profile_image-150x150.png"
},
"playbackAccessToken": {
"signature": "717a7cc45782d584804989cd3b629ae9bdd25364",
"value": "{\"authorization\":{\"forbidden\":false,\"reason\":\"\"},\"clip_uri\":\"https://d1ndex63qxojbr.cloudfront.net/nauth/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/h264/720/index.mp4\",\"clip_slug\":\"EnergeticEmpathicElephantJKanStyle-0sOlvgAod9mDhCw4\",\"device_id\":\"2f4b8c922ff447c6a2667b75c9a2ff30\",\"expires\":1785766190,\"user_id\":\"\",\"version\":3}",
"expires": 1785766190,
"expiresAt": "2026-08-03T14:09:50Z"
}
}
}Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.
Response structure
A successful call returns success, cached, creditsUsed, and a data object with the following fields:
Top-level fields
platformPlatform identifier for this response (matches the endpoint's platform).idStable platform ID for the item.slugURL slug of the item.urlCanonical URL of the item.embedUrlPlatform embed URL when a real embed id is known. Do not invent from a page/permalink id.titleTitle of the item.createdAtCreation date (ISO 8601).durationSecondsLength in seconds for this item (full media length, or a segment span when the endpoint documents a start/end).viewsView count when the platform exposes one.thumbnailThumbnail image URL.videoUrlUnsigned highest-quality source MP4 path (often /nauth/). Does not play by itself — Twitch returns 401 without a signature. Use signedVideoUrl for ready-to-play playback.languageBCP-47 language, lowercase (e.g. en, es). Normalized the same way as twitch/profile recentVideos[].language — Twitch's raw clip field is often uppercase.isFeaturedWhether Twitch marks the clip as featured on the channel.isPublishedWhether the clip is published.videoOffsetSecondsSeconds into the source VOD where the clip starts.gameGame or category being streamed.gameIdTwitch game/category id.gameSlugTwitch game/category slug.gameBoxArtUrlTwitch category/game box art image URL (usually 144×192).broadcasterDeprecated alias of channel.username — prefer channel{}. Kept for back-compat one release.broadcasterProfileImageDeprecated alias of channel.profileImage — prefer channel{}. Kept for back-compat one release.
Video qualities
Each item in videoQualities contains:
qualityQuality tier of the format.frameRateFrames per second for a videoQualities row, rounded to 2 decimal places (Twitch returns raw floats like 60.023…). Example: 60.urlCanonical URL of the item.
Channel
The channel object contains:
idStable platform ID for the item.usernameAccount username / handle.nameName of the item or account. On profile endpoints: deprecated alias of displayName (one release).urlCanonical URL of the item.profileImageProfile image URL. Deprecated alias of avatar on Instagram/Twitter/Threads/TikTok profile endpoints (one release).followersFollower count.isPartnerWhether the channel is a platform Partner/partner.lastBroadcastMost recent broadcast metadata ({startedAt, title}).
Curator
The curator object contains:
idStable platform ID for the item.usernameAccount username / handle.nameName of the item or account. On profile endpoints: deprecated alias of displayName (one release).urlCanonical URL of the item.profileImageProfile image URL. Deprecated alias of avatar on Instagram/Twitter/Threads/TikTok profile endpoints (one release).
Playback access token
The playbackAccessToken object contains:
signatureSignature. Example: "717a7cc45782d584804989cd3b629ae9bdd25364".valueValue.expiresExpires. Example: 1785766190.expiresAtWhen signed URLs expire (ISO 8601).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Twitch clip URL, channel URL, or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble. |
| cache | boolean | No | Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control. Envelope includes cached + cachedAt on hits. |
| cacheMaxAge | string | No | Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL (SC cache_max_age). Envelope: cached + cachedAt. |
Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 1 credit. Pass cache=true for a free 24h cache hit; default is always fresh.
How it works
- 1. Sign up — get 100 free credits, no card required.
- 2. Create a key from your dashboard.
- 3. Send one request to
/v1/twitch/clipand parse the JSON response.
Use cases
Metadata Enrichment
Resolve a URL to structured fields for storage and CRM.
Dashboards
Power reporting with clean JSON instead of HTML scrapes.
Research
Collect entity metadata at scale for analysis.
Frequently asked questions
What does the Twitch Clip API do?+
The Twitch Clip API lets you fetch full metadata and key stats from a public Twitch clip using one GET request to /v1/twitch/clip. It returns clean JSON — no OAuth or infrastructure setup required.
How many credits does the Twitch Clip API cost?+
Each successful call costs 1 credit. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.
Do I need a Twitch API key or OAuth?+
No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.
Is the Twitch Clip API suitable for production use?+
Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.
More Twitch APIs
Ready to use the Twitch Clip API?
Sign up, grab your key, and make your first call in 60 seconds.