> **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/youtube/channels-live-streams>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/youtube/channels-live-streams.mdx>

---

# YouTube Channel Live Streams API

A channel's Live tab: what is on air now, what is scheduled, and every past stream with its views and length.

`GET /v1/youtube/channels/live-streams` takes a `handle` or `channelId` and returns `data.streams`, newest first, with any stream on air now at the top. Each stream has `id`, `url`, `title`, `thumbnailUrl` and a `status` of `live`, `upcoming` or `ended`. A live stream carries `watchingCount`; a past one carries `viewCount`, `durationSeconds` and `publishedTimeText`. Pass `data.page.nextCursor` as `cursor` while `data.page.hasMore` is `true`.

Counts are YouTube's rounded figures (`2.3M`), and `viewCountText` keeps the label as shown. An unknown channel is `data.lookupStatus: not_found`; a channel that has never streamed is `found` with no streams.

## Request

- **Endpoint:** `GET /v1/youtube/channels/live-streams`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by channel id or handle
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/youtube/channels/live-streams/get)
- **Platform page:** [/platforms/youtube](https://www.socialfetch.dev/platforms/youtube)

## FAQ

### How do I list a YouTube channel's live streams via API?

Call GET /v1/youtube/channels/live-streams with your Social Fetch API key (x-api-key) and a handle or channelId. Read data.streams, and page with data.page.nextCursor.

### How much does the YouTube Channel Live Streams 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. Each paginated page is a separate billed request.

### How do I tell if a channel is live right now?

Check the first stream's status. It is live while a stream is on air, with watchingCount set to the people watching.

### How exact are the view counts?

They are YouTube's rounded figures: 2.3M becomes 2300000. viewCountText keeps the label exactly as YouTube shows it.
