# YouTube API Reference Canonical: https://monsterapi.co/docs/api/youtube Read the YouTube API reference. Review parameters, response fields, examples, and current credit prices. OpenAPI specification: [YouTube](https://monsterapi.co/docs/openapi/platforms/youtube.yaml). --- Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request. --- # YouTube: Channel details `GET /youtube/api/channel/{id}` Documentation: https://monsterapi.co/docs/api/youtube#channel-details Operation ID: `youtube_channel_details` Returns channel information and the content available on its first page. Use the channel ID from video.channel_id in GET /video/{id}/player. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Channel ID beginning with UC, followed by 22 letters, digits, underscores or hyphens. - `cursor` (query, optional): next_cursor from GET /channel/{id}, for the same channel. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/channel/{id}' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Channel information `GET /youtube/api/channel/{id}/about` Documentation: https://monsterapi.co/docs/api/youtube#channel-information Operation ID: `youtube_channel_information` Returns channel information and external links. Requires about_cursor from GET /channel/{id}, passed as cursor for the same channel. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Channel ID used in GET /channel/{id}. - `cursor` (query, required): about_cursor from GET /channel/{id}, passed unchanged. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/channel/{id}/about' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Channel playlists `GET /youtube/api/channel/{id}/playlists` Documentation: https://monsterapi.co/docs/api/youtube#channel-playlists Operation ID: `youtube_channel_playlists` Returns one page of playlists from a channel. Pass next_cursor as cursor to the same path and channel ID. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Channel ID from channel.id in GET /channel/{id} or video.channel_id in GET /video/{id}/player. - `cursor` (query, optional): next_cursor from this path for the same channel. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/channel/{id}/playlists' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Channel shorts `GET /youtube/api/channel/{id}/shorts` Documentation: https://monsterapi.co/docs/api/youtube#channel-shorts Operation ID: `youtube_channel_shorts` Returns one page of short videos from a channel. Pass next_cursor as cursor to the same path and channel ID. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Channel ID from channel.id in GET /channel/{id} or video.channel_id in GET /video/{id}/player. - `cursor` (query, optional): next_cursor from this path for the same channel. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/channel/{id}/shorts' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Channel streams `GET /youtube/api/channel/{id}/streams` Documentation: https://monsterapi.co/docs/api/youtube#channel-streams Operation ID: `youtube_channel_streams` Returns one page of live broadcasts and recordings from a channel. Pass next_cursor as cursor to the same path and channel ID. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Channel ID from channel.id in GET /channel/{id} or video.channel_id in GET /video/{id}/player. - `cursor` (query, optional): next_cursor from this path for the same channel. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/channel/{id}/streams' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Channel videos `GET /youtube/api/channel/{id}/videos` Documentation: https://monsterapi.co/docs/api/youtube#channel-videos Operation ID: `youtube_channel_videos` Returns one page of videos from a channel. Pass next_cursor as cursor to this path with the same channel ID. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Channel ID from video.channel_id in GET /video/{id}/player. - `cursor` (query, optional): next_cursor from GET /channel/{id}/videos, for the same channel. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/channel/{id}/videos' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Video comments `GET /youtube/api/comments` Documentation: https://monsterapi.co/docs/api/youtube#video-comments Operation ID: `youtube_video_comments` Returns one page of video comments or replies. Start with comments_cursor from GET /video/{id}. Continue with next_cursor from this path. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `cursor` (query, required): comments_cursor from GET /video/{id}, or next_cursor from GET /comments. Pass unchanged. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/comments' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Playlist videos `GET /youtube/api/playlist/{id}` Documentation: https://monsterapi.co/docs/api/youtube#playlist-videos Operation ID: `youtube_playlist_videos` Returns one page of playlist information and videos. Pass next_cursor as cursor to this path with the same playlist ID. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Playlist ID from a YouTube URL list parameter or items[].id of type playlist in GET /search. - `cursor` (query, optional): next_cursor from GET /playlist/{id}, for the same playlist. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/playlist/{id}' \ -H 'Authorization: Bearer ' ``` --- # YouTube: URL identifiers `GET /youtube/api/resolve` Documentation: https://monsterapi.co/docs/api/youtube#youtube-url-identifiers Operation ID: `youtube_url_resolve` Returns destination identifiers for one public YouTube URL. Request the returned channel or video ID separately for its information. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `url` (query, required): HTTPS URL on `www.youtube.com`, `youtube.com`, `m.youtube.com` or `youtu.be`. Supported paths: handles, channel IDs, user, c, watch, playlist and shorts. Queries: v, list, index, t, start, si; no duplicates, credentials, port or fragment. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/resolve' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Search results `GET /youtube/api/search` Documentation: https://monsterapi.co/docs/api/youtube#search-results Operation ID: `youtube_search_results` Returns one page of YouTube search results. Pass next_cursor with the same query and filter. Records can repeat within or across pages; duplicates are retained. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `query` (query, required): Search text, from 1 to 512 characters, without control characters. - `cursor` (query, optional): next_cursor from GET /search, with the same query and filter. - `filter` (query, optional): One of videos, channels, playlists, shorts, this_week, popularity. Omit for unfiltered results. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/search' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Search suggestions `GET /youtube/api/search/suggestions` Documentation: https://monsterapi.co/docs/api/youtube#search-suggestions Operation ID: `youtube_search_suggestions` Returns search suggestions for a query. Each response preserves suggestion order and additional information. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `query` (query, required): Search text from 1 to 512 characters, without control characters. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/search/suggestions' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Video details `GET /youtube/api/video/{id}` Documentation: https://monsterapi.co/docs/api/youtube#video-details Operation ID: `youtube_video_details` Returns video information, related videos and a cursor for the first comments page. Pass comments_cursor as cursor to GET /comments. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): YouTube video ID, with 11 letters, digits, underscores or hyphens. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: #/components/responses/GatewayForbidden - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/video/{id}' \ -H 'Authorization: Bearer ' ``` --- # YouTube: Video player information `GET /youtube/api/video/{id}/player` Documentation: https://monsterapi.co/docs/api/youtube#video-player-information Operation ID: `youtube_video_player` Returns video metadata, playback availability and available playback formats for a video ID. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): YouTube video ID, with 11 letters, digits, underscores or hyphens. ## Responses - 200: - 400: Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: #/components/responses/GatewayUnauthorized - 402: #/components/responses/GatewayPaymentRequired - 403: Refused at the gateway: the API key is unknown or revoked - 404: - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: #/components/responses/GatewayConflict - 429: #/components/responses/GatewayTooManyRequests - 500: - 501: - 503: Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/youtube/api/video/{id}/player' \ -H 'Authorization: Bearer ' ```