list_subscriptions
Retrieve subscriptions for a YouTube channel or the authenticated user's subscriptions. Use channel_id for public subscriptions or mine=true for own subscriptions.
Instructions
List a channel's public subscriptions by channel_id (requires API Key), or list your own subscriptions with mine=true (requires OAuth). Returns snippet (title, description, resourceId.channelId) and contentDetails (totalItemCount, newItemCount). Use for_channel_id to check if a channel is subscribed to specific channels. Use page_token to paginate.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_subscriptions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mine | No | Set to true to fetch the authenticated user's subscriptions | |
| channel_id | No | Channel ID to fetch subscriptions for | |
| page_token | No | Token from a previous response to fetch the next page of results. | |
| max_results | No | Default 5 | |
| for_channel_id | No | Comma-separated list of channel IDs to check if the user is subscribed to |