# YouTube

44 endpoints on YouTube. Every one returns the same response shape and has a flat, published price in credits.

Category: [Video & streaming](https://onekey.dev/docs/categories/video.md) · [Overview page](https://onekey.dev/platforms/youtube)

> [!NOTE] **37 of 44 endpoints are marked "needs a pack" or "may need a pack"** in the table: free credits reach only the open fetch path; a verified email and a purchased pack unlock the rest. See [pricing](https://onekey.dev/pricing).

## Endpoints

| Endpoint | What it does | Cost | Status |
| --- | --- | --- | --- |
| [`channel`](https://onekey.dev/docs/api/youtube/channel.md) | YouTube channel details and statistics by channel id. | 2 credits | beta **may need a pack** |
| [`channel_about`](https://onekey.dev/docs/api/youtube/channel_about.md) | A YouTube channel's public business contact: email (when the channel lists one) and country. | 72 credits | beta **needs a pack** |
| [`channel_by_handle`](https://onekey.dev/docs/api/youtube/channel_by_handle.md) | YouTube channel details by @handle. | 2 credits | beta **may need a pack** |
| [`channel_playlists`](https://onekey.dev/docs/api/youtube/channel_playlists.md) | Playlists published by a YouTube channel (Playlists tab). | 2 credits | stable **may need a pack** |
| [`channel_posts`](https://onekey.dev/docs/api/youtube/channel_posts.md) | Community posts from a YouTube channel (Posts tab). | 2 credits | stable **may need a pack** |
| [`channel_profile`](https://onekey.dev/docs/api/youtube/channel_profile.md) | YouTube channel profile: title, handle, subscriber and video counts, description, avatar. | 1 credit | stable **may need a pack** |
| [`channel_search`](https://onekey.dev/docs/api/youtube/channel_search.md) | Search YouTube channels by keyword. | 2 credits | stable **may need a pack** |
| [`channel_shorts`](https://onekey.dev/docs/api/youtube/channel_shorts.md) | Shorts from a YouTube channel (Shorts tab). | 2 credits | stable **may need a pack** |
| [`channel_streams`](https://onekey.dev/docs/api/youtube/channel_streams.md) | Live streams and past broadcasts from a YouTube channel (Live tab). | 2 credits | stable **may need a pack** |
| [`channel_videos`](https://onekey.dev/docs/api/youtube/channel_videos.md) | Latest uploads from a YouTube channel (Videos tab). | 2 credits | stable **may need a pack** |
| [`channels_batch`](https://onekey.dev/docs/api/youtube/channels_batch.md) | Details and statistics for up to 10 YouTube channels in one call. | 1 credit | beta |
| [`comment_replies`](https://onekey.dev/docs/api/youtube/comment_replies.md) | Replies to a YouTube comment (cursor from the parent comment's replies continuation). | 2 credits | beta **may need a pack** |
| [`comments`](https://onekey.dev/docs/api/youtube/comments.md) | Top-level comments of a YouTube video (first 20). | 2 credits | beta **may need a pack** |
| [`community_post`](https://onekey.dev/docs/api/youtube/community_post.md) | A YouTube community post: text, images, likes and channel. | 2 credits | beta **needs a pack** |
| [`playlist`](https://onekey.dev/docs/api/youtube/playlist.md) | YouTube playlist details. | 1 credit | beta |
| [`playlist_info`](https://onekey.dev/docs/api/youtube/playlist_info.md) | YouTube playlist metadata: title, owner, video count, views, thumbnail. | 1 credit | stable **may need a pack** |
| [`playlist_items`](https://onekey.dev/docs/api/youtube/playlist_items.md) | Videos in a YouTube playlist (first 25). | 2 credits | beta **may need a pack** |
| [`playlist_videos`](https://onekey.dev/docs/api/youtube/playlist_videos.md) | Videos inside a YouTube playlist (first page). | 2 credits | stable **may need a pack** |
| [`related`](https://onekey.dev/docs/api/youtube/related.md) | Related / up-next videos for a YouTube video. | 2 credits | stable **may need a pack** |
| [`resolve`](https://onekey.dev/docs/api/youtube/resolve.md) | Resolve a YouTube @handle or channel URL to its channel id. | 1 credit | stable **may need a pack** |
| [`search`](https://onekey.dev/docs/api/youtube/search.md) | Search YouTube videos (Data API v3; costs 100 quota units per call). | 3 credits | beta **may need a pack** |
| [`search_channels`](https://onekey.dev/docs/api/youtube/search_channels.md) | Search YouTube channels. | 3 credits | beta **may need a pack** |
| [`search_hashtag`](https://onekey.dev/docs/api/youtube/search_hashtag.md) | YouTube videos tagged with a hashtag. | 2 credits | beta **needs a pack** |
| [`search_latest`](https://onekey.dev/docs/api/youtube/search_latest.md) | Search YouTube videos by keyword, newest uploads first. | 2 credits | stable **may need a pack** |
| [`search_live`](https://onekey.dev/docs/api/youtube/search_live.md) | Search currently live YouTube streams by keyword. | 2 credits | stable **may need a pack** |
| [`search_playlists`](https://onekey.dev/docs/api/youtube/search_playlists.md) | Search YouTube playlists by keyword. | 2 credits | stable **may need a pack** |
| [`search_videos`](https://onekey.dev/docs/api/youtube/search_videos.md) | Search YouTube videos by keyword. | 2 credits | stable **may need a pack** |
| [`shorts_trending`](https://onekey.dev/docs/api/youtube/shorts_trending.md) | Currently trending YouTube Shorts. | 2 credits | beta **needs a pack** |
| [`suggest`](https://onekey.dev/docs/api/youtube/suggest.md) | YouTube search autocomplete suggestions for a partial query. | 1 credit | stable |
| [`transcript`](https://onekey.dev/docs/api/youtube/transcript.md) | Timed transcript segments of a YouTube video (cursor from youtube.video_next). | 2 credits | beta **may need a pack** |
| [`trending`](https://onekey.dev/docs/api/youtube/trending.md) | Most popular YouTube videos in a region. | 2 credits | beta **may need a pack** |
| [`video`](https://onekey.dev/docs/api/youtube/video.md) | YouTube video title and channel via oEmbed (no stats: those need an API key). | 1 credit | stable |
| [`video_audio`](https://onekey.dev/docs/api/youtube/video_audio.md) | Downloadable audio stream formats of a YouTube video (signed urls). | 2 credits | beta **needs a pack** |
| [`video_categories`](https://onekey.dev/docs/api/youtube/video_categories.md) | YouTube video categories for a region. | 2 credits | beta |
| [`video_comments`](https://onekey.dev/docs/api/youtube/video_comments.md) | Top-level comments on a YouTube video (page of a continuation cursor). | 2 credits | beta **may need a pack** |
| [`video_details`](https://onekey.dev/docs/api/youtube/video_details.md) | YouTube video details and statistics (Data API v3). | 2 credits | beta **may need a pack** |
| [`video_files`](https://onekey.dev/docs/api/youtube/video_files.md) | Downloadable video stream formats of a YouTube video (signed urls). | 2 credits | beta **needs a pack** |
| [`video_info`](https://onekey.dev/docs/api/youtube/video_info.md) | YouTube video details: title, description, channel, views, likes, duration, publish date. | 1 credit | stable **may need a pack** |
| [`video_next`](https://onekey.dev/docs/api/youtube/video_next.md) | YouTube watch page data and the continuation cursors needed for comments and transcript. | 1 credit | stable **may need a pack** |
| [`video_sponsors`](https://onekey.dev/docs/api/youtube/video_sponsors.md) | Sponsors a YouTube video appears to promote (paid-promotion badge, description links). | 2 credits | beta **needs a pack** |
| [`video_subtitles`](https://onekey.dev/docs/api/youtube/video_subtitles.md) | Subtitle files (language, format, download url) of a YouTube video. | 2 credits | beta **needs a pack** |
| [`video_thumbnails`](https://onekey.dev/docs/api/youtube/video_thumbnails.md) | Thumbnail image of a YouTube video (oEmbed): URL and pixel size, plus title and channel. | 1 credit | stable |
| [`video_transcript`](https://onekey.dev/docs/api/youtube/video_transcript.md) | Timed transcript (captions) of a YouTube video by video id. | 2 credits | beta **needs a pack** |
| [`videos_batch`](https://onekey.dev/docs/api/youtube/videos_batch.md) | Details and statistics for up to 20 YouTube videos in one call. | 1 credit | beta |

Every endpoint page has a **Field mapping** section showing which source field becomes which [unified field](https://onekey.dev/docs/schema.md) (fixed schema) or platform-specific `ext.` field.