partstringRequired
The part parameter specifies a comma-separated list of one or more search resource properties that the API response will include.
qstringRequired
The q parameter specifies the query term to search for.
typestringRequired
The type parameter restricts a search query to only retrieve a particular type of resource. Valid values are: video, channel, playlist.
maxResultsintegerOptional
The maxResults parameter specifies the maximum number of items that should be returned in the result set.
pageTokenstringOptional
The pageToken parameter identifies a specific page in the result set that should be returned.
orderstringOptional
The order parameter specifies the method that will be used to order resources in the API response.
publishedAfterstringOptional
The publishedAfter parameter indicates that the API response should only contain resources created at or after the specified time (ISO 8601 format).
publishedBeforestringOptional
The publishedBefore parameter indicates that the API response should only contain resources created before or at the specified time (ISO 8601 format).
channelIdstringOptional
The channelId parameter indicates that the API response should only contain resources created by the channel.
forContentOwnerbooleanOptional
This parameter can only be used in a properly authorized request, and it is intended exclusively for YouTube content partners.
forDeveloperbooleanOptional
This parameter can only be used in a properly authorized request. The forDeveloper parameter restricts the search to only retrieve videos uploaded via the developer's application or website.
forMinebooleanOptional
This parameter can only be used in a properly authorized request. The forMine parameter restricts the search to only retrieve videos owned by the authenticated user.
channelTypestringOptional
The channelType parameter lets you restrict a search to a particular type of channel.
eventTypestringOptional
The eventType parameter restricts a search to broadcast events. If you specify a value for this parameter, you must also set the type parameter's value to video.
locationstringOptional
The location parameter, in conjunction with the locationRadius parameter, defines a circular geographic area and also restricts a search to videos that specify, in their metadata, a geographic location that falls within that area.
locationRadiusstringOptional
The locationRadius parameter, in conjunction with the location parameter, defines a circular geographic area. The parameter value must be a floating point number followed by a measurement unit (m, km, ft, mi).
onBehalfOfContentOwnerstringOptional
This parameter can only be used in a properly authorized request. The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value.
regionCodestringOptional
The regionCode parameter instructs the API to return search results for videos that can be viewed in the specified country. The parameter value is an ISO 3166-1 alpha-2 country code.
relevanceLanguagestringOptional
The relevanceLanguage parameter instructs the API to return search results that are most relevant to the specified language. The parameter value is typically an ISO 639-1 two-letter language code.
safeSearchstringOptional
The safeSearch parameter indicates whether the search results should include restricted content as well as standard content.
topicIdstringOptional
The topicId parameter indicates that the API response should only contain resources associated with the specified topic. The value identifies a Freebase topic ID.
videoCaptionstringOptional
The videoCaption parameter indicates whether the API should filter video search results based on whether they have captions.
videoCategoryIdstringOptional
The videoCategoryId parameter filters video search results based on their category.
videoDefinitionstringOptional
The videoDefinition parameter lets you restrict a search to only include either high definition (HD) or standard definition (SD) videos.
videoDimensionstringOptional
The videoDimension parameter lets you restrict a search to only retrieve 2D or 3D videos.
videoDurationstringOptional
The videoDuration parameter filters video search results based on their duration.
videoEmbeddablestringOptional
The videoEmbeddable parameter lets you to restrict a search to only videos that can be embedded into a webpage.
videoLicensestringOptional
The videoLicense parameter filters search results to only include videos with a particular license.
videoPaidProductPlacementstringOptional
The videoPaidProductPlacement parameter filters search results to only include videos that the creator has denoted as having a paid promotion.
videoSyndicatedstringOptional
The videoSyndicated parameter lets you to restrict a search to only videos that can be played outside youtube.com.
videoTypestringOptional
The videoType parameter lets you restrict a search to a particular type of videos.
keystringRequired
API key for authentication.
fieldsstringOptional
Selector specifying which fields to include in the response.
