YouTubeYouTubeSocial

List a channel's YouTube playlists

youtube.x.youtube-playlists-list

playlists.list — Retrieves a list of resources, possibly filtered.

Price: freeAt provider cost
Success rate: —No success-rate data yetNo success-rate data yet
Latency p50: ——
Last verified: —Not verified yet

GEThttps://toolswitch.dev/v1/tools/youtube.x.youtube-playlists-listPreview

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description
Query parameters
`hl`	string	Optional	Return content in specified language
`id`	string	Optional	Return the playlists with the given IDs for Stubby or Apiary.
`mine`	boolean	Optional	Return the playlists owned by the authenticated user.
`part`	string	Required	The part parameter specifies a comma-separated list of one or more playlist resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a playlist resource, the
`channelId`	string	Optional	Return the playlists owned by the specified channel ID.
`pageToken`	string	Optional	The pageToken parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.
`maxResults`	integer	Optional	The maxResults parameter specifies the maximum number of items that should be returned in the result set.
`onBehalfOfContentOwner`	string	Optional	Note: This parameter is intended exclusively for YouTube content partners. The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is inte
`onBehalfOfContentOwnerChannel`	string	Optional	This parameter can only be used in a properly authorized request. Note: This parameter is intended exclusively for YouTube content partners. The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required whe

Query parameters
hlstringOptional
Return content in specified language
idstringOptional
Return the playlists with the given IDs for Stubby or Apiary.
minebooleanOptional
Return the playlists owned by the authenticated user.
partstringRequired
The *part* parameter specifies a comma-separated list of one or more playlist resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a playlist resource, the
channelIdstringOptional
Return the playlists owned by the specified channel ID.
pageTokenstringOptional
The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.
maxResultsintegerOptional
The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.
onBehalfOfContentOwnerstringOptional
*Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwner* parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is inte
onBehalfOfContentOwnerChannelstringOptional
This parameter can only be used in a properly authorized request. *Note:* This parameter is intended exclusively for YouTube content partners. The *onBehalfOfContentOwnerChannel* parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required whe

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/youtube.x.youtube-playlists-list' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/youtube.x.youtube-playlists-list",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/youtube.x.youtube-playlists-list", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at free, including the service fee.