Entertainment & Media

Youtube

Learn how to use Youtube with Composio

Overview

SLUG

YOUTUBE

Description

YouTube is a video-sharing platform with user-generated content, live streaming, and monetization opportunities, widely used for marketing, education, and entertainment

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to https://www.googleapis.com/auth/youtube https://www.googleapis.com/auth/youtube.channel-memberships.creator https://www.googleapis.com/auth/youtube.force-ssl https://www.googleapis.com/auth/youtube.readonly https://www.googleapis.com/auth/youtube.upload https://www.googleapis.com/auth/youtubepartner https://www.googleapis.com/auth/youtubepartner-channel-audit
full
stringDefaults to https://www.googleapis.com/youtube/v3
bearer_token
string

Tools

SLUG: YOUTUBE_LIST_CAPTION_TRACK

Retrieves a list of caption tracks for a youtube video, returning an empty list if no captions exist or failing if the video id is invalid or not found.

Action Parameters

part
stringDefaults to snippet
videoId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_UPDATE_THUMBNAIL

Sets the custom thumbnail for a youtube video using an image from thumbnailurl; the authenticated user must have permission to edit the video.

Action Parameters

thumbnailUrl
stringRequired
videoId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_GET_CHANNEL_ID_BY_HANDLE

Retrieves the youtube channel id for a specific youtube channel handle.

Action Parameters

channel_handle
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_LIST_CHANNEL_VIDEOS

Lists videos from a specified youtube channel, ensuring results are of `type: 'video'`.

Action Parameters

channelId
stringRequired
maxResults
integerDefaults to 5
pageToken
string
part
stringDefaults to snippet

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_LIST_USER_PLAYLISTS

Retrieves playlists owned by the authenticated user, implicitly using mine=true.

Action Parameters

maxResults
integerDefaults to 5
pageToken
string
part
stringDefaults to snippet

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_LIST_USER_SUBSCRIPTIONS

Retrieves the authenticated user's youtube channel subscriptions, allowing specification of response parts and pagination.

Action Parameters

maxResults
integerDefaults to 5
pageToken
string
part
stringDefaults to snippet,contentDetails

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_LOAD_CAPTIONS

Downloads a specific youtube caption track, which must be owned by the authenticated user, and returns its content as text.

Action Parameters

id
stringRequired
tfmt
stringDefaults to srt

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_SEARCH_YOU_TUBE

Searches youtube for videos, channels, or playlists using a query term, returning the raw api response.

Action Parameters

maxResults
integerDefaults to 5
pageToken
string
part
stringDefaults to snippet
q
stringRequired
type
stringDefaults to video

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_SUBSCRIBE_CHANNEL

Subscribes the authenticated user to a specified youtube channel, identified by its unique `channelid` which must be valid and existing.

Action Parameters

channelId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_UPDATE_VIDEO

Updates metadata for a youtube video identified by videoid, which must exist; an empty list for tags removes all existing tags.

Action Parameters

categoryId
string
description
string
privacyStatus
string
tags
array
title
string
videoId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_UPLOAD_VIDEO

Uploads a video from a local file path to a youtube channel; the video file must be in a youtube-supported format.

Action Parameters

categoryId
stringRequired
description
stringRequired
privacyStatus
stringRequired
tags
arrayRequired
title
stringRequired
videoFilePath
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: YOUTUBE_VIDEO_DETAILS

Retrieves specified information parts (e.g., snippet, contentdetails, statistics) for a youtube video, identified by its id.

Action Parameters

id
stringRequired
part
stringDefaults to snippet,contentDetails,statistics

Action Response

data
objectRequired
error
string
successful
booleanRequired