MAmassivemusic

Details in batch

Get details of multiple releases in one request.

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

get/release/details/batch

Request

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

Query parameters

releaseidsstring required

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

packageIdsstring

Contains a comma-separated list of package ids. When specified, only releases that have one of the specified packages will be returned. Used to filter searches to releases 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 release that could not be shown in the releases list. The Itemid on the error shows which release it relates to. The code and message relates to the reason why the release could not be shown.

usageTypesstring required

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

typestring

When set, only releases with the matching type value ("Album" or "single") will be returned. If not set, then all will be returned.

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.