YouTube Upload API: Schedule Videos

API id: youtube

At a glance


Title	Required, up to 100 characters. Send it as `channels[].title`.
Description	5,000 characters (the block's `content`)
Files per post	Exactly 1 video
File needed?	Yes
Threads	No
Edit after publish	Yes — description, title and options
Delete after publish	Yes
Analytics	Views, impressions, likes, comments
Comments	Read and reply

Options

Key	Type	What it does
`privacyStatus`	choice	`public` (default), `unlisted` or `private`.
`tags`	text	Comma-separated keywords. The whole list must fit in 500 characters.
`categoryId`	choice	The video category. Default: `22` (People & Blogs). See the list below.
`playlistId`	choice	Adds the video to one of the channel's playlists.
`selfDeclaredMadeForKids`	true / false	Marks the video as made for kids. This is a legal declaration: the video loses comments, notifications and personalised ads.
`defaultLanguage`	choice	Language of the title and description, like `en` or `fr`.
`defaultAudioLanguage`	choice	Language spoken in the video.
`thumbnail`	media	Custom thumbnail. JPEG or PNG, up to 2 MB. Needs a verified YouTube channel.
`captionFile`	media	A subtitle file (`.vtt` or `.srt`), uploaded with `POST /media` first. Needs `captionLanguage`.
`captionLanguage`	choice	Language of the subtitle file.

Categories: 1 Film & Animation, 2 Autos & Vehicles, 10 Music, 15 Pets & Animals, 17 Sports, 19 Travel & Events, 20 Gaming, 22 People & Blogs, 23 Comedy, 24 Entertainment, 25 News & Politics, 26 Howto & Style, 27 Education, 28 Science & Technology, 29 Nonprofits & Activism.

Example

{
  "channelId": "CHANNEL_YOUTUBE",
  "title": "How we cut our build time in half",
  "options": {
    "privacyStatus": "unlisted",
    "categoryId": "28",
    "tags": "devops, ci, build",
    "selfDeclaredMadeForKids": "false"
  },
  "blocks": [{ "content": "In this video we walk through…", "mediaIds": ["VIDEO_ID"] }]
}

Good to know

Private until audited

Until your Google Cloud project passes YouTube's compliance audit, YouTube makes every upload private, whatever privacyStatus you send.

Without a verified channel, a custom thumbnail is skipped. The video still publishes and YouTube picks a frame.

Comments

You can read the comments on a published video and reply to them. See Read and reply to comments.

Newest first, 50 comments per page. Use nextCursor for more.
Up to 5 replies are shown under each comment. YouTube needs a separate request for more, which Bulkit does not spend your quota on.
YouTube only nests one level. A reply to a reply is posted under the top-level comment.
Each reply uses 51 units of your Google project's daily quota (50 for the reply, 1 to check the comment). Reading a page uses 1. The default quota is 10,000 units a day, shared with uploads.
Needs youtube.force-ssl, the same permission as deleting a video. An account connected before that shows needs-reconnect.

Set up

To connect accounts, you first need your own app on this platform. See the YouTube app setup guide.

YouTube