License images
POST {{baseUrl}}/v2/images/licenses
This endpoint gets licenses for one or more images. You must specify the image IDs in the body parameter and other details like the format, size, and subscription ID either in the query parameter or with each image 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 | Subscription ID to use to license the image | |
format | string | Image format | |
size | string | Image size | |
search_id | string | Search ID that was provided in the results of an image search |
Request Body
{"images"=>[{"image_id"=>"<string>", "auth_cookie"=>{"name"=>"<string>", "value"=>"<string>"}, "editorial_acknowledgement"=>"<boolean>", "format"=>"<string>", "metadata"=>{}, "price"=>"<number>", "search_id"=>"<string>", "show_modal"=>"<boolean>", "size"=>"<string>", "custom_dimensions"=>{"height"=>"<integer>", "width"=>"<integer>"}, "subscription_id"=>"<string>", "verification_code"=>"<string>"}, {"image_id"=>"<string>", "auth_cookie"=>{"name"=>"<string>", "value"=>"<string>"}, "editorial_acknowledgement"=>"<boolean>", "format"=>"<string>", "metadata"=>{}, "price"=>"<number>", "search_id"=>"<string>", "show_modal"=>"<boolean>", "size"=>"<string>", "custom_dimensions"=>{"height"=>"<integer>", "width"=>"<integer>"}, "subscription_id"=>"<string>", "verification_code"=>"<string>"}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
User-Agent | string |
RESPONSES
status: OK
{"data":[{"image_id":"547233985","download":{"url":"https://download.shutterstock.com/gatekeeper/[random-characters]/shutterstock_547233985.jpg"},"allotment_charge":1}]}