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 Playlist Items API

Operations for managing items within playlists

Youtube Playlist Items 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 Playlist Items. 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 3 operations across 2 paths, and defines 12 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.

3 operations 2 paths 12 schemas 1 DELETE1 GET1 POST

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 Playlist Items 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 3

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

Playlist Items 3

Operations for managing items within playlists

GET
/playlistItems
Youtube List Playlist Items
listPlaylistItems 6 params → 200404
POST
/playlistItems
Youtube Add Item to Playlist
insertPlaylistItem 2 params body → 200400
DELETE
/playlistItems/{playlistItemId}
Youtube Remove Item from Playlist
deletePlaylistItem 2 params → 204404

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are PlaylistItemSnippet (9 properties), ThumbnailDetails (5 properties), ErrorItem (5 properties), PlaylistItemListResponse (5 properties). Each schema is shown below with its type and property counts.

ThumbnailDetails
object
Thumbnail images at various resolutions
5 properties
PlaylistItemListResponse
object
Response containing playlist item resources
5 properties 3 required
PlaylistItemSnippet
object
Basic information about the playlist item
9 properties
PlaylistItemContentDetails
object
Content details for the playlist item
2 properties
PageInfo
object
Pagination information
2 properties
ErrorResponse
object
Error response object
1 property 1 required
ErrorDetails
object
Details about an API error
3 properties 2 required
ResourceId
object
Identifies the resource in the search result
4 properties 1 required
Thumbnail
object
A thumbnail image
3 properties
ErrorItem
object
Individual error detail
5 properties
PlaylistItemInsertRequest
object
Request body for adding an item to a playlist
1 property 1 required
PlaylistItem
object
A playlist item resource
5 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

youtube-playlist-items-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