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

Operations related to YouTube channel subscriptions

Youtube Subscriptions 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 Subscriptions. 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 4 operations across 2 paths, and defines 7 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.

4 operations 2 paths 7 schemas 2 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 Subscriptions 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 4

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

Subscriptions 4

Operations related to YouTube channel subscriptions

GET
/subscriptions
Youtube List Subscriptions
youtube.subscriptions.list 8 params → 200400401403
POST
/subscriptions
Youtube Subscribe to a Channel
youtube.subscriptions.insert 3 params body → 200400401403
DELETE
/subscriptions
Youtube Unsubscribe From a Channel
youtube.subscriptions.delete 2 params → 204400401403404
DELETE
/subscriptions/{subscriptionId}
Youtube Unsubscribe from Channel
deleteSubscription 2 params → 204404

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are SubscriptionListResponse (6 properties), ErrorItem (5 properties), Subscription (4 properties), ErrorDetails (3 properties). Each schema is shown below with its type and property counts.

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
SubscriptionListResponse
object
A list of subscription resources matching the request criteria.
6 properties
ErrorItem
object
Individual error detail
5 properties
Subscription
object
A subscription resource contains information about a YouTube user's subscription to a channel.
4 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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