YouTubeYouTubeSocial

List YouTube channel subscriptions

youtube.x.youtube-subscriptions-list

subscriptions.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-subscriptions-listPreview

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description
Query parameters
`id`	string	Optional	Return the subscriptions with the given IDs for Stubby or Apiary.
`mine`	boolean	Optional	Flag for returning the subscriptions of the authenticated user.
`part`	string	Required	The part parameter specifies a comma-separated list of one or more subscription 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 subscription resou
`order`	string	Optional	The order of the returned subscriptions
`channelId`	string	Optional	Return the subscriptions of the given channel owner.
`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.
`forChannelId`	string	Optional	Return the subscriptions to the subset of these channels that the authenticated user is subscribed to.
`mySubscribers`	boolean	Optional	Return the subscribers of the given channel owner.
`myRecentSubscribers`	boolean	Optional
`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
idstringOptional
Return the subscriptions with the given IDs for Stubby or Apiary.
minebooleanOptional
Flag for returning the subscriptions of the authenticated user.
partstringRequired
The *part* parameter specifies a comma-separated list of one or more subscription 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 subscription resou
orderstringOptional
The order of the returned subscriptions
channelIdstringOptional
Return the subscriptions of the given channel owner.
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.
forChannelIdstringOptional
Return the subscriptions to the subset of these channels that the authenticated user is subscribed to.
mySubscribersbooleanOptional
Return the subscribers of the given channel owner.
myRecentSubscribersbooleanOptional
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-subscriptions-list' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/youtube.x.youtube-subscriptions-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-subscriptions-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.