videos
License videos
Changed onThis 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
Request
- Base URLhttps://api.shutterstock.com
- AuthOAuth 2Authorization codehttps://accounts.shutterstock.com/oauth/authorizeToken URLhttps://api.shutterstock.com/v2/oauth/access_tokenScopeslicenses.create, purchases.view
- TypeScriptA function with typed inputs. Its response is checked against the schema.
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
}Changes
- info
added the optional property
///to the response with the status - info
added the optional property
//to the response with the status
- info
- info
request property
//deprecated - info
added the optional property
//to the response with the status
- info