# YouTube API

Extract public YouTube videos, channels, Shorts, live broadcasts, comments, playlists, and search results.

- Platform ID: `youtube`
- Capabilities: 13
- Execute endpoint: `POST https://data.upscrape.com/execute`


## Data limits

- Transcripts are on hold and unavailable.
- Comment and list dates retain YouTube’s displayed text, such as “1 year ago”. These relative dates are not exact timestamps; unavailable dates are omitted.
- A Short’s duration may be unavailable. Missing durations are returned as null, never as zero.
- Rounded counts such as “54M” are estimates. Their numeric values are marked with an approximate flag.

## Capabilities

### [List channel community](https://docs.upscrape.com/docs/platforms/youtube/youtube.channel-community.list)

- Capability ID: `youtube.channel-community.list`
- Cost: 1 credit per request

Stream community posts from a channel's community tab.
### [List channel live streams](https://docs.upscrape.com/docs/platforms/youtube/youtube.channel-live.list)

- Capability ID: `youtube.channel-live.list`
- Cost: 1 credit per request

Stream current, scheduled, and archived broadcasts from a channel's Live tab.
### [List channel playlists](https://docs.upscrape.com/docs/platforms/youtube/youtube.channel-playlists.list)

- Capability ID: `youtube.channel-playlists.list`
- Cost: 1 credit per request

Stream playlists from a channel's playlists tab.
### [List channel Shorts](https://docs.upscrape.com/docs/platforms/youtube/youtube.channel-shorts.list)

- Capability ID: `youtube.channel-shorts.list`
- Cost: 1 credit per request

List channel Shorts and view counts. Dates and durations may be unavailable. Rounded numeric counts are marked approximate.
### [List channel videos](https://docs.upscrape.com/docs/platforms/youtube/youtube.channel-videos.list)

- Capability ID: `youtube.channel-videos.list`
- Cost: 1 credit per request

List channel videos with pagination. Dates retain displayed relative text or are omitted. Rounded numeric counts are marked approximate.
### [Get channel](https://docs.upscrape.com/docs/platforms/youtube/youtube.channel.get)

- Capability ID: `youtube.channel.get`
- Cost: 1 credit per request

Fetch metadata for a YouTube channel.
### [List comments](https://docs.upscrape.com/docs/platforms/youtube/youtube.comments.list)

- Capability ID: `youtube.comments.list`
- Cost: 1 credit per request

Fetch top or newest video comments, or replies using a returned replies continuation. Published times retain YouTube’s displayed relative text; rounded counts are marked approximate.
### [List hashtag videos](https://docs.upscrape.com/docs/platforms/youtube/youtube.hashtag.list)

- Capability ID: `youtube.hashtag.list`
- Cost: 1 credit per request

List the public videos shown on a hashtag hub. This is a ranked feed, not proven exhaustive membership.
### [Get playlist](https://docs.upscrape.com/docs/platforms/youtube/youtube.playlist.get)

- Capability ID: `youtube.playlist.get`
- Cost: 1 credit per request

Fetch playlist metadata and videos with pagination. Dates retain displayed text or are omitted. Rounded numeric counts are marked approximate.
### [Get community post](https://docs.upscrape.com/docs/platforms/youtube/youtube.post.get)

- Capability ID: `youtube.post.get`
- Cost: 1 credit per request

Fetch one public community post by URL or id, with its content, media, poll and public counts.
### [Search](https://docs.upscrape.com/docs/platforms/youtube/youtube.search.query)

- Capability ID: `youtube.search.query`
- Cost: 1 credit per request

Search videos, Shorts, channels, playlists and live broadcasts using the legacy filter or composable type, upload_date, duration and sort selectors.
### [Search typeahead](https://docs.upscrape.com/docs/platforms/youtube/youtube.search.typeahead)

- Capability ID: `youtube.search.typeahead`
- Cost: 1 credit per request

Return YouTube's public anonymous search suggestions for a partial query. Suggestions are surface strings, not popularity metrics.
### [Get video](https://docs.upscrape.com/docs/platforms/youtube/youtube.video.get)

- Capability ID: `youtube.video.get`
- Cost: 1 credit per request

Get public video details, approximate counts and the replay heatmap when the source supplies it. Shorts duration may be null. Transcripts are held.

## Common uses

- Track creator publishing and engagement across videos, Shorts, live streams, and community posts
- Build searchable media, channel, playlist, and comment datasets for research and monitoring
- Enrich creator intelligence and content-analysis workflows with normalized public metadata

## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).