If you specify a value for this parameter, you must also set the type parameter's value to video. The eventType parameter restricts a search to broadcast events. The channelType parameter lets you restrict a search to a particular type of channel. Note: Search results are constrained to a maximum of 500 videos if your request specifies a value for the channelId parameter and sets the type parameter value to video, but it does not also set one of the forContentOwner, forDeveloper, or forMine filters. The channelId parameter indicates that the API response should only contain resources created by the channel. Note that if the relatedToVideoId parameter is set, the only other supported parameters are part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (which must be set to video), and fields. The parameter value must be set to a YouTube video ID and, if you are using this parameter, the type parameter must be set to video. The relatedToVideoId parameter retrieves a list of videos that are related to the video that the parameter value identifies. In addition, none of the following other parameters can be set in the same request: videoDefinition, videoDimension, videoDuration, videoLicense, videoEmbeddable, videoSyndicated, videoType. If you set this parameter to true, then the type parameter's value must also be set to video. The forMine parameter restricts the search to only retrieve videos owned by the authenticated user. This parameter can only be used in a properly authorized request. Therefore, a developer can restrict results to videos uploaded through the developer's own app or website but not to videos uploaded through other apps or sites. When a search request subsequently sets the forDeveloper parameter to true, the API server uses the request's authorization credentials to identify the developer. The forDeveloper parameter can be used in conjunction with optional search parameters like the q parameter.įor this feature, each uploaded video is automatically tagged with the project number that is associated with the developer's application in the Google Developers Console. The API server uses the request's authorization credentials to identify the developer. The forDeveloper parameter restricts the search to only retrieve videos uploaded via the developer's application or website.
The forContentOwner parameter restricts the search to only retrieve videos owned by the content owner identified by the onBehalfOfContentOwner parameter. This parameter can only be used in a properly authorized request, and it is intended exclusively for YouTube content partners. Set the parameter value to snippet.įilters (specify 0 or 1 of the following parameters) The part parameter specifies a comma-separated list of one or more search resource properties that the API response will include. All of the parameters listed are query parameters. The following table lists the parameters that this query supports. Common use cases Request HTTP request GET Parameters Quota impact: A call to this method has a quota cost of 100 units. By default, a search result set identifies matching video, channel, and playlist resources, but you can also configure queries to only retrieve a specific type of resource. Returns a collection of search results that match the query parameters specified in the API request.