YouTube Channel Streams API
Channel Live tab only — liveStatus per row; 0 credits when hasLiveTab is false.
Reads YouTube's Live tab (not Videos). Channels without a Live tab (common for non-streamers) return totalReturned:0 and hasLiveTab:false instead of silently echoing Videos — billed 0 credits (tab check only; no stream fetch). When the Live tab exists, each row is player-enriched with exact viewCount, ISO publishedAt + publishedTimeText, thumbnailUrl, type stream|upcoming, and liveStatus live|upcoming|past. durationSeconds/durationFormatted are null when YouTube reports 0 (live/unknown) — never 00:00:00. Flat 2 credits on the native path when streams are fetched.
Request
- Base URL: https://api.captapi.com
- URL: https://api.captapi.com/v1/youtube/channel-streams
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Query parameters
YouTube channel URL, @handle, bare handle, or UC... channel ID, e.g. https://youtube.com/@handle or @mkbhd. 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.
Max items to return (default 20, max 200). Flat 2 credits when hasLiveTab is true; 0 credits when hasLiveTab is false.
Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Response
Success. The data object for this endpoint.
Changes
No recorded changes to this operation across all 3 revisions of this API.