SHshutterstock
audio

License audio tracks

Changed on

This endpoint gets licenses for one or more tracks. The download links in the response are valid for 8 hours.

post/v2/audio/licenses

Request

Query parameters

license'audio_platform' | 'premier_music_basic' | 'premier_music_extended' | 'premier_music_pro' | 'premier_music_comp' | 'asset_all_music'

License type

search_idstring

The ID of the search that led to licensing this track

Request body

Example request

{
  "audio": [
    {
      "audio_id": "591623",
      "license": "audio_platform",
      "metadata": {
        "customer_id": "12345"
      }
    }
  ]
}

Response

OK

messagestring

Server-generated message, if any

pageinteger

Current page that is returned

per_pageinteger

Number of results per page

total_countinteger

Total count of all results across all pages

Example response

{
  "data": [
    {
      "audio_id": "123456789",
      "download": {
        "url": "http://download2.dev.shutterstock.com/gatekeeper/abc/original.wav"
      },
      "license_id": "abcdef123456789ghijklmn",
      "allotment_charge": 1
    }
  ]
}

Changes

  • b43cab3aaaaaRevision changes
    • breaking

      added the pattern ^[1-9]\d*$ to the request property //

    • info

      added the optional property // to the response with the status

  • d2e03e7f655dRevision changes
    • info

      added the new enum value asset_all_music to the query request parameter license

    • info

      added the new asset_all_music enum value to the request property //

    • info

      added the optional property // to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property // to the response with the status