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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: