> ## Documentation Index
> Fetch the complete documentation index at: https://video2ctx-feat-polar-billing.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Videos, channels, and playlists

> Retrieve normalized provider resources and their related data.

## Videos

Start with video details, then request only the deeper datasets your workflow needs.

* `GET /v1/providers/youtube/videos/{id}` — core metadata
* `GET /v1/providers/youtube/videos/{id}/tracks` — available transcript tracks
* `GET /v1/providers/youtube/videos/{id}/transcript?format=text|segments|words` — compact text, timed segments, or timed words; omitting `format` preserves the rich words response
* `GET /v1/providers/youtube/videos/{id}/comments` — paginated public comments
* `GET /v1/providers/youtube/videos/{id}/endscreen` — end-screen links

The default comments request returns YouTube's default-ranked page. Add `all=true` for a bounded newest-first collection, then inspect `meta.partial` and `meta.warnings` before treating it as complete.

## Channels

* `GET /v1/providers/youtube/channels/{id}` — profile, public totals, links, and metadata
* `GET /v1/providers/youtube/channels/{id}/videos` — paginated video catalog
* `GET /v1/providers/youtube/channels/{id}/playlists` — paginated playlist catalog

## Playlists

`GET /v1/providers/youtube/playlists/{id}` returns playlist metadata and its paginated video index. Fetching a playlist does not automatically fetch transcripts or comments for every video.

<Tip>
  IDs, handles, and supported YouTube URLs are normalized by the provider pipeline, but hosted API path parameters should use the resource ID returned by discovery whenever possible.
</Tip>