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 (clips.twitch.tv/<slug> or twitch.tv/<channel>/clip/<slug>) and get a clean structured object — not Twitch's raw GraphQL envelope. Channel URLs and usernames are 400 (they belong on /twitch/profile) — not a 16s Apify miss. Includes curator (who cut the clip) separate from channel{id,handle,displayName,url,avatar,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 channel. No flat broadcaster / broadcasterProfileImage twins. 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": 31747,
"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",
"signedVideoUrl": "https://d1ndex63qxojbr.cloudfront.net/nauth/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/h264/1080/index.mp4?sig=9902191e0b3125657995296cbba4f83b41dd920e&token=%7B%22authorization%22%3A%7B%22forbidden%22%3Afalse%2C%22reason%22%3A%22%22%7D%2C%22clip_uri%22%3A%22https%3A%2F%2Fd1ndex63qxojbr.cloudfront.net%2Fnauth%2Fa952a6bb-ad94-4889-8ac1-6afadf21d338%2Flandscape%2Fh264%2F720%2Findex.mp4%22%2C%22clip_slug%22%3A%22EnergeticEmpathicElephantJKanStyle-0sOlvgAod9mDhCw4%22%2C%22device_id%22%3A%222de496b19fa54321aae2acec1f64aeb6%22%2C%22expires%22%3A1786947372%2C%22user_id%22%3A%22%22%2C%22version%22%3A3%7D",
"videoQualities": [
{
"quality": "1080",
"frameRate": 60,
"url": "https://d1ndex63qxojbr.cloudfront.net/nauth/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/h264/1080/index.mp4",
"signedUrl": "https://d1ndex63qxojbr.cloudfront.net/nauth/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/h264/1080/index.mp4?sig=9902191e0b3125657995296cbba4f83b41dd920e&token=%7B%22authorization%22%3A%7B%22forbidden%22%3Afalse%2C%22reason%22%3A%22%22%7D%2C%22clip_uri%22%3A%22https%3A%2F%2Fd1ndex63qxojbr.cloudfront.net%2Fnauth%2Fa952a6bb-ad94-4889-8ac1-6afadf21d338%2Flandscape%2Fh264%2F720%2Findex.mp4%22%2C%22clip_slug%22%3A%22EnergeticEmpathicElephantJKanStyle-0sOlvgAod9mDhCw4%22%2C%22device_id%22%3A%222de496b19fa54321aae2acec1f64aeb6%22%2C%22expires%22%3A1786947372%2C%22user_id%22%3A%22%22%2C%22version%22%3A3%7D"
},
{
"quality": "720",
"frameRate": 60.02,
"url": "https://d1ndex63qxojbr.cloudfront.net/nauth/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/h264/720/index.mp4",
"signedUrl": "https://d1ndex63qxojbr.cloudfront.net/nauth/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/h264/720/index.mp4?sig=9902191e0b3125657995296cbba4f83b41dd920e&token=%7B%22authorization%22%3A%7B%22forbidden%22%3Afalse%2C%22reason%22%3A%22%22%7D%2C%22clip_uri%22%3A%22https%3A%2F%2Fd1ndex63qxojbr.cloudfront.net%2Fnauth%2Fa952a6bb-ad94-4889-8ac1-6afadf21d338%2Flandscape%2Fh264%2F720%2Findex.mp4%22%2C%22clip_slug%22%3A%22EnergeticEmpathicElephantJKanStyle-0sOlvgAod9mDhCw4%22%2C%22device_id%22%3A%222de496b19fa54321aae2acec1f64aeb6%22%2C%22expires%22%3A1786947372%2C%22user_id%22%3A%22%22%2C%22version%22%3A3%7D"
}
],
"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",
"channel": {
"id": "71092938",
"handle": "xqc",
"displayName": "xQc",
"url": "https://www.twitch.tv/xqc",
"avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/xqc-profile_image-9298dca608632101-150x150.jpeg",
"followers": 12535517,
"isPartner": true,
"lastBroadcast": {
"startedAt": "2026-08-15T08:25:40.687536Z",
"title": "🧀LIVE🧀HERE🧀LOCKIN🧀DRAMA🧀NEWS🧀VIDEOS🧀GAMES🧀REACTS🧀THINGS🧀"
}
},
"curator": {
"id": "768198835",
"handle": "puertoricanporo",
"displayName": "puertoricanporo",
"url": "https://www.twitch.tv/puertoricanporo",
"avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/15b6d728-aa8b-47be-a3a3-6474f3bea71e-profile_image-150x150.png"
},
"playbackAccessToken": {
"signature": "9902191e0b3125657995296cbba4f83b41dd920e",
"expires": 1786947372,
"expiresAt": "2026-08-17T06:16:12Z",
"clipUri": "https://d1ndex63qxojbr.cloudfront.net/nauth/a952a6bb-ad94-4889-8ac1-6afadf21d338/landscape/h264/720/index.mp4",
"clipSlug": "EnergeticEmpathicElephantJKanStyle-0sOlvgAod9mDhCw4",
"deviceId": "2de496b19fa54321aae2acec1f64aeb6",
"version": 3,
"authorization": {
"forbidden": false
}
},
"relatedClips": [
{
"id": "3942697259",
"slug": "DeliciousDelightfulPicklesWOOP",
"url": "https://www.twitch.tv/xqc/clip/DeliciousDelightfulPicklesWOOP",
"title": "xqc makes the wrong choice",
"createdAt": "2020-12-09T19:18:10Z",
"views": 949606,
"durationSeconds": 44,
"language": "en",
"thumbnail": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/ce4b4ef1-4e8d-4391-bff6-2bc4c5506a4d/landscape/thumb/thumb-0000000000-1920x1080.jpg"
},
{
"id": "379398706",
"slug": "NimbleProductiveAsparagusHeyGuys-s77ZvN10Yr-O2sfo",
"url": "https://www.twitch.tv/xqc/clip/NimbleProductiveAsparagusHeyGuys-s77ZvN10Yr-O2sfo",
"title": "wow",
"createdAt": "2021-04-04T21:34:33Z",
"views": 776873,
"durationSeconds": 26,
"language": "en",
"thumbnail": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/b0181c83-be87-4dab-ad46-15dde4d81647/landscape/thumb/thumb-0000000000-1920x1080.jpg"
}
]
}
}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 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.signedVideoUrlReady-to-play highest-quality URL with ?sig=&token= appended. Required for current /nauth/ clip CDN paths. Expires with playbackAccessToken.expiresAt.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).
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.signedUrlSigned url URL.
Channel
The channel object contains:
idId of this channel item.handleAccount handle.displayNameDisplay name of the account. Canonical across profile endpoints (prefer over name).urlCanonical URL of the item.avatarAvatar / profile picture URL. Canonical across profile endpoints.followersFollower count.isPartnerWhether the channel is a platform Partner/partner.lastBroadcastMost recent broadcast metadata ({startedAt, title}).
Curator
The curator object contains:
idId of this curator item.handleAccount handle.displayNameDisplay name of the account. Canonical across profile endpoints (prefer over name).urlCanonical URL of the item.avatarAvatar / profile picture URL. Canonical across profile endpoints.
Playback access token
The playbackAccessToken object contains:
signatureSignature. Example: "9902191e0b3125657995296cbba4f83b41dd920e".expiresExpires. Example: 1786947372.expiresAtWhen signed URLs expire (ISO 8601).clipUriClip uri URL.clipSlugClip slug.deviceIdDevice id. Example: "2de496b19fa54321aae2acec1f64aeb6".versionVersion. Example: 3.authorizationObject with forbidden.
Related clips
Each item in relatedClips contains:
idId of this related clips item.slugURL slug of the item.urlCanonical URL of the item.titleTitle of this related clips item.createdAtCreation date (ISO 8601).viewsView count when the platform exposes one.durationSecondsLength in seconds for this item (full media length, or a segment span when the endpoint documents a start/end).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.thumbnailThumbnail image URL.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Twitch clip URL (clips.twitch.tv/<slug> or twitch.tv/<channel>/clip/<slug>). 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. |
| cacheMaxAge | string | No | Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL. |
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. 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.
Can I pass a channel URL?+
No — that is a 400, not a 16-second 404. Use clips.twitch.tv/<slug> or twitch.tv/<channel>/clip/<slug>. Channel URLs belong on /twitch/profile.
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. 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.