Sign in

v1

latestOpenAPI 3.0.02026-07-131091452.6 MB
images

License images

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. The download links in the response are valid for 8 hours.

post/v2/images/licenses

Query parameters

subscription_idstring

Subscription ID to use to license the image

format'eps' | 'jpg'

(Deprecated) Image format

size'small' | 'medium' | 'huge' | 'vector' | 'custom'

Image size

search_idstring

Search ID that was provided in the results of an image search

Request body

Example request

{
  "images": [
    {
      "editorial_acknowledgement": true,
      "format": "jpg",
      "image_id": "123456789",
      "metadata": {
        "customer_id": "12345",
        "geo_location": "US",
        "number_viewed": "15",
        "search_term": "dog"
      },
      "price": 12.34,
      "show_modal": true,
      "size": "small",
      "subscription_id": "s12345678"
    }
  ]
}

Response

OK

messagestring

Server-generated message, if any

pageinteger

Current page that is returned

per_pageinteger

Number of results per page

total_countinteger

Total count of all results across all pages

Example response

{
  "data": [
    {
      "image_id": "59656357",
      "download": {
        "url": "https://download.shutterstock.com/gatekeeper/[random-characters]/shutterstock_59656357.jpg"
      },
      "allotment_charge": 1
    }
  ],
  "page": 1,
  "per_page": 5,
  "total_count": 23
}