Get the authorized channel's profile, statistics, and uploads playlist id.

List the channel's uploaded videos, newest first, with basic stats.

Get full metadata and statistics for one video.

Update video metadata. Only supplied fields change; others are preserved.

Set a custom thumbnail from a local image file (JPG/PNG, <2MB).

Upload a video (resumable). privacy: private|unlisted|public. publish_at (RFC3339) schedules publication and requires privacy=private.

Permanently delete a video. Irreversible.

List the channel's playlists.

Create a playlist. privacy: public|unlisted|private.

Delete a playlist (videos are not deleted).

Add a video to a playlist, optionally at a specific position.

Remove an item from a playlist by playlist-item id (from list results).

List videos in a playlist.

List comment threads for one video, or channel-wide when video_id is omitted.

Post a top-level comment on a video as the channel (e.g. a question prompt for viewers). Note: the API cannot pin comments — pin manually in YouTube Studio if desired.

Reply to a comment as the channel.

Set moderation status: published | heldForReview | rejected.

Flag a comment as spam.

Delete a comment authored by the channel (own comments only).

List live broadcasts. status: all|active|upcoming|completed.

Schedule a live broadcast. start_time is RFC3339 (e.g. 2026-08-01T18:00:00Z).

List reusable stream keys and their health.

Bind a broadcast to a stream key.

Read messages from a live chat (chat_id from list_broadcasts).

Post a message to a live chat as the channel.

Delete a live chat message.

Ban a user from live chat; temporary when duration_seconds given, else permanent.

List caption tracks on a video.

Upload a caption track (SRT/VTT file).

Download a caption track's text. fmt: srt|vtt.

Channel analytics between start/end (YYYY-MM-DD).

Per-video analytics between start/end (YYYY-MM-DD).

Top videos by views between start/end (YYYY-MM-DD).

Collect giveaway entries: walk every upload's comments in the window (RFC3339 timestamps), one entry per distinct video per commenter, capped per user. Writes an auditable snapshot file and returns its hash.

Deterministically draw n winners (distinct channels) from a snapshot. Same snapshot + seed always reproduces the same winners. Writes an audit record next to the snapshot.

Generate a short verification code for a winner and record it in the audit file.

Verify a winner's reply: fetches the comment and checks it was authored by the winning channel and contains their verification code.

Export a snapshot's entries to CSV (channel_id, author, video_id, comment_id, published) for spreadsheets or records.

Draft winner-announcement text (for a pinned comment / community post) from a draw's audit record. Review before posting.

Reply to a winning comment as the channel (winner announcement/notification).

Show the managed banned-word list used by scan_comments.

Add words/phrases to the banned list.

Remove words from the banned list.

Sweep comments (one video, or channel-wide when video_id omitted) for banned words. auto_action: none | heldForReview | rejected — matches get that moderation status applied (dry_run previews instead). incremental=True only examines comments newer than the previous incremental scan (watermark stored locally) — cheap to run daily.

Update descriptions across many videos in one sweep.

mode=append: add text at the end (skips videos that already contain it). mode=footer: everything after the last "---" marker line is replaced with text (marker added if missing) — ideal for a links/giveaway footer kept in sync across all videos. mode=replace: replace occurrences of find with text. Scope: video_ids, or every upload when omitted. Quota: ~51 units per changed video.

Audit every upload's made-for-kids designation (COPPA). Reports both the platform-effective flag and the self-declared one per video.

Channel performance digest for a date window (YYYY-MM-DD): totals, per-day trend, and top videos — run it the morning after a stream.

Post the formatted giveaway question comment (unique question + official-rules link) on a video as the channel. Tracks state locally and refuses to double-post unless force=True. Result includes the Studio URL for the one-click manual pin (no pin API exists).

Cross-reference every upload against posted question comments: which videos still need one, which are posted (with pin links).

Quota units spent this session (local estimate from the official cost table).

Verify stored credentials refresh and the channel is reachable.