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 Playlists API

Operations related to YouTube playlist resources

Youtube Playlists 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 Playlists. 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 6 operations across 2 paths, and defines 14 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.

6 operations 2 paths 14 schemas 2 DELETE1 GET1 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 Playlists 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 6

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

Playlists 6

Operations related to YouTube playlist resources

GET
/playlists
Youtube List Playlists
youtube.playlists.list 8 params → 200400401403
POST
/playlists
Youtube Create a Playlist
youtube.playlists.insert 3 params body → 200400401403
PUT
/playlists
Youtube Update a Playlist
youtube.playlists.update 3 params body → 200400401403
DELETE
/playlists
Youtube Delete a Playlist
youtube.playlists.delete 2 params → 204400401403404
PUT
/playlists/{playlistId}
Youtube Update Playlist
updatePlaylist 3 params body → 200404
DELETE
/playlists/{playlistId}
Youtube Delete Playlist
deletePlaylist 2 params → 204404

Schemas 14

The contract defines 14 schemas that model the data the API accepts and returns. The most detailed are Playlist (6 properties), PlaylistListResponse (6 properties), Playlist_2 (6 properties), PlaylistSnippet (6 properties). Each schema is shown below with its type and property counts.

Playlist_2
object
A YouTube playlist resource
6 properties 3 required
PlaylistUpdateRequest
object
Request body for updating a playlist
2 properties 2 required
ThumbnailDetails
object
Thumbnail images at various resolutions
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
ErrorDetails
object
Details about an API error
3 properties 2 required
ErrorResponse_2
object
Error response object
1 property 1 required
PlaylistSnippet
object
Basic information about the playlist
6 properties
PlaylistStatus
object
Status information for the playlist
1 property
PlaylistListResponse
object
A list of playlist resources matching the request criteria.
6 properties
Thumbnail
object
A thumbnail image
3 properties
ErrorItem
object
Individual error detail
5 properties
Playlist
object
A playlist resource represents a YouTube playlist.
6 properties 2 required
PlaylistContentDetails
object
Content details for the playlist
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

youtube-playlists-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