Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Youtube Videos API

Operations related to YouTube video resources

Youtube Videos API is one of 36 APIs that Youtube publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Videos. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, authentication docs, an API reference, code examples, and 2 JSON Schemas.

This API exposes 7 operations across 3 paths, and defines 20 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

Requests are made against a single base URL, https://youtubeanalytics.googleapis.com/v2.

7 operations 3 paths 20 schemas 2 DELETE1 GET2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://www.googleapis.com/youtube/v3
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

Youtube Videos API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 4 scopes. By default, every request must be authenticated.

  • OAuth2 — OAuth 2.0 authentication for YouTube Analytics API

Paths & Operations 7

Across 3 paths, the API surfaces 7 operations — 2 DELETE, 1 GET, 2 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Videos 7

Operations related to YouTube video resources

GET
/videos
Youtube List Videos
youtube.videos.list 8 params → 200400401403
POST
/videos
Youtube Upload or Insert a Video
youtube.videos.insert 3 params body → 200400401403
PUT
/videos
Youtube Update Video Metadata
youtube.videos.update 3 params body → 200400401403
DELETE
/videos
Youtube Delete a Video
youtube.videos.delete 2 params → 204400401403404
POST
/videos/rate
Youtube Rate a Video
youtube.videos.rate 3 params → 204400401403
PUT
/videos/{videoId}
Youtube Update Video Metadata
updateVideo 3 params body → 200404
DELETE
/videos/{videoId}
Youtube Delete Video
deleteVideo 2 params → 204404

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are VideoSnippet (11 properties), Video (9 properties), VideoSnippet_2 (9 properties), Video_2 (7 properties). Each schema is shown below with its type and property counts.

VideoContentDetails
object
Information about the video content, including the length of the video and an indication of whether captions are available.
6 properties
ThumbnailDetails
object
Thumbnail images at various resolutions
5 properties
VideoUpdateRequest
object
Request body for updating a video
2 properties 2 required
VideoStatistics_2
object
Statistics for the video
5 properties
VideoSnippet_2
object
Basic information about the video
9 properties
Video
object
A video resource represents a YouTube video.
9 properties 2 required
VideoContentDetails_2
object
Content details for the video
5 properties
PageInfo
object
Paging details for a list operation, including information about the total number of resources and the number per page.
2 properties
ErrorResponse
object
A standard error response returned by the YouTube Data API.
1 property
VideoPlayer
object
Information used to play the video.
3 properties
ErrorDetails
object
Details about an API error
3 properties 2 required
ErrorResponse_2
object
Error response object
1 property 1 required
Video_2
object
A YouTube video resource
7 properties 3 required
VideoStatus
object
The status of an uploaded video.
6 properties
VideoListResponse
object
A list of video resources matching the request criteria.
6 properties
VideoStatus_2
object
Status information for the video
5 properties
VideoSnippet
object
Basic details about a video, including its title, description, tags, and category.
11 properties
Thumbnail
object
A thumbnail image
3 properties
ErrorItem
object
Individual error detail
5 properties
VideoStatistics
object
Statistics about the video such as the number of times the video has been viewed or liked.
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

youtube-videos-api-openapi.yml Raw ↑

Other APIs Youtube publishes across the network.

Youtube Channel Sections API
Youtube Channel Banners API
Youtube Members API
Youtube Memberships Levels API
Youtube Thumbnails API
Youtube Watermarks API
Youtube Video Abuse Report Reasons API
YouTube IFrame Player API
YouTube Subscribe Button
Youtube Playlist Images API
YouTube Content ID API
YouTube oEmbed API