License videos
POST {{baseUrl}}/v2/videos/licenses
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.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
subscription_id | string | The subscription ID to use for licensing | |
size | string | The size of the video to license | |
search_id | string | The Search ID that led to this licensing event |
Request Body
{"videos"=>[{"video_id"=>"<string>", "auth_cookie"=>{"name"=>"<string>", "value"=>"<string>"}, "editorial_acknowledgement"=>"<boolean>", "metadata"=>{}, "price"=>"<number>", "search_id"=>"<string>", "show_modal"=>"<boolean>", "size"=>"<string>", "subscription_id"=>"<string>"}, {"video_id"=>"<string>", "auth_cookie"=>{"name"=>"<string>", "value"=>"<string>"}, "editorial_acknowledgement"=>"<boolean>", "metadata"=>{}, "price"=>"<number>", "search_id"=>"<string>", "show_modal"=>"<boolean>", "size"=>"<string>", "subscription_id"=>"<string>"}]}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
User-Agent | string |
RESPONSES
status: OK
{"data":[{"video_id":"2140697","download":{"url":"https://download.shutterstock.com/gatekeeper/W3siZSI6MTQ5NzAyNjU1MiwiayI6InZpZGVvLzIxNDA2OTcvc2QubW92IiwibSI6IjEiLCJkIjoic2h1dHRlcnN0b2NrLW1lZGlhIn0sInVsOFY1dElzb3lWZHNxb3JyWlJjS1dyb016TSJd/shutterstock_v2140697.mov"},"allotment_charge":1}]}