Details in batch

Get details of multiple tracks in one request.

In the request, tracks are identified by track id. There will be one track in the response for every corresponding valid id in the request, and the tracks will be in the same order as the requested ids. Tracks that are not valid for any reason are omitted from the tracks list in the response. They will be included in the errors list, in order, if showErrors is set true.

get/track/details/batch

Request

  • Base URL
    https://api.7digital.com/1.2
  • URL
    https://api.7digital.com/1.2/track/details/batch
  • Auth
    none required

Query parameters

trackIdsstring required

Contains a comma-separated list of track ids. Maximum of 500 items.

usageTypesstring required

Only use the usageTypes you need, e.g. download, subscriptionstreaming or adsupportedstreaming.

packageIdsstring

Contains a comma-separated list of package ids. When specified, only tracks that have one of the specified packages will be returned. Used to filter searches to tracks that have at least one high quality format. Package ids are listed here. <br><br>This parameter only takes effect when using 'usageTypes=download', and is otherwise ignored.

countrystring required

ISO 2-character code of the country the end user resides in.

showErrorsboolean

When set true, the errors element is shown in the output, containing a list of errors. There will be one error for each track that could not be shown in the tracks list. The itemId on the error shows which track it relates to. The code and message relates to the reason why the track could not be shown.

imageSizeinteger

The requested width of the image in pixels. Available image sizes are listed here.

Changes

No recorded changes to this operation across all 1 revision of this API.