License videos

POST https://api.shutterstock.com/v2/videos/licenses
Parameters
Name Type Description
subscription_id string Default subscription ID.
size string Default video size. Supports: web, sd, hd, 4k. Default: web.
search_id string Default search ID.
Response Codes
  • 200 OK
  • 400 Bad Request
Required Scopes
  • customer: licenses.create
Example Request
POST https://api.shutterstock.com/v2/videos/licenses?subscription_id=s19905398
Example Request Body
{
  "videos": [
    {
      "video_id": "4535879",
      "metadata": {
        "job": "job1",
        "client": "client2",
        "other": "other3",
        "purchase_order": "purchase_order4"
      }
    }
  ]
}
Request {
videos (LicenseVideo[], maximum: 50): Videos to license
}
LicenseVideo {
video_id (string),
size (string, optional, enum: web, sd, hd, 4k),
subscription_id (string, optional),
auth_cookie (Cookie, optional),
editorial_acknowledgement (boolean, optional),
metadata (object, optional),
price (number, optional): Retail price amount, (for rev-share partners only),
show_modal (boolean, optional),
search_id (string, optional)
}
Cookie {
name (string),
value (string)
}
Example Response
{
  "data": [
    {
      "video_id": "4535879",
      "download": {
        "url": "http://download.shutterstock.com/gatekeeper/abc/original.mov"
      },
      "allotment_charge": 1
    }
  ]
}
Response {
data (LicenseVideoResult[], optional),
page (integer, optional),
per_page (integer, optional),
total_count (integer, optional),
message (string, optional),
errors (Error[], optional)
}
LicenseVideoResult {
video_id (string),
allotment_charge (integer, optional),
download (Url, optional),
price (Price, optional): Wholesale price information, (for rev-share partners only),
error (string, optional)
}
Error {
code (string, optional),
data (string, optional),
message (string),
path (string, optional),
items (object[], optional)
}
Url {
url (string)
}
Price {
local_amount (number, optional),
local_currency (string, optional)
}