Sponsors

  • This sponsors resource is deprecated as of March 31, 2020, and has been replaced by the member resource, with the sponsors.list method no longer supported after September 30, 2020.

  • A sponsor resource represents a YouTube channel member who provides recurring monetary support and receives special benefits.

  • The sponsors.list method allowed API clients to list the sponsors for a channel, but now they should use members.list instead.

  • The sponsors resource contains properties such as kind, etag, id, and snippet which includes detailed information like the channel ID, display name, profile image URL, and the date they became a sponsor.
Note: This resource is deprecated as of March 31, 2020. It has been replaced by the member resource. You can find information about that resource in the YouTube Data API documentation.

As part of this deprecation, the sponsors.list method will no longer be supported on or after September 30, 2020. API clients should update calls to the sponsors.list method to use the members.list method instead.

A sponsor resource represents a channel member (formerly known as a "sponsor") for a YouTube channel. A member provides recurring monetary support to a creator and receives special benefits. For example, members are able to chat when the creator turns on members-only mode for a chat.

Methods

The API supports the following methods for sponsors resources:

list
Lists sponsors for a channel. The API request must be authorized by the channel owner. Try it now.

Resource representation

The following JSON structure shows the format of a sponsors resource:

{
  "kind": "youtube#sponsor",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "sponsorDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "sponsorSince": datetime
  }
}

Properties

The following table defines the properties that appear in this resource:

Properties
kind string
Identifies the API resource's type. The value will be youtube#sponsor.
etag etag
The Etag of this resource.
id string
The ID that YouTube assigns to uniquely identify the sponsor.
snippet object
The snippet object contains details about the sponsor.
snippet.channelId string
This ID identifies the channel being sponsored.
snippet.sponsorDetails object
This object contains details about the sponsor.
snippet.sponsorDetails.channelId string
The YouTube channel ID.
snippet.sponsorDetails.channelUrl string
The channel's URL.
snippet.sponsorDetails.displayName string
The channel's display name.
snippet.sponsorDetails.profileImageUrl string
The channels's avatar URL.
snippet.sponsorSince datetime
The date and time when the user became a sponsor. The value is specified in ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) format.