youtube-data

name

youtube-data

description

YouTube is a video hosting and streaming platform, and the YouTube Data API provides programmatic access to videos, channels, playlists, comments, and search results, allowing developers to build integrations for content management, analytics, discovery, and audience engagement workflows. Read and write YouTube Data data through One: videos, comments, captions, livebroadcasts, livechatmessages, channelsections and more, 83 actions with real parameter documentation. Use whenever the user asks to look something up in YouTube Data, create or update a record there, or build code against the YouTube Data API.

YouTube Data through One

YouTube is a video hosting and streaming platform, and the YouTube Data API provides programmatic access to videos, channels, playlists, comments, and search results, allowing developers to build integrations for content management, analytics, discovery, and audience engagement workflows.

One exposes YouTube Data through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform youtube-data if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm YouTube Data is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real YouTube Data account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Videos

Action	Method	Path	Action id
Get Ratings for Videos	GET	/youtube/v3/videos/getRating	conn_mod_def::GKKPEuhLLbk::7s-e4xuPTh602PqgTlEHIA
List Videos	GET	/youtube/v3/videos	conn_mod_def::GKKPEyCYjmc::jTY7ENAyQ1uugwAPicQ3gg
Delete a Video	DELETE	/youtube/v3/videos	conn_mod_def::GKKPEuAivfU::cZPLigbbQuqST6AKWnWp7w
Insert a YouTube Video	POST	/youtube/v3/videos	conn_mod_def::GKKPExZEsRs::BbVp6cmoSRe_w1arK7S_sg
Rate a Video	POST	/youtube/v3/videos/rate	conn_mod_def::GKKPE7zMN2M::GGwxuLOcSdSmMIG3uTZySA
Report Abuse for a Video	POST	/youtube/v3/videos/reportAbuse	conn_mod_def::GKKPE6t_tXk::rD4CxOqdRz6gVDCMnzos_g
Update a Video	PUT	/youtube/v3/videos	conn_mod_def::GKKPE8pVOco::uRoXtLWDQ-mmps1Vq1ocCQ

Comments

Action	Method	Path	Action id
List Comments	GET	/youtube/youtube/v3/comments	conn_mod_def::GKKPCeGUHL8::N8QaLl3QSHiJzXLbL9vBOA
Delete a Comment	DELETE	/youtube/v3/comments	conn_mod_def::GKKPCKGHSIQ::_CVIgrIQRP--s9CKk7dcyQ
Insert a YouTube Comment	POST	/youtube/v3/comments	conn_mod_def::GKKPCc0F08c::Gj4OBw5dQZetsNebH5fDmQ
Mark Comments as Spam	POST	/youtube/v3/comments/markAsSpam	conn_mod_def::GKKPCbsMoXo::b7hK__DASpiBf2-o8GA-Aw
Set Moderation Status for YouTube Comments	POST	/youtube/v3/comments/setModerationStatus	conn_mod_def::GKKPCdlbATU::Upotyr-jRlK1TRYbJdx_rA
Update a Comment	PUT	/youtube/v3/comments	conn_mod_def::GKKPCdoaMnI::hLAY_cUETcqkQbb4npe2ow

Captions

Action	Method	Path	Action id
Download a Caption Track	GET	/youtube/v3/captions/{{id}}	conn_mod_def::GKKPBy5GNmk::PcGvJYgtTlG8psh0G2k0sg
List Video Captions	GET	/youtube/v3/captions	conn_mod_def::GKKPB9fkzeg::468r40KXTpS4M0605Beqag
Delete Captions	DELETE	/youtube/v3/captions	conn_mod_def::GKKPBxamsk4::zqbu9n4uSU6Imolq0wL-NQ
Insert a YouTube Caption Track	POST	/youtube/youtube/v3/captions	conn_mod_def::GKKPByC3J7s::4CpHyFstQo-dyj94FpFYuA
Update a YouTube Caption Track	PUT	/youtube/v3/captions	conn_mod_def::GKKPB_G0kKo::HnuSlBvrQxi02JMwasSKNw

LiveBroadcasts

Action	Method	Path	Action id
List a Channel's Live Broadcasts	GET	/youtube/v3/liveBroadcasts	conn_mod_def::GKKPC7YKjXg::JdDqMn1KSA-AKf7CFCBDPQ
Bind a Live Broadcast to a Stream	POST	/youtube/v3/liveBroadcasts/bind	conn_mod_def::GKKPCpKhwM4::FF8RAMufSKWADL1Obw3JPA
Delete a Live Broadcast	DELETE	/youtube/v3/liveBroadcasts	conn_mod_def::GKKPCziZUj8::ziPkrzDdSoqxjFa2R8ZFKA
Transition a Live Broadcast	POST	/youtube/v3/liveBroadcasts/transition	conn_mod_def::GKKPC0H1eco::jAnhopHjSp62dJCUHa_5hg
Update a User's Live Broadcast	PUT	/youtube/v3/liveBroadcasts	conn_mod_def::GKKPDF1C_Qs::0DHrkOa3Sj2Zc6wNONgAAg

LiveChatMessages

Action	Method	Path	Action id
List Live Chat Messages	GET	/youtube/v3/liveChat/messages	conn_mod_def::GKKPDdHmajA::hLAkm6DQTN-VBLpP3YM5Ew
Stream Live Chat Messages	GET	/youtube/v3/liveChat/messages/stream	conn_mod_def::GKKPFIkNL44::gcH2mRf-RhSxuEGovLOtwQ
Delete a Live Chat Message	DELETE	/youtube/v3/liveChat/messages	conn_mod_def::GKKPDQA6TIw::MjJOUnWDRVGRK2Xszre7Yg
Insert a YouTube Live Chat Message	POST	/youtube/v3/liveChat/messages	conn_mod_def::GKKPDEAhoNg::Hw8s5pS8QdWmiNZWdnAMhg
Transition a Live Chat Message Event	POST	/youtube/v3/liveChat/messages/transition	conn_mod_def::GKKPDYyRvg8::rMhrMkaOScGE94O8NmUsnA

ChannelSections

Action	Method	Path	Action id
List Channel Sections	GET	/youtube/v3/channelSections	conn_mod_def::GKKPCMTKoGY::t8HaYQsWTCyx0t2hPxvnyw
Delete a Channel Section	DELETE	/youtube/v3/channelSections	conn_mod_def::GKKPCTwSFm4::eCSqanrcS9S3sjdpw5IO0Q
Insert a Channel Section	POST	/youtube/v3/channelSections	conn_mod_def::GKKPCMNIFaA::fVhcHZ_2RqSP_ANWrZWHMQ
Update Channel Section	PUT	/youtube/v3/channelSections	conn_mod_def::GKKPCKAHF8w::NriukV_jQuqHdt4_gU0g8Q

LiveStreams

Action	Method	Path	Action id
List Live Streams for a Channel	GET	/youtube/v3/liveStreams	conn_mod_def::GKKPDl4plO8::WOq6B-FsTgKtOZS_cn_TaA
Delete a User's Live Stream	DELETE	/youtube/v3/liveStreams	conn_mod_def::GKKPDmjoIhY::ME9ibnZ2Qj2j-JRBkk8mGQ
Insert a YouTube Live Stream	POST	/youtube/v3/liveStreams	conn_mod_def::GKKPDlmaURY::uK7yGkC0TQGVyKW6KsqVqw
Update a Live Stream	PUT	/youtube/v3/liveStreams	conn_mod_def::GKKPDnWYNR4::-mljTB_tQVC4jCag8sWYfw

PlaylistImages

Action	Method	Path	Action id
List Playlist Images	GET	/youtube/v3/playlistImages	conn_mod_def::GKKPDxW9WWg::cL7U4GbkSOKW9fEM4H3AHw
Delete Playlist Images	DELETE	/youtube/v3/playlistImages	conn_mod_def::GKKPDwkmnT4::fdWUxeHeT2K5IN6C8QA69A
Insert a Playlist Image	POST	/youtube/v3/playlistImages	conn_mod_def::GKKPDyEAWTw::4ZuCDR4_SZ-p1CdNKFA4ZA
Update Playlist Images	PUT	/upload/youtube/v3/playlistImages	conn_mod_def::GKKPDw5ceB8::KlybpDuXQhKiN39dgU9oyw

PlaylistItems

Action	Method	Path	Action id
List Playlist Items	GET	/youtube/v3/playlistItems	conn_mod_def::GKKPD-ndjXw::3Jq2iL2zRrePHcrq9GV7yQ
Delete a Playlist Item	DELETE	/youtube/v3/playlistItems	conn_mod_def::GKKPD7Kd-do::go16PmEYT7mrHbp_qFftTA
Insert a Playlist Item	POST	/youtube/v3/playlistItems	conn_mod_def::GKKPD7DBGEA::LfkzL-f1SXaG6eB6Ox2v3w
Update Playlist Items	PUT	/youtube/v3/playlistItems	conn_mod_def::GKKPD7jYqjc::lA7m_PxNRqeUPLp0nMRs-Q

Playlists

Action	Method	Path	Action id
List Playlists	GET	/youtube/v3/playlists	conn_mod_def::GKKPEI4xYlI::mH9wDgN0R7eIRgRzWV5q7Q
Delete a Playlist	DELETE	/youtube/v3/playlists	conn_mod_def::GKKPD7TewIs::ceyVQMGXQMynSYu9W-306Q
Insert a YouTube Playlist	POST	/youtube/v3/playlists	conn_mod_def::GKKPEI-cejw::QLhJIQ68RoaOk351DvRJtw
Update a Playlist	PUT	/youtube/v3/playlists	conn_mod_def::GKKPEIIULhs::8VcxXSpjQue5OdzIizc4xA

ThirdPartyLinks

Action	Method	Path	Action id
List Third-Party Links	GET	/youtube/v3/thirdPartyLinks	conn_mod_def::GKKPEkDKnXw::FJFtvAvGR_OnK7O7qhk07w
Delete Third-Party Links	DELETE	/youtube/v3/thirdPartyLinks	conn_mod_def::GKKPEXz6fI8::_-rk0YyaRLOlZP1mqYcv5w
Insert a Third-Party Link	POST	/youtube/v3/thirdPartyLinks	conn_mod_def::GKKPEj1BB4g::fllRVF1CQHydCVb5sjW7Tg
Update Third-Party Links	PUT	/youtube/v3/thirdPartyLinks	conn_mod_def::GKKPEkWf7N8::r-Kp8Jk2T8ys2qp_tZ1Rrg

CommentThreads

Action	Method	Path	Action id
List Comment Threads	GET	/youtube/v3/commentThreads	conn_mod_def::GKKPCpi8PV8::D4GT88-wSh6X1Em-D9pQRQ
Insert a Comment Thread	POST	/youtube/v3/commentThreads	conn_mod_def::GKKPCnWM_Jg::lqUJH2BlR0SwK8wWkmLmXA
Update Comment Threads	PUT	/youtube/v3/commentThreads	conn_mod_def::GKKPFFV9Fm0::MlcmqlXUQ6uuYkikmmyF0A

Subscriptions

Action	Method	Path	Action id
List YouTube Subscriptions	GET	/youtube/v3/subscriptions	conn_mod_def::GKKPEapWl0o::L8d3hQk1RaWawF66Z7jftA
Delete a Subscription	DELETE	/youtube/v3/subscriptions	conn_mod_def::GKKPEGIf3oY::TdVFcyaQTmS7kvireJMb2Q
Insert a YouTube Subscription	POST	/youtube/v3/subscriptions	conn_mod_def::GKKPEYL-GDY::8tdOS18tQpe4hm-U-m1Evw

LiveChatModerators

Action	Method	Path	Action id
List Live Chat Moderators	GET	/youtube/v3/liveChat/moderators	conn_mod_def::GKKPDZlazjY::N_U3eiwGS82v3oTA7qYqhw
Delete a Live Chat Moderator	DELETE	/youtube/v3/liveChat/moderators	conn_mod_def::GKKPDYkxUsU::9Xe7MLDuT2CIew-LbgXPmg
Insert a Live Chat Moderator	POST	/youtube/v3/liveChat/moderators	conn_mod_def::GKKPDY_xeLQ::FE350VYdTFWsMo9gLvIfdQ

LiveChatBans

Action	Method	Path	Action id
Delete a Live Chat Ban	DELETE	/youtube/v3/liveChat/bans	conn_mod_def::GKKPDDiOGwE::mPEgh0arQXadhhsReHpJLA
Insert a Live Chat Ban	POST	/youtube/v3/liveChat/bans	conn_mod_def::GKKPDE6-97g::yhQN3_zmTqGNud12lIfBnQ

Watermarks

Action	Method	Path	Action id
Remove a Channel Watermark	POST	/youtube/v3/watermarks/unset	conn_mod_def::GKKPFY-fnLQ::cIQJW7CuT1qXB1CYAw7SAQ
Set a Channel Watermark	POST	/upload/youtube/v3/watermarks/set	conn_mod_def::GKKPE8CXAhY::At_qQunORsSlWf2JJOAVUw

Channels

Action	Method	Path	Action id
List Channels	GET	/youtube/v3/channels	conn_mod_def::GKKPCBjQE60::zygriKUoRveDnsUAgdlwyA
Update Channels	PUT	/youtube/v3/channels	conn_mod_def::GKKPB9-zqxE::MyU_yZ15RjibFe1TF1dB-Q

Activities

Action	Method	Path	Action id
List YouTube Activities	GET	/youtube/v3/activities	conn_mod_def::GKKPBzqXC7E::dEGeHyjOSiqob2gZ3cNbMg

AbuseReports

Action	Method	Path	Action id
Insert an Abuse Report	POST	/youtube/v3/abuseReports	conn_mod_def::GKKPBzvvSQc::r74cNNMCSMqQ-2c-S1W--Q

LiveBroadcast

Action	Method	Path	Action id
Insert a Live Broadcast	POST	/youtube/v3/liveBroadcasts	conn_mod_def::GKKPC0SqiJ8::hUYBiq0QSKCDSc2s4KAOEA

MembershipsLevels

Action	Method	Path	Action id
List Channel Membership Pricing Levels	GET	/youtube/v3/membershipsLevels	conn_mod_def::GKKPDv3i-zg::nMJ51lr9TT2s3In5QmsGSg

SearchResources

Action	Method	Path	Action id
List Search Resources	GET	/youtube/v3/search	conn_mod_def::GKKPEPj66co::N_9ZRxVwRNGloCs-rFMqiw

SuperChatEvents

Action	Method	Path	Action id
List Super Chat Events	GET	/youtube/v3/superChatEvents	conn_mod_def::GKKPEX9GKp4::cvS442ziQl6jQ7yGXVyDWw

TestItem

Action	Method	Path	Action id
Insert a YouTube Test Item	POST	/youtube/v3/tests	conn_mod_def::GKKPEa0sps0::OodIIe5ETBGZ_UuRq-keKg

VideoAbuseReportReasons

Action	Method	Path	Action id
List Video Abuse Report Reasons	GET	/youtube/v3/videoAbuseReportReasons	conn_mod_def::GKKPEkNT5FM::22K63f4jSsG3gY4ATN_Xmw

Thumbnails

Action	Method	Path	Action id
Set a Video Thumbnail	POST	/upload/youtube/v3/thumbnails/set	conn_mod_def::GKKPElL_g6I::slW-7F0rSaWq3Av8C1nbtg

VideoCategories

Action	Method	Path	Action id
List Video Categories	GET	/youtube/v3/videoCategories	conn_mod_def::GKKPEuJeF0g::_e6GbSQTS5yKP1PqFpa0Ig

Members

Action	Method	Path	Action id
List Channel Members	GET	/youtube/v3/members	conn_mod_def::GKKPDn3EUKo::ucFyP8f9RcKUHldqlWIc1w

ChannelBanners

Action	Method	Path	Action id
Insert a Channel Banner	POST	/upload/youtube/v3/channelBanners/insert	conn_mod_def::GKKPB_Lapz8::HTTI3kyRR2-DXiVGKl-QdQ

I18nRegions

Action	Method	Path	Action id
List YouTube i18n Regions	GET	/youtube/v3/i18nRegions	conn_mod_def::GKKPCnzwWDQ::Nq0i3lcxSECnzv6x_t2Ddw

I18nLanguages

Action	Method	Path	Action id
List YouTube i18n Languages	GET	/youtube/v3/i18nLanguages	conn_mod_def::GKKPCn3eYu8::K4Q276aQSxWAsms5E846ag

VideoTrainability

Action	Method	Path	Action id
Get Video Trainability	GET	/youtube/v3/videoTrainability	conn_mod_def::GKKPE7CZ5bE::GTnx0lCLRIWkpxfZUU4xaA

LiveBroadcastCuepoint

Action	Method	Path	Action id
Insert a Live Broadcast Cuepoint	POST	/youtube/v3/liveBroadcasts/cuepoint	conn_mod_def::GKKPC0z8tuQ::b9Ux_X8fTUKdsMKgo7aGrQ

When a call fails

The error comes from YouTube Data, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/youtube-data

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.