Sponsors

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.