Details in batch

get

https://api.7digital.com/1.2/track/details/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.

Query Params

trackIds

string

required

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

usageTypes

string

required

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

packageIds

string

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.

This parameter only takes effect when using 'usageTypes=download', and is otherwise ignored.

country

string

required

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

showErrors

boolean

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.

imageSize

int32

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

Language

Loading…