The videoCategoryId parameter filters video search results based on
their category. 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. If
you specify a value for this parameter, you must also set the
type parameter's value to video.
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. 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.
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. If you set this parameter to true, then the
type parameter's value must also be set to video. In addition, none of
the following other parameters can be set in the same request:
videoDefinition, videoDimension, videoDuration, videoLicense,
videoEmbeddable, videoSyndicated, videoType.
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. The parameter value is a string that specifies
latitude/longitude coordinates e.g. (37.42307,-122.08427).
The maxResults parameter specifies the maximum number of items that
should be returned in the result set. Acceptable values are 0 to 50,
inclusive. The default value is 5.
The pageToken parameter identifies a specific page in the result set
that should be returned. In an API response, the nextPageToken and
prevPageToken properties identify other pages that could be retrieved.
The publishedAfter parameter indicates that the API response should
only contain resources created at or after the specified time. The value
is an RFC 3339 formatted date-time value (1970-01-01T00:00:00Z).
The publishedBefore parameter indicates that the API response should
only contain resources created before or at the specified time. The value
is an RFC 3339 formatted date-time value (1970-01-01T00:00:00Z).
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.
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. However, you
should use the values zh-Hans for simplified Chinese and zh-Hant for
traditional Chinese. Please note that results in other languages will
still be returned if they are highly relevant to the search query term.
The topicId parameter indicates that the API response should only
contain resources associated with the specified topic. The value
identifies a Freebase topic ID.
The type parameter restricts a search query to only retrieve a
particular type of resource. The value is a comma-separated list of
resource types. The default value is video,channel,playlist.
The videoCaption parameter indicates whether the API should filter
video search results based on whether they have captions. If you specify a
value for this parameter, you must also set the [type](#type) parameter's
value to video.
The videoDefinition parameter lets you restrict a search to only
include either high definition (HD) or standard definition (SD) videos. HD
videos are available for playback in at least 720p, though higher
resolutions, like 1080p, might also be available. If you specify a value for
this parameter, you must also set the type parameter's value to
video.
The videoDimension parameter lets you restrict a search to only retrieve 2D
or 3D videos. If you specify a value for this parameter, you must also set
the type parameter's value to video.
The videoDuration parameter filters video search results based on
their duration. If you specify a value for this parameter, you must also set
the type parameter's value to video.
The videoEmbeddable parameter lets you to restrict a search to only videos
that can be embedded into a webpage. If you specify a value for this
parameter, you must also set the type parameter's value to
video.
The videoLicense parameter filters search results to only include videos
with a particular license. YouTube lets video uploaders choose to attach
either the Creative Commons license or the standard YouTube license to each
of their videos. If you specify a value for this parameter, you must also
set the type parameter's value to video.
The videoSyndicated parameter lets you to restrict a search to only videos
that can be played outside youtube.com. If you specify a value for this
parameter, you must also set the type parameter's value to
video.
The videoType parameter lets you restrict a search to a particular
type of videos. If you specify a value for this parameter, you must also set
the type parameter's value to video.