Youtube

part

Specifies which channel resource properties are included in the API response.

categoryId

Specifies a YouTube guide category to request YouTube channels associated with that category (deprecated).

forHandle

Specifies a YouTube handle to request the channel associated with that handle.

forUsername

Specifies a YouTube username to request the channel associated with that username.

id

Specifies a comma-separated list of YouTube channel IDs for the resources that are being retrieved.

managedByMe

If true, only return channels managed by the content owner (requires content partner authorization and onBehalfOfContentOwner).

mine

If true, only return channels owned by the authenticated user.

hl

Retrieve localized resource metadata for a supported language.

maxResults

Maximum number of items to return.

onBehalfOfContentOwner

Indicates that the request's authorization credentials identify a YouTube CMS user acting on behalf of a content owner.

pageToken

Token for fetching a specific page in the result set.

part

A comma-separated list of one or more playlistItem resource properties that the API response will include.

id

A comma-separated list of one or more unique playlist item IDs to retrieve. Must not be used together with playlistId.

playlistId

The unique ID of the playlist for which you want to retrieve playlist items. Must not be used together with id.

maxResults

The maximum number of items to return in the result set.

onBehalfOfContentOwner

This parameter is intended exclusively for YouTube content partners and indicates the request's authorization credentials identify a YouTube CMS user acting on behalf of the content owner.

pageToken

Identifies a specific page in the result set to be returned. Used for paginating long result sets.

videoId

Specifies to return only the playlist items that contain the specified video.

part

Specifies which subscription properties to return in the response.

channelId

The ID of the channel whose subscriptions you want to retrieve.

mine

Indicates whether to return subscriptions of the authenticated user.

maxResults

Limits the number of subscriptions returned. Defaults to 5.

part

The part parameter determines what data is returned for the videos.

chart

Specifies the type of video chart, e.g. mostPopular.

id

Used to retrieve specific videos by their IDs.

myRating

Filters the results to only return videos rated by the user.

maxResults

Limits the number of results returned by the API.

regionCode

Used to specify the region for video popularity.

part

Specifies which playlist resource properties the API response should include.

channelId

Returns playlists belonging to the specified channel ID. Mutually exclusive with id and mine.

id

Returns the playlists with these YouTube playlist IDs. Mutually exclusive with channelId and mine.

mine

Returns only playlists owned by the authenticated user. Mutually exclusive with channelId and id.

hl

Specifies the application language for localized playlist resource details.

maxResults

Specifies the maximum number of playlists to return.

onBehalfOfContentOwner

Indicates that the request uses credentials from a YouTube CMS account to access data for the specified content owner. Intended for YouTube content partners.

onBehalfOfContentOwnerChannel

Specifies a channel ID when acting on behalf of a content owner. Must be used in conjunction with onBehalfOfContentOwner, for partners only.

pageToken

Indicates a specific result page to return, as returned by previous API calls.

part

This parameter should be set to 'snippet'.

q

The keyword or phrase to search for videos.

maxResults

The number of results to return (default is 5).

type

Acceptable values are 'video', 'channel', 'playlist'.

part

Specifies which resource properties to return in the response. At least 'snippet' is required.

q

Search term(s) to query for.

channelId

Limits search results to resources created by this channel.

type

Restricts the search to a specific type of resource: video, channel, playlist.

maxResults

Maximum number of items returned. Default is 5.

order

Specifies method to order returned results.

pageToken

Token for retrieving a specific page in a paginated result set.

regionCode

Instructs API to return search results for videos viewable in this country.

publishedAfter

Restricts to resources published at or after this date/time.

publishedBefore

Restricts to resources published at or before this date/time.

safeSearch

Indicates if the search results should include restricted content.

videoCategoryId

Filters videos to those in a particular YouTube video category. Requires type=video.

eventType

Restricts to broadcast events. Requires type=video.

forContentOwner

Restricts search to videos owned by the content owner. Requires proper OAuth and onBehalfOfContentOwner.

forDeveloper

Only retrieves videos uploaded via the developer's app. Requires OAuth authentication.

forMine

Restricts search to videos owned by the authenticated user. Requires OAuth. type=video required.

location

Central point for a circular geographic search. Requires type=video and locationRadius.

locationRadius

Maximum distance from 'location' for a video to be returned. E.g. '10mi', '5km'. Must provide 'location' parameter as well.

file

Location of the video file to be uploaded

title

Title of the video, defaults to 'Test Title'

description

Description for the video, defaults to 'Test Description'

category

Numeric ID for the video category, defaults to '22'

keywords

Keywords associated with the video, defaults to an empty string

privacyStatus

Privacy status of the video, defaults to 'public'