Method: musicReleases.list

  • This API endpoint retrieves a list of music releases via an HTTP GET request to https://youtubepartner.googleapis.com/youtube/partner/v1/music/releases.

  • You can use query parameters like pageSize, pageToken, onBehalfOfContentOwner, and filter to control the number of results, paginate through them, and filter them.

  • The response body includes an array of music release objects (releases) and a nextPageToken for retrieving subsequent pages of results, if available.

  • The ReleaseFilter parameter allows for specific filtering of music releases by UPC, title, artist name, and whether there are open or closed change requests.

  • Accessing this endpoint requires authorization with the https://www.googleapis.com/auth/youtubepartner OAuth scope.

Retrieves a list of music releases.

HTTP request

GET https://youtubepartner.googleapis.com/youtube/partner/v1/music/releases

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
pageSize

integer

The maximum number of releases to return. The service may return fewer than this value. If unspecified, at most 30 releases will be returned. The maximum value is 50; values above 50 will be coerced to 50.
pageToken

string

A page token, received from a previous musicReleases.list call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to musicReleases.list must match the call that provided the page token.
onBehalfOfContentOwner

string

Identifies the content owner that the user is acting on behalf of. This parameter supports users whose accounts are associated with multiple content owners.
filter

object (ReleaseFilter)

Filtering based on various parameters in musicReleases.list.

Request body

The request body must be empty.

Response body

A response to list music releases.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "releases": [
    {
      object (MusicRelease)
    }
  ],
  "nextPageToken": string
}
Fields
releases[]

object (MusicRelease)

The requested music releases.
nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/youtubepartner

For more information, see the OAuth 2.0 Overview.

ReleaseFilter

Representation of an expression for filtering in musicReleases.list. We always take the conjunction (logical AND) of the filters, so a release must meet all criteria to be returned.

JSON representation 
{
  "upcs": [
    string
  ],
  "titleMatches": string,
  "artistNameMatches": string,
  "hasOpenChangeRequest": boolean,
  "hasClosedChangeRequest": boolean
}
Fields
upcs[]

string

A list of case insensitive UPCs of the releases to be retrieved.
titleMatches

string

Tokenized search (case insensitive).
artistNameMatches

string

Tokenized search (case insensitive).
hasOpenChangeRequest

boolean

At least one ChangeRequest in open status.
hasClosedChangeRequest

boolean

At least one ChangeRequest in closed status.