v1
latestOpenAPI 3.0.02026-07-131091452.6 MBvideos
License videos
This endpoint gets licenses for one or more videos. You must specify the video IDs in the body parameter and the size and subscription ID either in the query parameter or with each video ID in the body parameter. Values in the body parameter override values in the query parameters. The download links in the response are valid for 8 hours.
post/v2/videos/licenses
Query parameters
subscription_idstring
The subscription ID to use for licensing
size'web' | 'sd' | 'hd' | '4k'
The size of the video to license
search_idstring
The Search ID that led to this licensing event
Request body
Example request
{
"videos": [
{
"size": "hd",
"subscription_id": "s12345678",
"video_id": "2140697"
}
]
}Response
OK
Example response
{
"data": [
{
"allotment_charge": 1,
"download": {
"url": "https://download.shutterstock.com/gatekeeper/[random-characters]/shutterstock_59656357.mp4"
},
"price": {
"local_amount": 12.34,
"local_currency": "EUR"
},
"video_id": "123456789"
}
],
"page": 1,
"per_page": 5,
"total_count": 123455
}