Focus · YouTube
Typed Focus mode operations for YouTube accounts, generated from the YouTube focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_youtube- Channel dashboard1
- Quota1
- Activities1
- Videos13
- Shorts9
- Scheduled6
- Video localizations4
- Captions6
- Search1
- Playlists7
- Playlist items5
- Playlist images4
- Analytics overview1
- Analytics reach1
- Analytics engagement1
- Analytics audience1
- Analytics demographics1
- Analytics geography1
- Analytics devices1
- Analytics content types1
- Analytics video1
- Analytics retention1
- Analytics playlists1
- Analytics live1
- Analytics report1
- Analytics groups6
- Analytics group items3
- Report types1
- Reporting jobs4
- Reporting reports2
- Comments10
- Comment replies8
- Held for review7
- Live broadcasts11
- Live streams5
- Live chat7
- Live chat moderators3
- Live chat bans2
- Super chats1
- Revenue1
- Members1
- Membership levels1
- Membership analytics1
- Channel2
- Channel localizations4
- Channel banner2
- Watermark3
- Channel sections4
- Subscriptions3
- Subscribers1
- Video categories1
- Languages1
- Regions1
- Abuse reports2
- Managed channels1
Channel dashboard
YouTube: Get Channel dashboard
/accounts/{accountId}/youtube/channel-dashboardChannel stats + 28-day totals + latest 5 uploads with analytics · quota: 3 units + 3 analytics queries (channels.list, playlistItems.list, videos.list, analytics.reports.query). Channel stats, last 28 days, latest uploads with their performance. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/list Generic route: /v1/accounts/{accountId}/focus/channel-dashboard.
Try it with MCPAsk your agent to call youtube-channel-dashboard-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)untilstring (date)Returns object
channelobjectread-onlyShow 6 child attributes
idstringtitlestringthumbnail_urlstring (uri)subscriber_countinteger | nullview_countinteger | nullvideo_countinteger | nullperiodobjectread-onlyShow 2 child attributes
sincestringuntilstringtotalsobjectread-onlyYouTube Analytics totals for the period
latest_videosarray of objectread-onlyShow 38 item attributes
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlytop_videosarray of objectread-onlyShow 3 item attributes
videostringviewsnumberestimatedMinutesWatchednumberanalytics_errorstring | nullread-onlyResponses
Quota
YouTube: Get API quota
/accounts/{accountId}/youtube/quotaQuota buckets and cost table (no API call) · quota: none (no API call). YouTube Data API quota: per-project daily buckets and per-operation costs. Usage comes from ctx.quota.usage() when the API meters it. Network docs: https://developers.google.com/youtube/v3/determine_quota_cost Generic route: /v1/accounts/{accountId}/focus/quota.
Try it with MCPAsk your agent to call youtube-quota-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
resets_atstringread-onlyMidnight Pacific Time
bucketsarray of objectread-onlyShow 4 item attributes
bucketstringlimitintegerusedinteger | nullremaininginteger | nullcostsarray of objectread-onlyShow 3 item attributes
operationstringunitsintegerbucketstringResponses
Activities
YouTube: List Activity feed
/accounts/{accountId}/youtube/activitiesChannel activities · quota: 1 unit (activities.list). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/activities/list Generic route: /v1/accounts/{accountId}/focus/activities.
Try it with MCPAsk your agent to call youtube-activities-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringpublished_afterstring (date-time)published_beforestring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlytypestringread-onlytitlestringread-onlypublished_atstring (date-time)read-onlyvideo_idstring | nullread-onlyplaylist_idstring | nullread-onlythumbnail_urlstring (uri) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Videos
YouTube: List Videos
/accounts/{accountId}/youtube/videosList uploads (uploads playlist + videos.list per page; q= uses search.list) · quota: 2 units (playlistItems.list, videos.list). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringfilterstringdefault: "all"allpublicunlistedprivatescheduledshortsvideosliveprocessingfailed
qstringSearch own videos (uses the 100/day search bucket)
orderstringdateratingrelevancetitleviewCount
scan_pagesintegerdefault: 1Scan several pages for sparse filters
1–10
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 38 item attributes
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Videos item
/accounts/{accountId}/youtube/videosUpload a video (resumable) + optional thumbnail/playlists/captions/first comment · quota: 1 videos.insert bucket (videos.insert). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediastringrequiredVideo file (≤256 GB / 12 h)
titlestringrequired≤ 100 characters
descriptionstring≤ 5000 characters
privacy_statusstringrequireddefault: "private"publicunlistedprivate
publish_atstring (date-time)Schedule: uploads as private, released publicly at this time
self_declared_made_for_kidsbooleanrequiredtagsarray of stringcategory_idstringdefault: "22"default_languagestringdefault_audio_languagestringlocalizationsobjectBCP-47 language → { title, description }
contains_synthetic_mediabooleanhas_paid_product_placementbooleanlicensestringyoutubecreativeCommon
embeddablebooleandefault: truepublic_stats_viewablebooleandefault: truenotify_subscribersbooleandefault: truerecording_datestring (date-time)is_shortbooleanOverride Shorts detection
add_shorts_hashtagbooleandefault: falsethumbnailstringplaylist_idsarray of stringcaptionsarray of objectShow 4 item attributes
mediastringlanguagestringnamestring≤ 150 characters
is_draftbooleanfirst_commentstring≤ 10000 characters
Returns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlyResponses
YouTube: Get a Videos item
/accounts/{accountId}/youtube/videos/{itemId}Video details (all owner parts) · quota: 1 unit (videos.list). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlyResponses
YouTube: Update a Videos item
/accounts/{accountId}/youtube/videos/{itemId}Update metadata (read-modify-write) · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestring≤ 100 characters
descriptionstring≤ 5000 characters
tagsarray of stringcategory_idstringdefault_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullself_declared_made_for_kidsbooleancontains_synthetic_mediabooleanhas_paid_product_placementbooleanlicensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nulllocalizationsobjectBCP-47 language → { title, description }
brand_partnerobjectShow 2 child attributes
channel_idstringpattern ^UC
channel_handlestringpattern ^@
thumbnailstringNew custom thumbnail (JPEG/PNG ≤50 MB)
playlist_idstringAlso add to this playlist
Returns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlyResponses
YouTube: Delete a Videos item
/accounts/{accountId}/youtube/videos/{itemId}Delete permanently · quota: 50 units (videos.delete). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Rate (Videos)
/accounts/{accountId}/youtube/videos/{itemId}/rateLike, dislike or clear rating · quota: 50 units (videos.rate). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-rate (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ratingstringrequiredlikedislikenone
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: My rating (Videos)
/accounts/{accountId}/youtube/videos/{itemId}/ratingRead the channel’s rating · quota: 1 unit (videos.getRating). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-rating (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Set thumbnail (Videos)
/accounts/{accountId}/youtube/videos/{itemId}/set-thumbnailUpload a custom thumbnail (JPEG/PNG ≤50 MB) · quota: 50 units (thumbnails.set). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-set-thumbnail (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediastringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Add to playlist (Videos)
/accounts/{accountId}/youtube/videos/{itemId}/add-to-playlistInsert into a playlist · quota: 50 units (playlistItems.insert). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-add-to-playlist (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
playlist_idstringrequiredpositionintegernotestringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Change visibility (Videos)
/accounts/{accountId}/youtube/videos/{itemId}/set-visibilitySet privacy (clears schedule unless private) · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-set-visibility (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
privacy_statusstringrequiredpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Publish now (Videos)
/accounts/{accountId}/youtube/videos/{itemId}/publish-nowMake public immediately · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-publish-now (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Schedule (Videos)
/accounts/{accountId}/youtube/videos/{itemId}/scheduleSet status.publishAt (video becomes private until then) · quota: 51 units (videos.list, videos.update). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-schedule (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
publish_atstring (date-time)requiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Processing status (Videos)
/accounts/{accountId}/youtube/videos/{itemId}/processing-statusUpload/processing state, failure and rejection reasons · quota: 1 unit (videos.list). All uploads incl. private, unlisted and scheduled. Edit every writable field, upload, delete. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos Generic route: /v1/accounts/{accountId}/focus/videos.
Try it with MCPAsk your agent to call youtube-videos-processing-status (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Shorts
YouTube: List Shorts
/accounts/{accountId}/youtube/shortsList Shorts (scans 3 upload pages by default) · quota: 2 units (playlistItems.list, videos.list). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.
Try it with MCPAsk your agent to call youtube-shorts-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringscan_pagesintegerdefault: 31–10
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 38 item attributes
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Shorts item
/accounts/{accountId}/youtube/shortsUpload a Short (vertical, ≤3 min) · quota: 1 videos.insert bucket (videos.insert). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.
Try it with MCPAsk your agent to call youtube-shorts-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediastringrequiredVideo file (≤256 GB / 12 h)
titlestringrequired≤ 100 characters
descriptionstring≤ 5000 characters
privacy_statusstringrequireddefault: "private"publicunlistedprivate
publish_atstring (date-time)Schedule: uploads as private, released publicly at this time
self_declared_made_for_kidsbooleanrequiredtagsarray of stringcategory_idstringdefault: "22"default_languagestringdefault_audio_languagestringlocalizationsobjectBCP-47 language → { title, description }
contains_synthetic_mediabooleanhas_paid_product_placementbooleanlicensestringyoutubecreativeCommon
embeddablebooleandefault: truepublic_stats_viewablebooleandefault: truenotify_subscribersbooleandefault: truerecording_datestring (date-time)is_shortbooleanOverride Shorts detection
add_shorts_hashtagbooleandefault: falsethumbnailstringplaylist_idsarray of stringcaptionsarray of objectShow 4 item attributes
mediastringlanguagestringnamestring≤ 150 characters
is_draftbooleanfirst_commentstring≤ 10000 characters
Returns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlyResponses
YouTube: Get a Shorts item
/accounts/{accountId}/youtube/shorts/{itemId}Video details (all owner parts) · quota: 1 unit (videos.list). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.
Try it with MCPAsk your agent to call youtube-shorts-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlyResponses
YouTube: Update a Shorts item
/accounts/{accountId}/youtube/shorts/{itemId}Update metadata (read-modify-write) · quota: 51 units (videos.list, videos.update). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.
Try it with MCPAsk your agent to call youtube-shorts-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestring≤ 100 characters
descriptionstring≤ 5000 characters
tagsarray of stringcategory_idstringdefault_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullself_declared_made_for_kidsbooleancontains_synthetic_mediabooleanhas_paid_product_placementbooleanlicensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nulllocalizationsobjectBCP-47 language → { title, description }
brand_partnerobjectShow 2 child attributes
channel_idstringpattern ^UC
channel_handlestringpattern ^@
thumbnailstringNew custom thumbnail (JPEG/PNG ≤50 MB)
playlist_idstringAlso add to this playlist
Returns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlyResponses
YouTube: Delete a Shorts item
/accounts/{accountId}/youtube/shorts/{itemId}Delete permanently · quota: 50 units (videos.delete). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.
Try it with MCPAsk your agent to call youtube-shorts-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Rate (Shorts)
/accounts/{accountId}/youtube/shorts/{itemId}/rateLike, dislike or clear rating · quota: 50 units (videos.rate). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.
Try it with MCPAsk your agent to call youtube-shorts-rate (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
ratingstringrequiredlikedislikenone
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Add to playlist (Shorts)
/accounts/{accountId}/youtube/shorts/{itemId}/add-to-playlistInsert into a playlist · quota: 50 units (playlistItems.insert). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.
Try it with MCPAsk your agent to call youtube-shorts-add-to-playlist (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
playlist_idstringrequiredpositionintegernotestringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Change visibility (Shorts)
/accounts/{accountId}/youtube/shorts/{itemId}/set-visibilitySet privacy (clears schedule unless private) · quota: 51 units (videos.list, videos.update). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.
Try it with MCPAsk your agent to call youtube-shorts-set-visibility (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
privacy_statusstringrequiredpublicunlistedprivate
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Schedule (Shorts)
/accounts/{accountId}/youtube/shorts/{itemId}/scheduleSet status.publishAt (video becomes private until then) · quota: 51 units (videos.list, videos.update). Vertical/square videos ≤3 min (heuristic from file dimensions + duration). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://support.google.com/youtube/answer/15424877 Generic route: /v1/accounts/{accountId}/focus/shorts.
Try it with MCPAsk your agent to call youtube-shorts-schedule (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
publish_atstring (date-time)requiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Scheduled
YouTube: List Scheduled
/accounts/{accountId}/youtube/scheduledScheduled videos (scans up to 4 upload pages) · quota: 2 units (playlistItems.list, videos.list). Private videos with status.publishAt — the native YouTube schedule. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.
Try it with MCPAsk your agent to call youtube-scheduled-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringscan_pagesintegerdefault: 41–10
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 38 item attributes
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Get a Scheduled item
/accounts/{accountId}/youtube/scheduled/{itemId}Video details (all owner parts) · quota: 1 unit (videos.list). Private videos with status.publishAt — the native YouTube schedule. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.
Try it with MCPAsk your agent to call youtube-scheduled-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlyResponses
YouTube: Update a Scheduled item
/accounts/{accountId}/youtube/scheduled/{itemId}Reschedule / edit · quota: 51 units (videos.list, videos.update). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.
Try it with MCPAsk your agent to call youtube-scheduled-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestring≤ 100 characters
descriptionstring≤ 5000 characters
tagsarray of stringcategory_idstringdefault_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullself_declared_made_for_kidsbooleancontains_synthetic_mediabooleanhas_paid_product_placementbooleanlicensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nulllocalizationsobjectBCP-47 language → { title, description }
brand_partnerobjectShow 2 child attributes
channel_idstringpattern ^UC
channel_handlestringpattern ^@
thumbnailstringNew custom thumbnail (JPEG/PNG ≤50 MB)
playlist_idstringAlso add to this playlist
Returns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤5000 bytes
≤ 5000 characters
tagsarray of string≤500 characters in total
category_idstringSee video-categories
default_languagestringdefault_audio_languagestringprivacy_statusstringpublicunlistedprivate
publish_atstring (date-time) | nullScheduled release (video must be private and never published)
is_scheduledbooleanread-onlyself_declared_made_for_kidsbooleanMade for kids (COPPA)
made_for_kidsbooleanread-onlycontains_synthetic_mediabooleanAltered or synthetic content
has_paid_product_placementbooleanIncludes paid promotion
licensestringyoutubecreativeCommon
embeddablebooleanpublic_stats_viewablebooleanrecording_datestring (date-time) | nullthumbnail_urlstring (uri)read-onlypublished_atstring (date-time)read-onlyupload_statusstringread-onlyuploadedprocessedfailedrejecteddeleted
failure_reasonstring | nullread-onlyrejection_reasonstring | nullread-onlyprocessing_statusstring | nullread-onlyduration_secondsinteger | nullread-onlydefinitionstring | nullread-onlycaptionboolean | nullread-onlyhas_custom_thumbnailboolean | nullread-onlyis_shortboolean | nullread-onlyHeuristic: vertical/square and ≤180 s
is_livebooleanread-onlyview_countinteger | nullread-onlylike_countinteger | nullread-onlycomment_countinteger | nullread-onlywidthinteger | nullread-onlyheightinteger | nullread-onlylocalizationsobjectread-onlyBCP-47 language → { title, description }
urlstring (uri)read-onlystudio_urlstring (uri)read-onlyResponses
YouTube: Delete a Scheduled item
/accounts/{accountId}/youtube/scheduled/{itemId}Delete permanently · quota: 50 units (videos.delete). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.
Try it with MCPAsk your agent to call youtube-scheduled-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Publish now (Scheduled)
/accounts/{accountId}/youtube/scheduled/{itemId}/publish-nowMake public immediately · quota: 51 units (videos.list, videos.update). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.
Try it with MCPAsk your agent to call youtube-scheduled-publish-now (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Unschedule (Scheduled)
/accounts/{accountId}/youtube/scheduled/{itemId}/unscheduleKeep private, clear publishAt · quota: 51 units (videos.list, videos.update). Private videos with status.publishAt — the native YouTube schedule. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Generic route: /v1/accounts/{accountId}/focus/scheduled.
Try it with MCPAsk your agent to call youtube-scheduled-unschedule (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Video localizations
YouTube: List Translations
/accounts/{accountId}/youtube/video-localizationsList translations of a video · quota: 1 unit (videos.list). Per-language video title & description (videos.localizations). Needs the video default language. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: /v1/accounts/{accountId}/focus/video-localizations.
Try it with MCPAsk your agent to call youtube-video-localizations-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
video_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringread-onlyvideo_idstringrequiredlanguagestringrequiredtitlestringrequired≤ 100 characters
descriptionstring≤ 5000 characters
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Translations item
/accounts/{accountId}/youtube/video-localizationsAdd a translation · quota: 52 units (videos.list, videos.update). Per-language video title & description (videos.localizations). Needs the video default language. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: /v1/accounts/{accountId}/focus/video-localizations.
Try it with MCPAsk your agent to call youtube-video-localizations-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
video_idstringrequiredlanguagestringrequiredtitlestringrequired≤ 100 characters
descriptionstringdefault_languagestringSet the video default language if missing
Returns object
idstringread-onlyvideo_idstringrequiredlanguagestringrequiredtitlestringrequired≤ 100 characters
descriptionstring≤ 5000 characters
Responses
YouTube: Update a Translations item
/accounts/{accountId}/youtube/video-localizations/{itemId}Edit a translation · quota: 52 units (videos.list, videos.update). Per-language video title & description (videos.localizations). Needs the video default language. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: /v1/accounts/{accountId}/focus/video-localizations.
Try it with MCPAsk your agent to call youtube-video-localizations-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestring≤ 100 characters
descriptionstringReturns object
idstringread-onlyvideo_idstringrequiredlanguagestringrequiredtitlestringrequired≤ 100 characters
descriptionstring≤ 5000 characters
Responses
YouTube: Delete a Translations item
/accounts/{accountId}/youtube/video-localizations/{itemId}Remove a translation · quota: 52 units (videos.list, videos.update). Per-language video title & description (videos.localizations). Needs the video default language. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/videos#localizations Generic route: /v1/accounts/{accountId}/focus/video-localizations.
Try it with MCPAsk your agent to call youtube-video-localizations-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Captions
YouTube: List Subtitles
/accounts/{accountId}/youtube/captionsList tracks of a video · quota: 50 units (captions.list). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.
Try it with MCPAsk your agent to call youtube-captions-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
video_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringread-onlyvideo_idstringrequiredlanguagestringrequirednamestring≤ 150 characters
track_kindstringread-onlystandardasrforced
audio_track_typestring | nullread-onlyis_draftbooleanis_ccboolean | nullread-onlyis_auto_syncedboolean | nullread-onlystatusstringread-onlyservingsyncingfailed
failure_reasonstring | nullread-onlylast_updatedstring (date-time)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Subtitles item
/accounts/{accountId}/youtube/captionsUpload a caption track · quota: 400 units (captions.insert). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.
Try it with MCPAsk your agent to call youtube-captions-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
video_idstringrequiredlanguagestringrequirednamestring≤ 150 characters
is_draftbooleandefault: falsemediastringtextstringOr paste the caption file content
Returns object
idstringread-onlyvideo_idstringrequiredlanguagestringrequirednamestring≤ 150 characters
track_kindstringread-onlystandardasrforced
audio_track_typestring | nullread-onlyis_draftbooleanis_ccboolean | nullread-onlyis_auto_syncedboolean | nullread-onlystatusstringread-onlyservingsyncingfailed
failure_reasonstring | nullread-onlylast_updatedstring (date-time)read-onlyResponses
YouTube: Update a Subtitles item
/accounts/{accountId}/youtube/captions/{itemId}Toggle draft and/or replace the file · quota: 450 units (captions.update). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.
Try it with MCPAsk your agent to call youtube-captions-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
is_draftbooleanmediastringtextstringReturns object
idstringread-onlyvideo_idstringrequiredlanguagestringrequirednamestring≤ 150 characters
track_kindstringread-onlystandardasrforced
audio_track_typestring | nullread-onlyis_draftbooleanis_ccboolean | nullread-onlyis_auto_syncedboolean | nullread-onlystatusstringread-onlyservingsyncingfailed
failure_reasonstring | nullread-onlylast_updatedstring (date-time)read-onlyResponses
YouTube: Delete a Subtitles item
/accounts/{accountId}/youtube/captions/{itemId}Delete a track · quota: 50 units (captions.delete). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.
Try it with MCPAsk your agent to call youtube-captions-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Download (Subtitles)
/accounts/{accountId}/youtube/captions/{itemId}/downloadDownload (convert tfmt, machine-translate tlang) · quota: 200 units (captions.download). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.
Try it with MCPAsk your agent to call youtube-captions-download (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
tfmtstringsbvsccsrtttmlvtt
tlangstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Transcript (Subtitles)
/accounts/{accountId}/youtube/captions/transcriptZernio-style transcript: cues + text · quota: 250 units (captions.list, captions.download). Caption tracks: list, upload (SRT/VTT/SBV/SCC/TTML ≤100 MB), replace, draft toggle, download/translate, delete. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/captions Generic route: /v1/accounts/{accountId}/focus/captions.
Try it with MCPAsk your agent to call youtube-captions-transcript (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
video_idstringrequiredlanguagestringformatstringdefault: "json"jsonsrtvtt
track_idstringtlangstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Search
YouTube: List Search
/accounts/{accountId}/youtube/searchSearch · quota: 1 search.list bucket (search.list). search.list — own content (for_mine) or public. Uses the separate 100 calls/day bucket. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/search/list Generic route: /v1/accounts/{accountId}/focus/search.
Try it with MCPAsk your agent to call youtube-search-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringqstringfor_minebooleandefault: truechannel_idstringtypestringdefault: "video"videochannelplaylist
orderstringdateratingrelevancetitlevideoCountviewCount
event_typestringcompletedliveupcoming
published_afterstring (date-time)published_beforestring (date-time)Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringread-onlykindstringread-onlytitlestringread-onlydescriptionstringread-onlypublished_atstring (date-time)read-onlychannel_idstringread-onlychannel_titlestringread-onlythumbnail_urlstring (uri)read-onlylive_broadcast_contentstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Playlists
YouTube: List Playlists
/accounts/{accountId}/youtube/playlistsList playlists (+ default flag) · quota: 1 unit (playlists.list). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.
Try it with MCPAsk your agent to call youtube-playlists-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringread-onlytitlestringrequired≤ 150 characters
descriptionstring≤ 5000 characters
privacy_statusstringpublicunlistedprivate
item_countinteger | nullread-onlydefault_languagestring | nulllocalizationsobjectBCP-47 language → { title, description }
thumbnail_urlstring (uri) | nullread-onlypublished_atstring (date-time)read-onlypodcast_statusstring | nullread-onlyis_defaultbooleanread-onlySocialit default playlist (UI prefill only)
urlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Playlists item
/accounts/{accountId}/youtube/playlistsCreate playlist (not idempotent) · quota: 50 units (playlists.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.
Try it with MCPAsk your agent to call youtube-playlists-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringrequired≤ 150 characters
descriptionstring≤ 5000 characters
privacy_statusstringdefault: "private"publicunlistedprivate
default_languagestringlocalizationsobjectBCP-47 language → { title, description }
Returns object
idstringread-onlytitlestringrequired≤ 150 characters
descriptionstring≤ 5000 characters
privacy_statusstringpublicunlistedprivate
item_countinteger | nullread-onlydefault_languagestring | nulllocalizationsobjectBCP-47 language → { title, description }
thumbnail_urlstring (uri) | nullread-onlypublished_atstring (date-time)read-onlypodcast_statusstring | nullread-onlyis_defaultbooleanread-onlySocialit default playlist (UI prefill only)
urlstring (uri)read-onlyResponses
YouTube: Get a Playlists item
/accounts/{accountId}/youtube/playlists/{itemId}Playlist details · quota: 1 unit (playlists.list). Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.
Try it with MCPAsk your agent to call youtube-playlists-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestringrequired≤ 150 characters
descriptionstring≤ 5000 characters
privacy_statusstringpublicunlistedprivate
item_countinteger | nullread-onlydefault_languagestring | nulllocalizationsobjectBCP-47 language → { title, description }
thumbnail_urlstring (uri) | nullread-onlypublished_atstring (date-time)read-onlypodcast_statusstring | nullread-onlyis_defaultbooleanread-onlySocialit default playlist (UI prefill only)
urlstring (uri)read-onlyResponses
YouTube: Update a Playlists item
/accounts/{accountId}/youtube/playlists/{itemId}Edit playlist · quota: 51 units (playlists.list, playlists.update). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.
Try it with MCPAsk your agent to call youtube-playlists-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestring≤ 150 characters
descriptionstring≤ 5000 characters
privacy_statusstringdefault: "private"publicunlistedprivate
default_languagestringlocalizationsobjectBCP-47 language → { title, description }
Returns object
idstringread-onlytitlestringrequired≤ 150 characters
descriptionstring≤ 5000 characters
privacy_statusstringpublicunlistedprivate
item_countinteger | nullread-onlydefault_languagestring | nulllocalizationsobjectBCP-47 language → { title, description }
thumbnail_urlstring (uri) | nullread-onlypublished_atstring (date-time)read-onlypodcast_statusstring | nullread-onlyis_defaultbooleanread-onlySocialit default playlist (UI prefill only)
urlstring (uri)read-onlyResponses
YouTube: Delete a Playlists item
/accounts/{accountId}/youtube/playlists/{itemId}Delete playlist · quota: 50 units (playlists.delete). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.
Try it with MCPAsk your agent to call youtube-playlists-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Set as default (Playlists)
/accounts/{accountId}/youtube/playlists/{itemId}/set-defaultDefault playlist for the composer (stored on the account; validated) · quota: 1 unit (playlists.list). Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.
Try it with MCPAsk your agent to call youtube-playlists-set-default (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Add video (Playlists)
/accounts/{accountId}/youtube/playlists/{itemId}/add-videoInsert a video · quota: 50 units (playlistItems.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlists Generic route: /v1/accounts/{accountId}/focus/playlists.
Try it with MCPAsk your agent to call youtube-playlists-add-video (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
video_idstringrequiredpositionintegernotestring≤ 280 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Playlist items
YouTube: List Playlist items
/accounts/{accountId}/youtube/playlist-itemsItems of a playlist · quota: 1 unit (playlistItems.list). Videos in a playlist: add, reorder (position), note, remove. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: /v1/accounts/{accountId}/focus/playlist-items.
Try it with MCPAsk your agent to call youtube-playlist-items-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringplaylist_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringread-onlyplaylist_idstringrequiredvideo_idstringrequiredtitlestringread-onlypositionintegernotestring | null≤ 280 characters
start_atstring | nullend_atstring | nullthumbnail_urlstring (uri) | nullread-onlyvideo_published_atstring (date-time) | nullread-onlyadded_atstring (date-time)read-onlyprivacy_statusstring | nullread-onlyvideo_owner_channel_titlestring | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Playlist items item
/accounts/{accountId}/youtube/playlist-itemsAdd a video · quota: 50 units (playlistItems.insert). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: /v1/accounts/{accountId}/focus/playlist-items.
Try it with MCPAsk your agent to call youtube-playlist-items-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
playlist_idstringrequiredvideo_idstringrequiredpositionintegernotestring≤ 280 characters
Returns object
idstringread-onlyplaylist_idstringrequiredvideo_idstringrequiredtitlestringread-onlypositionintegernotestring | null≤ 280 characters
start_atstring | nullend_atstring | nullthumbnail_urlstring (uri) | nullread-onlyvideo_published_atstring (date-time) | nullread-onlyadded_atstring (date-time)read-onlyprivacy_statusstring | nullread-onlyvideo_owner_channel_titlestring | nullread-onlyResponses
YouTube: Update a Playlist items item
/accounts/{accountId}/youtube/playlist-items/{itemId}Reorder / edit note · quota: 51 units (playlistItems.list, playlistItems.update). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: /v1/accounts/{accountId}/focus/playlist-items.
Try it with MCPAsk your agent to call youtube-playlist-items-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
positionintegernotestring≤ 280 characters
playlist_idstringvideo_idstringReturns object
idstringread-onlyplaylist_idstringrequiredvideo_idstringrequiredtitlestringread-onlypositionintegernotestring | null≤ 280 characters
start_atstring | nullend_atstring | nullthumbnail_urlstring (uri) | nullread-onlyvideo_published_atstring (date-time) | nullread-onlyadded_atstring (date-time)read-onlyprivacy_statusstring | nullread-onlyvideo_owner_channel_titlestring | nullread-onlyResponses
YouTube: Delete a Playlist items item
/accounts/{accountId}/youtube/playlist-items/{itemId}Remove from playlist · quota: 50 units (playlistItems.delete). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: /v1/accounts/{accountId}/focus/playlist-items.
Try it with MCPAsk your agent to call youtube-playlist-items-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Move (Playlist items)
/accounts/{accountId}/youtube/playlist-items/{itemId}/moveMove to a position (0-based) · quota: 51 units (playlistItems.list, playlistItems.update). Videos in a playlist: add, reorder (position), note, remove. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistItems Generic route: /v1/accounts/{accountId}/focus/playlist-items.
Try it with MCPAsk your agent to call youtube-playlist-items-move (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
positionintegerrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Playlist images
YouTube: List Playlist images
/accounts/{accountId}/youtube/playlist-imagesImages of a playlist · quota: 1 unit (playlistImages.list). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: /v1/accounts/{accountId}/focus/playlist-images.
Try it with MCPAsk your agent to call youtube-playlist-images-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringplaylist_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringread-onlyplaylist_idstringrequiredtypestringdefault: "hero"widthinteger | nullread-onlyheightinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Playlist images item
/accounts/{accountId}/youtube/playlist-imagesUpload image · quota: 50 units (playlistImages.insert). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: /v1/accounts/{accountId}/focus/playlist-images.
Try it with MCPAsk your agent to call youtube-playlist-images-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
playlist_idstringrequiredmediastringrequiredtypestringdefault: "hero"Returns object
idstringread-onlyplaylist_idstringrequiredtypestringdefault: "hero"widthinteger | nullread-onlyheightinteger | nullread-onlyResponses
YouTube: Update a Playlist images item
/accounts/{accountId}/youtube/playlist-images/{itemId}Replace image · quota: 50 units (playlistImages.update). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: /v1/accounts/{accountId}/focus/playlist-images.
Try it with MCPAsk your agent to call youtube-playlist-images-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
playlist_idstringrequiredmediastringrequiredtypestringReturns object
idstringread-onlyplaylist_idstringrequiredtypestringdefault: "hero"widthinteger | nullread-onlyheightinteger | nullread-onlyResponses
YouTube: Delete a Playlist images item
/accounts/{accountId}/youtube/playlist-images/{itemId}Delete image · quota: 50 units (playlistImages.delete). Custom playlist thumbnails (1:1 JPEG/PNG ≤50 MB). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/playlistImages Generic route: /v1/accounts/{accountId}/focus/playlist-images.
Try it with MCPAsk your agent to call youtube-playlist-images-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Analytics overview
YouTube: Get Overview
/accounts/{accountId}/youtube/analytics-overviewOverview (daily + totals + cards + content types + channel insights) · quota: 6 analytics queries (analytics.reports.query). Views, watch time, subscribers, engagement — daily series + period totals + Shorts/long-form split. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/reports/query Generic route: /v1/accounts/{accountId}/focus/analytics-overview.
Try it with MCPAsk your agent to call youtube-analytics-overview-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
granularitystringdefault: "day"daymonth
video_idstringReturns object
sincestringread-onlyuntilstringread-onlytotalsobjectread-onlyNormalized metrics
seriesarray of objectread-onlyShow 2 item attributes
datestringmetricsobjectyoutube_totalsobjectread-onlyYouTube-named totals
youtube_seriesarray of objectread-onlyShow 2 item attributes
datestringmetricsobjectcontent_typesarray of objectread-onlyinsightsobjectread-onlyZernio channel-insights shape
errorsobjectread-onlyResponses
Analytics reach
YouTube: Get Reach
/accounts/{accountId}/youtube/analytics-reachReach: traffic_sources, traffic_sources_daily, search_terms, external_sites, playback_locations, embedded_sites, impressions · quota: 7 analytics queries (analytics.reports.query). Traffic sources, YouTube search terms, external sites, playback locations; thumbnail impressions/CTR via the Reporting API reach job. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-reach.
Try it with MCPAsk your agent to call youtube-analytics-reach-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringFilter to one video
playlist_idstringgroup_idstringAnalytics group
countrystringISO 3166-1 alpha-2
creator_content_typestringSHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY
include_impressionsbooleandefault: falseRead channel_reach_basic_a1 bulk reports
Returns object
sincestring (date)read-onlyuntilstring (date)read-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Analytics engagement
YouTube: Get Engagement
/accounts/{accountId}/youtube/analytics-engagementEngagement: engagement, watch_time, top_videos, subscribers_by_video, sharing_services, cards, engaged_views · quota: 7 analytics queries (analytics.reports.query). Likes, comments, shares, playlist adds, subscribers per video, cards, sharing services, top videos. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-engagement.
Try it with MCPAsk your agent to call youtube-analytics-engagement-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringFilter to one video
playlist_idstringgroup_idstringAnalytics group
countrystringISO 3166-1 alpha-2
creator_content_typestringSHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY
Returns object
sincestring (date)read-onlyuntilstring (date)read-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Analytics audience
YouTube: Get Audience
/accounts/{accountId}/youtube/analytics-audienceAudience: demographics, age, gender, subscribed_status, youtube_products, countries · quota: 6 analytics queries (analytics.reports.query). Age, gender, subscribed vs not, YouTube products, top countries. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-audience.
Try it with MCPAsk your agent to call youtube-analytics-audience-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringFilter to one video
playlist_idstringgroup_idstringAnalytics group
countrystringISO 3166-1 alpha-2
creator_content_typestringSHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY
Returns object
sincestring (date)read-onlyuntilstring (date)read-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Analytics demographics
YouTube: Get Demographics
/accounts/{accountId}/youtube/analytics-demographicsDemographics · quota: 3 analytics queries (analytics.reports.query). Zernio-style age/gender (viewer %) and country (views), channel or per video. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-demographics.
Try it with MCPAsk your agent to call youtube-analytics-demographics-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringbreakdownstringdefault: "age,gender,country"Returns object
demographicsobjectread-onlyShow 3 child attributes
agearray of objectShow 2 item attributes
dimensionstringvaluenumbergenderarray of objectShow 2 item attributes
dimensionstringvaluenumbercountryarray of objectShow 2 item attributes
dimensionstringvaluenumberResponses
Analytics geography
YouTube: Get Geography
/accounts/{accountId}/youtube/analytics-geographyGeography: countries, us_states, cities · quota: 3 analytics queries (analytics.reports.query). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-geography.
Try it with MCPAsk your agent to call youtube-analytics-geography-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringFilter to one video
playlist_idstringgroup_idstringAnalytics group
countrystringISO 3166-1 alpha-2
creator_content_typestringSHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY
Returns object
sincestring (date)read-onlyuntilstring (date)read-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Analytics devices
YouTube: Get Devices
/accounts/{accountId}/youtube/analytics-devicesDevices: devices, operating_systems, device_os · quota: 3 analytics queries (analytics.reports.query). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-devices.
Try it with MCPAsk your agent to call youtube-analytics-devices-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringFilter to one video
playlist_idstringgroup_idstringAnalytics group
countrystringISO 3166-1 alpha-2
creator_content_typestringSHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY
Returns object
sincestring (date)read-onlyuntilstring (date)read-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Analytics content types
YouTube: Get Shorts vs videos vs live
/accounts/{accountId}/youtube/analytics-content-typesShorts vs videos vs live: content_types, content_types_daily, top_shorts, premium · quota: 4 analytics queries (analytics.reports.query). creatorContentType split, daily, top Shorts, Premium views. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-content-types.
Try it with MCPAsk your agent to call youtube-analytics-content-types-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringFilter to one video
playlist_idstringgroup_idstringAnalytics group
countrystringISO 3166-1 alpha-2
creator_content_typestringSHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY
Returns object
sincestring (date)read-onlyuntilstring (date)read-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Analytics video
YouTube: Get Video analytics
/accounts/{accountId}/youtube/analytics-videoPer-video analytics (Zernio daily-views + more) · quota: 2 units + 4 analytics queries (videos.list, analytics.reports.query). One video: daily views/watch time/engagement, traffic sources, retention, demographics. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/channel_reports#video-reports Generic route: /v1/accounts/{accountId}/focus/analytics-video.
Try it with MCPAsk your agent to call youtube-analytics-video-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringReturns object
video_idstringread-onlydailyobjectread-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Analytics retention
YouTube: Get Audience retention
/accounts/{accountId}/youtube/analytics-retentionRetention curve · quota: 1 unit + 1 analytics query (videos.list, analytics.reports.query). audienceWatchRatio by elapsedVideoTimeRatio (100 points), relative retention, started/stopped watching. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/channel_reports#audience-retention-reports Generic route: /v1/accounts/{accountId}/focus/analytics-retention.
Try it with MCPAsk your agent to call youtube-analytics-retention-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringaudience_typestringORGANICAD_INSTREAMAD_INDISPLAY
Returns object
videoIdstringread-onlytitlestring | nullread-onlydurationSecondsinteger | nullread-onlyretentionCurvearray of objectread-onlyShow 6 item attributes
elapsedVideoTimeRationumberaudienceWatchRationumber | nullrelativeRetentionPerformancenumber | nullstartedWatchingnumber | nullstoppedWatchingnumber | nulltotalSegmentImpressionsnumber | nullResponses
Analytics playlists
YouTube: Get Playlist analytics
/accounts/{accountId}/youtube/analytics-playlistsPlaylist analytics: top_playlists, playlist_daily · quota: 2 analytics queries (analytics.reports.query). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-playlists.
Try it with MCPAsk your agent to call youtube-analytics-playlists-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringFilter to one video
playlist_idstringgroup_idstringAnalytics group
countrystringISO 3166-1 alpha-2
creator_content_typestringSHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY
Returns object
sincestring (date)read-onlyuntilstring (date)read-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Analytics live
YouTube: Get Live analytics
/accounts/{accountId}/youtube/analytics-liveLive analytics: live_vs_on_demand, concurrent, summary · quota: 3 analytics queries (analytics.reports.query). Live vs on-demand; concurrent viewers for a stream (video_id). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/analytics-live.
Try it with MCPAsk your agent to call youtube-analytics-live-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringFilter to one video
playlist_idstringgroup_idstringAnalytics group
countrystringISO 3166-1 alpha-2
creator_content_typestringSHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY
Returns object
sincestring (date)read-onlyuntilstring (date)read-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Analytics report
YouTube: Get Report builder
/accounts/{accountId}/youtube/analytics-reportRun a report · quota: 1 analytics query (analytics.reports.query). Any named report (54) or a custom reports.query (metrics/dimensions/filters/sort). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/reports/query Generic route: /v1/accounts/{accountId}/focus/analytics-report.
Try it with MCPAsk your agent to call youtube-analytics-report-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
video_idstringFilter to one video
playlist_idstringgroup_idstringAnalytics group
countrystringISO 3166-1 alpha-2
creator_content_typestringSHORTSVIDEO_ON_DEMANDLIVE_STREAMSTORY
reportstringdefault: "daily"overviewdailymonthlyengaged-viewsengagementwatch-timesubscriberssubscribers-by-videotop-videostraffic-sourcestraffic-sources-dailytraffic-source-detailsearch-termsexternal-sitesplayback-locationsplayback-location-detaildevicesoperating-systemsdevice-oscountriesprovincescitiessubscribed-statussharing-services+30 more
metricsstringcustom: comma-separated metrics
dimensionsstringfiltersstringdim==value;dim2==a,b
sortstringmax_resultsinteger1–250
currencystringISO 4217 for revenue reports
source_typestringtraffic-source-detail: insightTrafficSourceType
report_type_idstringbulk: Reporting API report type
create_jobbooleanReturns object
reportstringread-onlylabelstringread-onlysincestringread-onlyuntilstringread-onlycolumnsarray of objectread-onlyShow 3 item attributes
namestringtypestringdata_typestring | nullrowsarray of array of anyread-onlyitemsarray of objectread-onlyResponses
Analytics groups
YouTube: List Analytics groups
/accounts/{accountId}/youtube/analytics-groupsGroups · quota: 1 analytics query (analytics.groups.list). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.
Try it with MCPAsk your agent to call youtube-analytics-groups-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
idstringread-onlytitlestringrequireditem_typestringrequiredyoutube#videoyoutube#playlistyoutube#channelyoutubePartner#asset
item_countinteger | nullread-onlypublished_atstring (date-time)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Analytics groups item
/accounts/{accountId}/youtube/analytics-groupsCreate group · quota: 1 analytics query (analytics.groups.insert). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.
Try it with MCPAsk your agent to call youtube-analytics-groups-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringrequireditem_typestringdefault: "youtube#video"youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset
Returns object
idstringread-onlytitlestringrequireditem_typestringrequiredyoutube#videoyoutube#playlistyoutube#channelyoutubePartner#asset
item_countinteger | nullread-onlypublished_atstring (date-time)read-onlyResponses
YouTube: Get a Analytics groups item
/accounts/{accountId}/youtube/analytics-groups/{itemId}Group · quota: 1 analytics query (analytics.groups.list). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.
Try it with MCPAsk your agent to call youtube-analytics-groups-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestringrequireditem_typestringrequiredyoutube#videoyoutube#playlistyoutube#channelyoutubePartner#asset
item_countinteger | nullread-onlypublished_atstring (date-time)read-onlyResponses
YouTube: Update a Analytics groups item
/accounts/{accountId}/youtube/analytics-groups/{itemId}Rename group · quota: 1 analytics query (analytics.groups.update). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.
Try it with MCPAsk your agent to call youtube-analytics-groups-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestringrequiredReturns object
idstringread-onlytitlestringrequireditem_typestringrequiredyoutube#videoyoutube#playlistyoutube#channelyoutubePartner#asset
item_countinteger | nullread-onlypublished_atstring (date-time)read-onlyResponses
YouTube: Delete a Analytics groups item
/accounts/{accountId}/youtube/analytics-groups/{itemId}Delete group · quota: 1 analytics query (analytics.groups.delete). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.
Try it with MCPAsk your agent to call youtube-analytics-groups-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Add item (Analytics groups)
/accounts/{accountId}/youtube/analytics-groups/{itemId}/add-itemAdd a video/playlist/channel · quota: 1 analytics query (analytics.groupItems.insert). Custom collections (≤500 videos/playlists/channels) usable as group== filter. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groups Generic route: /v1/accounts/{accountId}/focus/analytics-groups.
Try it with MCPAsk your agent to call youtube-analytics-groups-add-item (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
resource_idstringrequiredkindstringdefault: "youtube#video"youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Analytics group items
YouTube: List Group items
/accounts/{accountId}/youtube/analytics-group-itemsItems in a group · quota: 1 analytics query (analytics.groupItems.list). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groupItems Generic route: /v1/accounts/{accountId}/focus/analytics-group-items.
Try it with MCPAsk your agent to call youtube-analytics-group-items-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
group_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringread-onlygroup_idstringrequiredkindstringyoutube#videoyoutube#playlistyoutube#channelyoutubePartner#asset
resource_idstringrequiredlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Group items item
/accounts/{accountId}/youtube/analytics-group-itemsAdd item · quota: 1 analytics query (analytics.groupItems.insert). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groupItems Generic route: /v1/accounts/{accountId}/focus/analytics-group-items.
Try it with MCPAsk your agent to call youtube-analytics-group-items-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
group_idstringrequiredresource_idstringrequiredkindstringdefault: "youtube#video"youtube#videoyoutube#playlistyoutube#channelyoutubePartner#asset
Returns object
idstringread-onlygroup_idstringrequiredkindstringyoutube#videoyoutube#playlistyoutube#channelyoutubePartner#asset
resource_idstringrequiredResponses
YouTube: Delete a Group items item
/accounts/{accountId}/youtube/analytics-group-items/{itemId}Remove item · quota: 1 analytics query (analytics.groupItems.delete). Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/reference/groupItems Generic route: /v1/accounts/{accountId}/focus/analytics-group-items.
Try it with MCPAsk your agent to call youtube-analytics-group-items-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Report types
YouTube: List Bulk report types
/accounts/{accountId}/youtube/report-typesReporting API report types · quota: 1 reporting query (reporting.reportTypes.list). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/report-types.
Try it with MCPAsk your agent to call youtube-report-types-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
include_system_managedbooleancursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringread-onlynamestringread-onlysystem_managedbooleanread-onlydeprecate_timestring (date-time) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Reporting jobs
YouTube: List Bulk report jobs
/accounts/{accountId}/youtube/reporting-jobsJobs · quota: 1 reporting query (reporting.jobs.list). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-jobs.
Try it with MCPAsk your agent to call youtube-reporting-jobs-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
include_system_managedbooleancursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlyreport_type_idstringrequirednamestringcreate_timestring (date-time)read-onlyexpire_timestring (date-time) | nullread-onlysystem_managedbooleanread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Bulk report jobs item
/accounts/{accountId}/youtube/reporting-jobsCreate job · quota: 1 reporting query (reporting.jobs.create). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-jobs.
Try it with MCPAsk your agent to call youtube-reporting-jobs-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
report_type_idstringrequirede.g. channel_reach_basic_a1, channel_basic_a3
namestringReturns object
idstringread-onlyreport_type_idstringrequirednamestringcreate_timestring (date-time)read-onlyexpire_timestring (date-time) | nullread-onlysystem_managedbooleanread-onlyResponses
YouTube: Delete a Bulk report jobs item
/accounts/{accountId}/youtube/reporting-jobs/{itemId}Delete job · quota: 1 reporting query (reporting.jobs.delete). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-jobs.
Try it with MCPAsk your agent to call youtube-reporting-jobs-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: List reports (Bulk report jobs)
/accounts/{accountId}/youtube/reporting-jobs/{itemId}/reportsGenerated daily reports · quota: 1 reporting query (reporting.jobs.reports.list). One job per report type; daily CSVs arrive ~48 h after creation (30-day backfill, 60-day retention). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-jobs.
Try it with MCPAsk your agent to call youtube-reporting-jobs-reports (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Reporting reports
YouTube: List Bulk reports
/accounts/{accountId}/youtube/reporting-reportsReports of a job · quota: 1 reporting query (reporting.jobs.reports.list). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-reports.
Try it with MCPAsk your agent to call youtube-reporting-reports-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
job_idstringrequiredcreated_afterstring (date-time)sincestring (date)untilstring (date)cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlyjob_idstringread-onlystart_timestring (date-time)read-onlyend_timestring (date-time)read-onlycreate_timestring (date-time)read-onlydownload_urlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Download CSV (Bulk reports)
/accounts/{accountId}/youtube/reporting-reports/{itemId}/downloadDownload and parse the report · quota: 2 reporting queries (reporting.jobs.reports.get, reporting.media.download). Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/reporting/v1/reports Generic route: /v1/accounts/{accountId}/focus/reporting-reports.
Try it with MCPAsk your agent to call youtube-reporting-reports-download (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
job_idstringrequiredparsebooleandefault: trueReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Comments
YouTube: List Comments
/accounts/{accountId}/youtube/commentsComment threads (5 replies inline; channel-wide by default) · quota: 1 unit (commentThreads.list). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call youtube-comments-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
cursorstringvideo_idstringmoderation_statusstringdefault: "published"publishedheldForReviewlikelySpam
orderstringdefault: "time"timerelevance
search_termsstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 20 item attributes
idstringread-onlytextstringrequired≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstring | nullread-onlyis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlyrepliesarray of objectread-onlyShow 19 item attributes
idstringread-onlytextstring≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstring | nullread-onlyis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Comments item
/accounts/{accountId}/youtube/commentsPost a top-level comment on a video · quota: 50 units (commentThreads.insert). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call youtube-comments-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
video_idstringrequiredtextstringrequired≤ 10000 characters
Returns object
idstringread-onlytextstringrequired≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstring | nullread-onlyis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlyrepliesarray of objectread-onlyShow 19 item attributes
idstringread-onlytextstring≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstring | nullread-onlyis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlyResponses
YouTube: Get a Comments item
/accounts/{accountId}/youtube/comments/{itemId}A comment · quota: 1 unit (comments.list). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call youtube-comments-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytextstringrequired≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstring | nullread-onlyis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlyrepliesarray of objectread-onlyShow 19 item attributes
idstringread-onlytextstring≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstring | nullread-onlyis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlyResponses
YouTube: Update a Comments item
/accounts/{accountId}/youtube/comments/{itemId}Edit own comment · quota: 50 units (comments.update). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call youtube-comments-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
textstringrequired≤ 10000 characters
Returns object
idstringread-onlytextstringrequired≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstring | nullread-onlyis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlyrepliesarray of objectread-onlyShow 19 item attributes
idstringread-onlytextstring≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstring | nullread-onlyis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlyResponses
YouTube: Delete a Comments item
/accounts/{accountId}/youtube/comments/{itemId}Delete own comment (use reject for others) · quota: 50 units (comments.delete). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call youtube-comments-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Reply (Comments)
/accounts/{accountId}/youtube/comments/{itemId}/replyReply as the channel · quota: 50 units (comments.insert). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call youtube-comments-reply (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 10000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Approve (Comments)
/accounts/{accountId}/youtube/comments/{itemId}/approvePublish a held / likely-spam comment · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call youtube-comments-approve (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Hold for review (Comments)
/accounts/{accountId}/youtube/comments/{itemId}/holdMove to the held-for-review queue · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call youtube-comments-hold (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Hide (reject) (Comments)
/accounts/{accountId}/youtube/comments/{itemId}/rejectReject = hide from the channel; cannot be republished. Optionally ban the author. · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call youtube-comments-reject (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
ban_authorbooleandefault: falseReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Hide & ban author (Comments)
/accounts/{accountId}/youtube/comments/{itemId}/ban-authorReject and ban the author from commenting on the channel · quota: 50 units (comments.setModerationStatus). All comment threads on the channel’s videos (or one video). Reply, edit/delete own, approve/hold/reject, ban authors. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/commentThreads Generic route: /v1/accounts/{accountId}/focus/comments.
Try it with MCPAsk your agent to call youtube-comments-ban-author (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Comment replies
YouTube: List Replies
/accounts/{accountId}/youtube/comment-repliesReplies to a comment · quota: 1 unit (comments.list). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.
Try it with MCPAsk your agent to call youtube-comment-replies-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
cursorstringparent_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 19 item attributes
idstringread-onlytextstringrequired≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstringrequiredis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Replies item
/accounts/{accountId}/youtube/comment-repliesReply · quota: 50 units (comments.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.
Try it with MCPAsk your agent to call youtube-comment-replies-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
parent_idstringrequiredtextstringrequired≤ 10000 characters
Returns object
idstringread-onlytextstringrequired≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstringrequiredis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlyResponses
YouTube: Update a Replies item
/accounts/{accountId}/youtube/comment-replies/{itemId}Edit own comment · quota: 50 units (comments.update). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.
Try it with MCPAsk your agent to call youtube-comment-replies-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
textstringrequired≤ 10000 characters
Returns object
idstringread-onlytextstringrequired≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstringrequiredis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlyResponses
YouTube: Delete a Replies item
/accounts/{accountId}/youtube/comment-replies/{itemId}Delete own comment (use reject for others) · quota: 50 units (comments.delete). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.
Try it with MCPAsk your agent to call youtube-comment-replies-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Approve (Replies)
/accounts/{accountId}/youtube/comment-replies/{itemId}/approvePublish a held / likely-spam comment · quota: 50 units (comments.setModerationStatus). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.
Try it with MCPAsk your agent to call youtube-comment-replies-approve (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Hold for review (Replies)
/accounts/{accountId}/youtube/comment-replies/{itemId}/holdMove to the held-for-review queue · quota: 50 units (comments.setModerationStatus). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.
Try it with MCPAsk your agent to call youtube-comment-replies-hold (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Hide (reject) (Replies)
/accounts/{accountId}/youtube/comment-replies/{itemId}/rejectReject = hide from the channel; cannot be republished. Optionally ban the author. · quota: 50 units (comments.setModerationStatus). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.
Try it with MCPAsk your agent to call youtube-comment-replies-reject (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
ban_authorbooleandefault: falseReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Hide & ban author (Replies)
/accounts/{accountId}/youtube/comment-replies/{itemId}/ban-authorReject and ban the author from commenting on the channel · quota: 50 units (comments.setModerationStatus). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments Generic route: /v1/accounts/{accountId}/focus/comment-replies.
Try it with MCPAsk your agent to call youtube-comment-replies-ban-author (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Held for review
YouTube: List Held for review
/accounts/{accountId}/youtube/held-for-reviewModeration queue · quota: 1 unit (commentThreads.list). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.
Try it with MCPAsk your agent to call youtube-held-for-review-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–100
cursorstringqueuestringdefault: "heldForReview"heldForReviewlikelySpam
video_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 20 item attributes
idstringread-onlytextstringrequired≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstring | nullread-onlyis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlyrepliesarray of objectread-onlyShow 19 item attributes
idstringread-onlytextstring≤ 10000 characters
text_htmlstring | nullread-onlyauthorstringread-onlyauthor_idstring | nullread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_urlstring (uri) | nullread-onlycreated_atstring (date-time)read-onlyupdated_atstring (date-time) | nullread-onlylike_countintegerread-onlypost_idstring | nullread-onlyVideo id
thread_idstring | nullread-onlyparent_idstring | nullread-onlyis_replybooleanread-onlyreply_countintegerread-onlycan_replyboolean | nullread-onlymoderation_statusstringread-onlypublishedheldForReviewlikelySpamrejected
image_urlstring (uri) | nullread-onlyis_ownbooleanread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Reply (Held for review)
/accounts/{accountId}/youtube/held-for-review/{itemId}/replyReply as the channel · quota: 50 units (comments.insert). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.
Try it with MCPAsk your agent to call youtube-held-for-review-reply (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired≤ 10000 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Approve (Held for review)
/accounts/{accountId}/youtube/held-for-review/{itemId}/approvePublish a held / likely-spam comment · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.
Try it with MCPAsk your agent to call youtube-held-for-review-approve (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Hold for review (Held for review)
/accounts/{accountId}/youtube/held-for-review/{itemId}/holdMove to the held-for-review queue · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.
Try it with MCPAsk your agent to call youtube-held-for-review-hold (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Hide (reject) (Held for review)
/accounts/{accountId}/youtube/held-for-review/{itemId}/rejectReject = hide from the channel; cannot be republished. Optionally ban the author. · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.
Try it with MCPAsk your agent to call youtube-held-for-review-reject (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
ban_authorbooleandefault: falseReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Hide & ban author (Held for review)
/accounts/{accountId}/youtube/held-for-review/{itemId}/ban-authorReject and ban the author from commenting on the channel · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.
Try it with MCPAsk your agent to call youtube-held-for-review-ban-author (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Bulk moderate (Held for review)
/accounts/{accountId}/youtube/held-for-review/bulk-moderateApprove/hold/reject up to 50 comments per call · quota: 50 units (comments.setModerationStatus). Moderation queue: heldForReview and likelySpam threads (labelled per RMF). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/comments/setModerationStatus Generic route: /v1/accounts/{accountId}/focus/held-for-review.
Try it with MCPAsk your agent to call youtube-held-for-review-bulk-moderate (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
idsarray of stringrequired≥ 1 items
moderation_statusstringrequiredpublishedheldForReviewrejected
ban_authorbooleandefault: falseReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Live broadcasts
YouTube: List Live broadcasts
/accounts/{accountId}/youtube/live-broadcastsBroadcasts · quota: 1 unit (liveBroadcasts.list). Schedule, bind to a stream, test → go live → end, insert ad breaks. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringstatusstringallactivecompletedupcoming
typestringdefault: "all"alleventpersistent
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 26 item attributes
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤ 5000 characters
scheduled_start_timestring (date-time)requiredscheduled_end_timestring (date-time) | nullactual_start_timestring (date-time) | nullread-onlyactual_end_timestring (date-time) | nullread-onlyprivacy_statusstringpublicunlistedprivate
self_declared_made_for_kidsbooleanlife_cycle_statusstringread-onlycompletecreatedliveliveStartingreadyrevokedtestStartingtesting
recording_statusstring | nullread-onlybound_stream_idstring | nullread-onlylive_chat_idstring | nullread-onlyenable_auto_startbooleanenable_auto_stopbooleanenable_dvrbooleanenable_embedbooleanrecord_from_startbooleanenable_closed_captionsbooleanclosed_captions_typestringclosedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded
latency_preferencestringnormallowultraLow
projectionstringrectangular360
enable_monitor_streambooleanbroadcast_stream_delay_msintegerthumbnail_urlstring (uri) | nullread-onlyurlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Live broadcasts item
/accounts/{accountId}/youtube/live-broadcastsCreate / schedule · quota: 1 unit (liveBroadcasts.insert). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringrequired≤ 100 characters
descriptionstring≤ 5000 characters
scheduled_start_timestring (date-time)requiredscheduled_end_timestring (date-time) | nullprivacy_statusstringpublicunlistedprivate
self_declared_made_for_kidsbooleanenable_auto_startbooleanenable_auto_stopbooleanenable_dvrbooleanenable_embedbooleanrecord_from_startbooleanenable_closed_captionsbooleanclosed_captions_typestringclosedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded
latency_preferencestringnormallowultraLow
projectionstringrectangular360
enable_monitor_streambooleanbroadcast_stream_delay_msintegerReturns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤ 5000 characters
scheduled_start_timestring (date-time)requiredscheduled_end_timestring (date-time) | nullactual_start_timestring (date-time) | nullread-onlyactual_end_timestring (date-time) | nullread-onlyprivacy_statusstringpublicunlistedprivate
self_declared_made_for_kidsbooleanlife_cycle_statusstringread-onlycompletecreatedliveliveStartingreadyrevokedtestStartingtesting
recording_statusstring | nullread-onlybound_stream_idstring | nullread-onlylive_chat_idstring | nullread-onlyenable_auto_startbooleanenable_auto_stopbooleanenable_dvrbooleanenable_embedbooleanrecord_from_startbooleanenable_closed_captionsbooleanclosed_captions_typestringclosedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded
latency_preferencestringnormallowultraLow
projectionstringrectangular360
enable_monitor_streambooleanbroadcast_stream_delay_msintegerthumbnail_urlstring (uri) | nullread-onlyurlstring (uri)read-onlyResponses
YouTube: Get a Live broadcasts item
/accounts/{accountId}/youtube/live-broadcasts/{itemId}Broadcast · quota: 1 unit (liveBroadcasts.list). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤ 5000 characters
scheduled_start_timestring (date-time)requiredscheduled_end_timestring (date-time) | nullactual_start_timestring (date-time) | nullread-onlyactual_end_timestring (date-time) | nullread-onlyprivacy_statusstringpublicunlistedprivate
self_declared_made_for_kidsbooleanlife_cycle_statusstringread-onlycompletecreatedliveliveStartingreadyrevokedtestStartingtesting
recording_statusstring | nullread-onlybound_stream_idstring | nullread-onlylive_chat_idstring | nullread-onlyenable_auto_startbooleanenable_auto_stopbooleanenable_dvrbooleanenable_embedbooleanrecord_from_startbooleanenable_closed_captionsbooleanclosed_captions_typestringclosedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded
latency_preferencestringnormallowultraLow
projectionstringrectangular360
enable_monitor_streambooleanbroadcast_stream_delay_msintegerthumbnail_urlstring (uri) | nullread-onlyurlstring (uri)read-onlyResponses
YouTube: Update a Live broadcasts item
/accounts/{accountId}/youtube/live-broadcasts/{itemId}Edit · quota: 2 units (liveBroadcasts.list, liveBroadcasts.update). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestring≤ 100 characters
descriptionstring≤ 5000 characters
scheduled_start_timestring (date-time)scheduled_end_timestring (date-time) | nullprivacy_statusstringpublicunlistedprivate
self_declared_made_for_kidsbooleanenable_auto_startbooleanenable_auto_stopbooleanenable_dvrbooleanenable_embedbooleanrecord_from_startbooleanenable_closed_captionsbooleanclosed_captions_typestringclosedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded
latency_preferencestringnormallowultraLow
projectionstringrectangular360
enable_monitor_streambooleanbroadcast_stream_delay_msintegerReturns object
idstringread-onlytitlestringrequired≤ 100 characters
descriptionstring≤ 5000 characters
scheduled_start_timestring (date-time)requiredscheduled_end_timestring (date-time) | nullactual_start_timestring (date-time) | nullread-onlyactual_end_timestring (date-time) | nullread-onlyprivacy_statusstringpublicunlistedprivate
self_declared_made_for_kidsbooleanlife_cycle_statusstringread-onlycompletecreatedliveliveStartingreadyrevokedtestStartingtesting
recording_statusstring | nullread-onlybound_stream_idstring | nullread-onlylive_chat_idstring | nullread-onlyenable_auto_startbooleanenable_auto_stopbooleanenable_dvrbooleanenable_embedbooleanrecord_from_startbooleanenable_closed_captionsbooleanclosed_captions_typestringclosedCaptionsDisabledclosedCaptionsHttpPostclosedCaptionsEmbedded
latency_preferencestringnormallowultraLow
projectionstringrectangular360
enable_monitor_streambooleanbroadcast_stream_delay_msintegerthumbnail_urlstring (uri) | nullread-onlyurlstring (uri)read-onlyResponses
YouTube: Delete a Live broadcasts item
/accounts/{accountId}/youtube/live-broadcasts/{itemId}Delete · quota: 1 unit (liveBroadcasts.delete). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Bind stream (Live broadcasts)
/accounts/{accountId}/youtube/live-broadcasts/{itemId}/bindAttach an ingestion stream · quota: 1 unit (liveBroadcasts.bind). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-bind (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
stream_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Unbind stream (Live broadcasts)
/accounts/{accountId}/youtube/live-broadcasts/{itemId}/unbindDetach the stream · quota: 1 unit (liveBroadcasts.bind). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-unbind (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Start test (Live broadcasts)
/accounts/{accountId}/youtube/live-broadcasts/{itemId}/testTransition to testing (monitor stream must be enabled) · quota: 1 unit (liveBroadcasts.transition). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-test (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Go live (Live broadcasts)
/accounts/{accountId}/youtube/live-broadcasts/{itemId}/go-liveTransition to live · quota: 1 unit (liveBroadcasts.transition). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-go-live (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: End broadcast (Live broadcasts)
/accounts/{accountId}/youtube/live-broadcasts/{itemId}/endTransition to complete · quota: 1 unit (liveBroadcasts.transition). Schedule, bind to a stream, test → go live → end, insert ad breaks. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-end (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Insert ad break (Live broadcasts)
/accounts/{accountId}/youtube/live-broadcasts/{itemId}/insert-cuepointCuepoint (monetised live streams) · quota: 1 unit (liveBroadcasts.cuepoint). Schedule, bind to a stream, test → go live → end, insert ad breaks. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveBroadcasts Generic route: /v1/accounts/{accountId}/focus/live-broadcasts.
Try it with MCPAsk your agent to call youtube-live-broadcasts-insert-cuepoint (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
duration_secsintegerdefault: 30≥ 1
insertion_offset_time_msintegerwalltime_msintegerReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Live streams
YouTube: List Streams (ingest)
/accounts/{accountId}/youtube/live-streamsStreams · quota: 1 unit (liveStreams.list). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: /v1/accounts/{accountId}/focus/live-streams.
Try it with MCPAsk your agent to call youtube-live-streams-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 14 item attributes
idstringread-onlytitlestringrequired≤ 128 characters
descriptionstring≤ 10000 characters
ingestion_typestringrtmpdashwebrtchls
resolutionstringvariable240p360p480p720p1080p1440p2160p
frame_ratestringvariable30fps60fps
is_reusablebooleandefault: truestream_namestring | nullread-onlyStream key — keep secret
ingestion_addressstring (uri) | nullread-onlybackup_ingestion_addressstring (uri) | nullread-onlyrtmps_ingestion_addressstring (uri) | nullread-onlystream_statusstring | nullread-onlyhealth_statusstring | nullread-onlyhealth_issuesarray of objectread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Streams (ingest) item
/accounts/{accountId}/youtube/live-streamsCreate stream · quota: 1 unit (liveStreams.insert). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: /v1/accounts/{accountId}/focus/live-streams.
Try it with MCPAsk your agent to call youtube-live-streams-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
titlestringrequireddescriptionstringingestion_typestringrtmpdashwebrtchls
resolutionstringvariable240p360p480p720p1080p1440p2160p
frame_ratestringvariable30fps60fps
is_reusablebooleanReturns object
idstringread-onlytitlestringrequired≤ 128 characters
descriptionstring≤ 10000 characters
ingestion_typestringrtmpdashwebrtchls
resolutionstringvariable240p360p480p720p1080p1440p2160p
frame_ratestringvariable30fps60fps
is_reusablebooleandefault: truestream_namestring | nullread-onlyStream key — keep secret
ingestion_addressstring (uri) | nullread-onlybackup_ingestion_addressstring (uri) | nullread-onlyrtmps_ingestion_addressstring (uri) | nullread-onlystream_statusstring | nullread-onlyhealth_statusstring | nullread-onlyhealth_issuesarray of objectread-onlyResponses
YouTube: Get a Streams (ingest) item
/accounts/{accountId}/youtube/live-streams/{itemId}Stream · quota: 1 unit (liveStreams.list). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: /v1/accounts/{accountId}/focus/live-streams.
Try it with MCPAsk your agent to call youtube-live-streams-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlytitlestringrequired≤ 128 characters
descriptionstring≤ 10000 characters
ingestion_typestringrtmpdashwebrtchls
resolutionstringvariable240p360p480p720p1080p1440p2160p
frame_ratestringvariable30fps60fps
is_reusablebooleandefault: truestream_namestring | nullread-onlyStream key — keep secret
ingestion_addressstring (uri) | nullread-onlybackup_ingestion_addressstring (uri) | nullread-onlyrtmps_ingestion_addressstring (uri) | nullread-onlystream_statusstring | nullread-onlyhealth_statusstring | nullread-onlyhealth_issuesarray of objectread-onlyResponses
YouTube: Update a Streams (ingest) item
/accounts/{accountId}/youtube/live-streams/{itemId}Edit stream · quota: 2 units (liveStreams.list, liveStreams.update). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: /v1/accounts/{accountId}/focus/live-streams.
Try it with MCPAsk your agent to call youtube-live-streams-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestringdescriptionstringresolutionstringvariable240p360p480p720p1080p1440p2160p
frame_ratestringvariable30fps60fps
is_reusablebooleanReturns object
idstringread-onlytitlestringrequired≤ 128 characters
descriptionstring≤ 10000 characters
ingestion_typestringrtmpdashwebrtchls
resolutionstringvariable240p360p480p720p1080p1440p2160p
frame_ratestringvariable30fps60fps
is_reusablebooleandefault: truestream_namestring | nullread-onlyStream key — keep secret
ingestion_addressstring (uri) | nullread-onlybackup_ingestion_addressstring (uri) | nullread-onlyrtmps_ingestion_addressstring (uri) | nullread-onlystream_statusstring | nullread-onlyhealth_statusstring | nullread-onlyhealth_issuesarray of objectread-onlyResponses
YouTube: Delete a Streams (ingest) item
/accounts/{accountId}/youtube/live-streams/{itemId}Delete stream · quota: 1 unit (liveStreams.delete). RTMP/HLS/DASH/WebRTC ingestion points with stream keys and health. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveStreams Generic route: /v1/accounts/{accountId}/focus/live-streams.
Try it with MCPAsk your agent to call youtube-live-streams-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Live chat
YouTube: List Live chat
/accounts/{accountId}/youtube/live-chatChat messages (active broadcast by default) · quota: 5 units (liveChatMessages.list). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.
Try it with MCPAsk your agent to call youtube-live-chat-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
broadcast_idstringlive_chat_idstringcursorstringlimitintegerdefault: 500200–2000
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 12 item attributes
idstringread-onlytypestringread-onlytextstringrequired≤ 200 characters
published_atstring (date-time)read-onlyauthorstringread-onlyauthor_channel_idstringread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_is_ownerboolean | nullread-onlyauthor_is_moderatorboolean | nullread-onlyauthor_is_sponsorboolean | nullread-onlysuper_chatobject | nullread-onlyShow 5 child attributes
amount_microsintegercurrencystringdisplaystringcommentstring | nulltierinteger | nullpollobject | nullread-onlyShow 3 child attributes
questionstringstatusstringoptionsarray of objectShow 2 item attributes
textstringtallyinteger | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Live chat item
/accounts/{accountId}/youtube/live-chatSend message as the channel · quota: 20 units (liveChatMessages.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.
Try it with MCPAsk your agent to call youtube-live-chat-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
broadcast_idstringlive_chat_idstringtextstringrequired≤ 200 characters
Returns object
idstringread-onlytypestringread-onlytextstringrequired≤ 200 characters
published_atstring (date-time)read-onlyauthorstringread-onlyauthor_channel_idstringread-onlyauthor_avatar_urlstring (uri) | nullread-onlyauthor_is_ownerboolean | nullread-onlyauthor_is_moderatorboolean | nullread-onlyauthor_is_sponsorboolean | nullread-onlysuper_chatobject | nullread-onlyShow 5 child attributes
amount_microsintegercurrencystringdisplaystringcommentstring | nulltierinteger | nullpollobject | nullread-onlyShow 3 child attributes
questionstringstatusstringoptionsarray of objectShow 2 item attributes
textstringtallyinteger | nullResponses
YouTube: Delete a Live chat item
/accounts/{accountId}/youtube/live-chat/{itemId}Delete message · quota: 20 units (liveChatMessages.delete). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.
Try it with MCPAsk your agent to call youtube-live-chat-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
YouTube: Start poll (Live chat)
/accounts/{accountId}/youtube/live-chat/create-pollPost a poll in chat · quota: 20 units (liveChatMessages.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.
Try it with MCPAsk your agent to call youtube-live-chat-create-poll (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
broadcast_idstringlive_chat_idstringquestionstringrequired≤ 100 characters
optionsarray of stringrequired2–4 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Close poll (Live chat)
/accounts/{accountId}/youtube/live-chat/{itemId}/close-pollEnd an active poll · quota: 20 units (liveChatMessages.transition). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.
Try it with MCPAsk your agent to call youtube-live-chat-close-poll (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Ban / timeout author (Live chat)
/accounts/{accountId}/youtube/live-chat/{itemId}/ban-authorBan permanently or for N seconds · quota: 200 units (liveChatBans.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.
Try it with MCPAsk your agent to call youtube-live-chat-ban-author (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
broadcast_idstringlive_chat_idstringauthor_channel_idstringrequiredtypestringdefault: "permanent"permanenttemporary
ban_duration_secondsinteger≥ 1
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Make moderator (Live chat)
/accounts/{accountId}/youtube/live-chat/{itemId}/make-moderatorPromote the author to chat moderator · quota: 200 units (liveChatModerators.insert). Read (honour polling_interval_ms), send, delete, polls; moderate authors. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatMessages Generic route: /v1/accounts/{accountId}/focus/live-chat.
Try it with MCPAsk your agent to call youtube-live-chat-make-moderator (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
broadcast_idstringlive_chat_idstringauthor_channel_idstringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Live chat moderators
YouTube: List Chat moderators
/accounts/{accountId}/youtube/live-chat-moderatorsModerators · quota: 50 units (liveChatModerators.list). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatModerators Generic route: /v1/accounts/{accountId}/focus/live-chat-moderators.
Try it with MCPAsk your agent to call youtube-live-chat-moderators-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringbroadcast_idstringlive_chat_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlychannel_idstringrequireddisplay_namestring | nullread-onlychannel_urlstring (uri) | nullread-onlyprofile_image_urlstring (uri) | nullread-onlylive_chat_idstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Chat moderators item
/accounts/{accountId}/youtube/live-chat-moderatorsAdd moderator · quota: 200 units (liveChatModerators.insert). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatModerators Generic route: /v1/accounts/{accountId}/focus/live-chat-moderators.
Try it with MCPAsk your agent to call youtube-live-chat-moderators-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
broadcast_idstringlive_chat_idstringchannel_idstringrequiredReturns object
idstringread-onlychannel_idstringrequireddisplay_namestring | nullread-onlychannel_urlstring (uri) | nullread-onlyprofile_image_urlstring (uri) | nullread-onlylive_chat_idstringread-onlyResponses
YouTube: Delete a Chat moderators item
/accounts/{accountId}/youtube/live-chat-moderators/{itemId}Remove moderator · quota: 200 units (liveChatModerators.delete). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatModerators Generic route: /v1/accounts/{accountId}/focus/live-chat-moderators.
Try it with MCPAsk your agent to call youtube-live-chat-moderators-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Live chat bans
YouTube: Create a Chat bans item
/accounts/{accountId}/youtube/live-chat-bansBan / timeout · quota: 200 units (liveChatBans.insert). Ban or time out users. The API has no list endpoint — keep the returned ban id to lift it. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatBans Generic route: /v1/accounts/{accountId}/focus/live-chat-bans.
Try it with MCPAsk your agent to call youtube-live-chat-bans-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
broadcast_idstringlive_chat_idstringchannel_idstringrequiredtypestringdefault: "permanent"permanenttemporary
ban_duration_secondsinteger≥ 1
Returns object
idstringread-onlychannel_idstringrequireddisplay_namestring | nullread-onlytypestringrequiredpermanenttemporary
ban_duration_secondsinteger | null≥ 1
live_chat_idstringread-onlyResponses
YouTube: Delete a Chat bans item
/accounts/{accountId}/youtube/live-chat-bans/{itemId}Lift ban · quota: 200 units (liveChatBans.delete). Ban or time out users. The API has no list endpoint — keep the returned ban id to lift it. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/live/docs/liveChatBans Generic route: /v1/accounts/{accountId}/focus/live-chat-bans.
Try it with MCPAsk your agent to call youtube-live-chat-bans-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Super chats
YouTube: List Super Chats
/accounts/{accountId}/youtube/super-chatsSuper Chat events · quota: 1 unit (superChatEvents.list). Super Chat & Super Sticker purchases from the last 30 days. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/superChatEvents Generic route: /v1/accounts/{accountId}/focus/super-chats.
Try it with MCPAsk your agent to call youtube-super-chats-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringhlstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
idstringread-onlysupporter_namestringread-onlysupporter_channel_idstringread-onlysupporter_avatar_urlstring (uri) | nullread-onlycommentstring | nullread-onlycreated_atstring (date-time)read-onlyamount_microsintegerread-onlycurrencystringread-onlydisplay_amountstringread-onlymessage_typeinteger | nullread-onlyis_super_stickerbooleanread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Revenue
YouTube: Get Revenue
/accounts/{accountId}/youtube/revenueRevenue dashboard · quota: 6 analytics queries (analytics.reports.query). YPP channels: estimated revenue, ad revenue, Premium revenue, CPM, RPM-like playback CPM, ad impressions, by day/video/country/ad type/content type. Requires scopes: https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Network docs: https://developers.google.com/youtube/analytics/metrics#Revenue-Metrics Generic route: /v1/accounts/{accountId}/focus/revenue.
Try it with MCPAsk your agent to call youtube-revenue-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
currencystringdefault: "USD"Returns object
sincestring (date)read-onlyuntilstring (date)read-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Members
YouTube: List Members
/accounts/{accountId}/youtube/membersMembers · quota: 2 units (members.list). Channel members with level and tenure; mode=updates streams new/upgraded members. Access is allowlisted by YouTube. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.channel-memberships.creator. Network docs: https://developers.google.com/youtube/v3/docs/members Generic route: /v1/accounts/{accountId}/focus/members.
Try it with MCPAsk your agent to call youtube-members-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–1000
cursorstringmodestringdefault: "all_current"all_currentupdates
level_idstringchannel_idsstringComma-separated, ≤100
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
channel_idstringread-onlydisplay_namestringread-onlychannel_urlstring (uri)read-onlyprofile_image_urlstring (uri) | nullread-onlyhighest_level_idstring | nullread-onlyhighest_level_namestring | nullread-onlyaccessible_levelsarray of stringread-onlymember_sincestring (date-time) | nullread-onlytotal_monthsinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Membership levels
YouTube: List Membership levels
/accounts/{accountId}/youtube/membership-levelsLevels · quota: 1 unit (membershipsLevels.list). Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtube.channel-memberships.creator. Network docs: https://developers.google.com/youtube/v3/docs/membershipsLevels Generic route: /v1/accounts/{accountId}/focus/membership-levels.
Try it with MCPAsk your agent to call youtube-membership-levels-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringread-onlydisplay_namestringread-onlycreator_channel_idstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Membership analytics
YouTube: Get Membership churn
/accounts/{accountId}/youtube/membership-analyticsMembership churn: cancellations · quota: 1 analytics query (analytics.reports.query). Cancellation survey reasons. Requires scopes: https://www.googleapis.com/auth/youtube.readonly. Requires one of: https://www.googleapis.com/auth/yt-analytics.readonly | https://www.googleapis.com/auth/yt-analytics-monetary.readonly. Generic route: /v1/accounts/{accountId}/focus/membership-analytics.
Try it with MCPAsk your agent to call youtube-membership-analytics-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)YYYY-MM-DD (default: 28 days ago)
untilstring (date)YYYY-MM-DD (default: today)
Returns object
sincestring (date)read-onlyuntilstring (date)read-onlysectionsobjectread-onlyerrorsobjectread-onlyResponses
Channel
YouTube: Get Basic info
/accounts/{accountId}/youtube/channelChannel · quota: 1 unit (channels.list). Description, keywords, country, default language, trailer, made-for-kids. Title/handle/avatar are Studio-only. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/update Generic route: /v1/accounts/{accountId}/focus/channel.
Try it with MCPAsk your agent to call youtube-channel-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringread-onlytitlestringread-onlyNot editable via the API
handlestring | nullread-onlycustom_urlstring | nullread-onlydescriptionstring≤ 1000 characters
keywordsarray of stringChannel tags
countrystring | nullISO 3166-1 alpha-2
default_languagestring | nullunsubscribed_trailerstring | nullVideo id shown to non-subscribers (public/unlisted, owned)
tracking_analytics_account_idstring | nullGoogle Analytics property id
self_declared_made_for_kidsboolean | nullChannel-level made for kids
made_for_kidsboolean | nullread-onlythumbnail_urlstring (uri) | nullread-onlybanner_urlstring (uri) | nullread-onlysubscriber_countinteger | nullread-onlyhidden_subscriber_countboolean | nullread-onlyvideo_countinteger | nullread-onlyview_countinteger | nullread-onlyuploads_playlist_idstring | nullread-onlyprivacy_statusstring | nullread-onlylong_uploads_statusstring | nullread-onlypublished_atstring (date-time)read-onlytopic_categoriesarray of string (uri)read-onlyurlstring (uri)read-onlyResponses
YouTube: Update Basic info
/accounts/{accountId}/youtube/channelUpdate branding (+ status when made-for-kids changes) · quota: 51 units (channels.list, channels.update). Description, keywords, country, default language, trailer, made-for-kids. Title/handle/avatar are Studio-only. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/update Generic route: /v1/accounts/{accountId}/focus/channel.
Try it with MCPAsk your agent to call youtube-channel-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
descriptionstring≤ 1000 characters
keywordsarray of stringChannel tags
countrystringdefault_languagestringunsubscribed_trailerstringtracking_analytics_account_idstringself_declared_made_for_kidsbooleanReturns object
idstringread-onlytitlestringread-onlyNot editable via the API
handlestring | nullread-onlycustom_urlstring | nullread-onlydescriptionstring≤ 1000 characters
keywordsarray of stringChannel tags
countrystring | nullISO 3166-1 alpha-2
default_languagestring | nullunsubscribed_trailerstring | nullVideo id shown to non-subscribers (public/unlisted, owned)
tracking_analytics_account_idstring | nullGoogle Analytics property id
self_declared_made_for_kidsboolean | nullChannel-level made for kids
made_for_kidsboolean | nullread-onlythumbnail_urlstring (uri) | nullread-onlybanner_urlstring (uri) | nullread-onlysubscriber_countinteger | nullread-onlyhidden_subscriber_countboolean | nullread-onlyvideo_countinteger | nullread-onlyview_countinteger | nullread-onlyuploads_playlist_idstring | nullread-onlyprivacy_statusstring | nullread-onlylong_uploads_statusstring | nullread-onlypublished_atstring (date-time)read-onlytopic_categoriesarray of string (uri)read-onlyurlstring (uri)read-onlyResponses
Channel localizations
YouTube: List Channel translations
/accounts/{accountId}/youtube/channel-localizationsTranslations · quota: 1 unit (channels.list). Channel title/description per language (requires a default language). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: /v1/accounts/{accountId}/focus/channel-localizations.
Try it with MCPAsk your agent to call youtube-channel-localizations-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
languagestringrequiredtitlestringrequireddescriptionstring≤ 1000 characters
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Channel translations item
/accounts/{accountId}/youtube/channel-localizationsAdd translation · quota: 52 units (channels.list, channels.update). Channel title/description per language (requires a default language). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: /v1/accounts/{accountId}/focus/channel-localizations.
Try it with MCPAsk your agent to call youtube-channel-localizations-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
languagestringrequiredtitlestringrequireddescriptionstringReturns object
languagestringrequiredtitlestringrequireddescriptionstring≤ 1000 characters
Responses
YouTube: Update a Channel translations item
/accounts/{accountId}/youtube/channel-localizations/{itemId}Edit translation · quota: 52 units (channels.list, channels.update). Channel title/description per language (requires a default language). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: /v1/accounts/{accountId}/focus/channel-localizations.
Try it with MCPAsk your agent to call youtube-channel-localizations-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestringdescriptionstringReturns object
languagestringrequiredtitlestringrequireddescriptionstring≤ 1000 characters
Responses
YouTube: Delete a Channel translations item
/accounts/{accountId}/youtube/channel-localizations/{itemId}Remove translation · quota: 52 units (channels.list, channels.update). Channel title/description per language (requires a default language). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels#localizations Generic route: /v1/accounts/{accountId}/focus/channel-localizations.
Try it with MCPAsk your agent to call youtube-channel-localizations-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Channel banner
YouTube: Get Banner
/accounts/{accountId}/youtube/channel-bannerCurrent banner · quota: 1 unit (channels.list). 16:9, ≥2048×1152 (2560×1440 recommended), ≤6 MB JPEG/PNG. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelBanners/insert Generic route: /v1/accounts/{accountId}/focus/channel-banner.
Try it with MCPAsk your agent to call youtube-channel-banner-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
banner_urlstring (uri) | nullResponses
YouTube: Update Banner
/accounts/{accountId}/youtube/channel-bannerUpload and apply banner · quota: 101 units (channelBanners.insert, channels.list, channels.update). 16:9, ≥2048×1152 (2560×1440 recommended), ≤6 MB JPEG/PNG. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelBanners/insert Generic route: /v1/accounts/{accountId}/focus/channel-banner.
Try it with MCPAsk your agent to call youtube-channel-banner-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
mediastringrequiredapplybooleandefault: trueReturns object
banner_urlstring (uri) | nullResponses
Watermark
YouTube: Get Video watermark
/accounts/{accountId}/youtube/watermarkWatermark settings form (not readable via API) · quota: none (no API call). Branding watermark shown on all videos (the API cannot read the current one). Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/watermarks Generic route: /v1/accounts/{accountId}/focus/watermark.
Try it with MCPAsk your agent to call youtube-watermark-get (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
mediastringJPEG/PNG ≤10 MB, square (~150×150)
timing_typestringdefault: "offsetFromStart"offsetFromStartoffsetFromEnd
offset_msintegerdefault: 0duration_msinteger | nullcorner_positionstringdefault: "bottomRight"topLefttopRightbottomLeftbottomRight
Responses
YouTube: Set watermark (Video watermark)
/accounts/{accountId}/youtube/watermark/setUpload and apply · quota: 50 units (watermarks.set). Branding watermark shown on all videos (the API cannot read the current one). Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/watermarks Generic route: /v1/accounts/{accountId}/focus/watermark.
Try it with MCPAsk your agent to call youtube-watermark-set (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
mediastringrequiredtiming_typestringoffsetFromStartoffsetFromEnd
offset_msintegerduration_msintegercorner_positionstringtopLefttopRightbottomLeftbottomRight
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
YouTube: Remove watermark (Video watermark)
/accounts/{accountId}/youtube/watermark/unsetUnset · quota: 50 units (watermarks.unset). Branding watermark shown on all videos (the API cannot read the current one). Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/watermarks Generic route: /v1/accounts/{accountId}/focus/watermark.
Try it with MCPAsk your agent to call youtube-watermark-unset (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Channel sections
YouTube: List Home tab sections
/accounts/{accountId}/youtube/channel-sectionsSections · quota: 1 unit (channelSections.list). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: /v1/accounts/{accountId}/focus/channel-sections.
Try it with MCPAsk your agent to call youtube-channel-sections-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
idstringread-onlytypestringrequiredallPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents
titlestring | nullRequired for multiplePlaylists / multipleChannels
positionintegerplaylistsarray of stringsinglePlaylist (1) / multiplePlaylists
channelsarray of stringmultipleChannels
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Home tab sections item
/accounts/{accountId}/youtube/channel-sectionsAdd section · quota: 50 units (channelSections.insert). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: /v1/accounts/{accountId}/focus/channel-sections.
Try it with MCPAsk your agent to call youtube-channel-sections-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
typestringrequiredallPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents
titlestring | nullRequired for multiplePlaylists / multipleChannels
positionintegerplaylistsarray of stringsinglePlaylist (1) / multiplePlaylists
channelsarray of stringmultipleChannels
Returns object
idstringread-onlytypestringrequiredallPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents
titlestring | nullRequired for multiplePlaylists / multipleChannels
positionintegerplaylistsarray of stringsinglePlaylist (1) / multiplePlaylists
channelsarray of stringmultipleChannels
Responses
YouTube: Update a Home tab sections item
/accounts/{accountId}/youtube/channel-sections/{itemId}Edit / move section · quota: 51 units (channelSections.list, channelSections.update). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: /v1/accounts/{accountId}/focus/channel-sections.
Try it with MCPAsk your agent to call youtube-channel-sections-update (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
typestringallPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents
titlestring | nullRequired for multiplePlaylists / multipleChannels
positionintegerplaylistsarray of stringsinglePlaylist (1) / multiplePlaylists
channelsarray of stringmultipleChannels
Returns object
idstringread-onlytypestringrequiredallPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents
titlestring | nullRequired for multiplePlaylists / multipleChannels
positionintegerplaylistsarray of stringsinglePlaylist (1) / multiplePlaylists
channelsarray of stringmultipleChannels
Responses
YouTube: Delete a Home tab sections item
/accounts/{accountId}/youtube/channel-sections/{itemId}Remove section · quota: 50 units (channelSections.delete). Shelves on the channel home tab: uploads, popular, playlists, channels, live, …. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channelSections Generic route: /v1/accounts/{accountId}/focus/channel-sections.
Try it with MCPAsk your agent to call youtube-channel-sections-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Subscriptions
YouTube: List Subscriptions
/accounts/{accountId}/youtube/subscriptionsMy subscriptions · quota: 1 unit (subscriptions.list). Channels this channel subscribes to; subscribe / unsubscribe. Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions Generic route: /v1/accounts/{accountId}/focus/subscriptions.
Try it with MCPAsk your agent to call youtube-subscriptions-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringorderstringalphabeticalrelevanceunread
for_channel_idstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
idstringread-onlychannel_idstringrequiredtitlestringread-onlydescriptionstring | nullread-onlythumbnail_urlstring (uri) | nullread-onlysubscribed_atstring (date-time)read-onlysubscriber_channel_idstring | nullread-onlysubscriber_titlestring | nullread-onlysubscriber_thumbnail_urlstring (uri) | nullread-onlytotal_item_countinteger | nullread-onlynew_item_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Create a Subscriptions item
/accounts/{accountId}/youtube/subscriptionsSubscribe · quota: 50 units (subscriptions.insert). Channels this channel subscribes to; subscribe / unsubscribe. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions Generic route: /v1/accounts/{accountId}/focus/subscriptions.
Try it with MCPAsk your agent to call youtube-subscriptions-create (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
channel_idstringrequiredReturns object
idstringread-onlychannel_idstringrequiredtitlestringread-onlydescriptionstring | nullread-onlythumbnail_urlstring (uri) | nullread-onlysubscribed_atstring (date-time)read-onlysubscriber_channel_idstring | nullread-onlysubscriber_titlestring | nullread-onlysubscriber_thumbnail_urlstring (uri) | nullread-onlytotal_item_countinteger | nullread-onlynew_item_countinteger | nullread-onlyResponses
YouTube: Delete a Subscriptions item
/accounts/{accountId}/youtube/subscriptions/{itemId}Unsubscribe · quota: 50 units (subscriptions.delete). Channels this channel subscribes to; subscribe / unsubscribe. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions Generic route: /v1/accounts/{accountId}/focus/subscriptions.
Try it with MCPAsk your agent to call youtube-subscriptions-delete (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Subscribers
YouTube: List Subscribers
/accounts/{accountId}/youtube/subscribersSubscribers · quota: 1 unit (subscriptions.list). Subscribers with public subscriptions (all or recent). Cursor pagination: pass next_cursor back as cursor. Requires one of: https://www.googleapis.com/auth/youtube.readonly | https://www.googleapis.com/auth/youtube.force-ssl | https://www.googleapis.com/auth/youtube | https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/subscriptions/list Generic route: /v1/accounts/{accountId}/focus/subscribers.
Try it with MCPAsk your agent to call youtube-subscribers-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringrecentbooleandefault: falseReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 11 item attributes
idstringread-onlychannel_idstringrequiredtitlestringread-onlydescriptionstring | nullread-onlythumbnail_urlstring (uri) | nullread-onlysubscribed_atstring (date-time)read-onlysubscriber_channel_idstring | nullread-onlysubscriber_titlestring | nullread-onlysubscriber_thumbnail_urlstring (uri) | nullread-onlytotal_item_countinteger | nullread-onlynew_item_countinteger | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Video categories
YouTube: List Video categories
/accounts/{accountId}/youtube/video-categoriesCategories for a region · quota: 1 unit (videoCategories.list). Cursor pagination: pass next_cursor back as cursor. Network docs: https://developers.google.com/youtube/v3/docs/videoCategories Generic route: /v1/accounts/{accountId}/focus/video-categories.
Try it with MCPAsk your agent to call youtube-video-categories-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
region_codestringdefault: "US"hlstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringread-onlytitlestringread-onlyassignablebooleanread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Languages
YouTube: List Languages
/accounts/{accountId}/youtube/languagesi18n languages · quota: 1 unit (i18nLanguages.list). Cursor pagination: pass next_cursor back as cursor. Network docs: https://developers.google.com/youtube/v3/docs/i18nLanguages Generic route: /v1/accounts/{accountId}/focus/languages.
Try it with MCPAsk your agent to call youtube-languages-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
hlstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringread-onlycodestringread-onlynamestringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Regions
YouTube: List Regions
/accounts/{accountId}/youtube/regionsi18n regions · quota: 1 unit (i18nRegions.list). Cursor pagination: pass next_cursor back as cursor. Network docs: https://developers.google.com/youtube/v3/docs/i18nRegions Generic route: /v1/accounts/{accountId}/focus/regions.
Try it with MCPAsk your agent to call youtube-regions-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
hlstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringread-onlycodestringread-onlynamestringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Abuse reports
YouTube: List Report abuse
/accounts/{accountId}/youtube/abuse-reportsAbuse report reasons · quota: 1 unit (videoAbuseReportReasons.list). Abuse report reasons; report a video. Cursor pagination: pass next_cursor back as cursor. Network docs: https://developers.google.com/youtube/v3/docs/videos/reportAbuse Generic route: /v1/accounts/{accountId}/focus/abuse-reports.
Try it with MCPAsk your agent to call youtube-abuse-reports-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
hlstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringread-onlylabelstringread-onlysecondary_reasonsarray of objectread-onlyShow 2 item attributes
idstringlabelstringlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
YouTube: Report a video (Report abuse)
/accounts/{accountId}/youtube/abuse-reports/reportvideos.reportAbuse · quota: 50 units (videos.reportAbuse). Abuse report reasons; report a video. Destructive. Requires scopes: https://www.googleapis.com/auth/youtube.force-ssl. Network docs: https://developers.google.com/youtube/v3/docs/videos/reportAbuse Generic route: /v1/accounts/{accountId}/focus/abuse-reports.
Try it with MCPAsk your agent to call youtube-abuse-reports-report (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
video_idstringrequiredreason_idstringrequiredsecondary_reason_idstringcommentsstringlanguagestringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Managed channels
YouTube: List Managed channels
/accounts/{accountId}/youtube/managed-channelsManaged channels · quota: 1 unit (channels.list). YouTube CMS content owners: channels managed by this content owner. Cursor pagination: pass next_cursor back as cursor. Requires scopes: https://www.googleapis.com/auth/youtubepartner. Network docs: https://developers.google.com/youtube/v3/docs/channels/list Generic route: /v1/accounts/{accountId}/focus/managed-channels.
Try it with MCPAsk your agent to call youtube-managed-channels-list (toolset focus_youtube)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
limitintegerdefault: 251–50
cursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 24 item attributes
idstringread-onlytitlestringread-onlyNot editable via the API
handlestring | nullread-onlycustom_urlstring | nullread-onlydescriptionstring≤ 1000 characters
keywordsarray of stringChannel tags
countrystring | nullISO 3166-1 alpha-2
default_languagestring | nullunsubscribed_trailerstring | nullVideo id shown to non-subscribers (public/unlisted, owned)
tracking_analytics_account_idstring | nullGoogle Analytics property id
self_declared_made_for_kidsboolean | nullChannel-level made for kids
made_for_kidsboolean | nullread-onlythumbnail_urlstring (uri) | nullread-onlybanner_urlstring (uri) | nullread-onlysubscriber_countinteger | nullread-onlyhidden_subscriber_countboolean | nullread-onlyvideo_countinteger | nullread-onlyview_countinteger | nullread-onlyuploads_playlist_idstring | nullread-onlyprivacy_statusstring | nullread-onlylong_uploads_statusstring | nullread-onlypublished_atstring (date-time)read-onlytopic_categoriesarray of string (uri)read-onlyurlstring (uri)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | null