Experiment with this API

Get Collections

Use this endpoint to retrieve collections associated with your Getty Images account. To browse available collections see our Image collections page.

Quickstart

You'll need an API key and access token to use this resource. Please see our Getting Started page for more information on how to sign up for an API key. There are several SDKs available for popular programming languages to help you get started.

Use the following endpoint to search for videos:

GET https://api.gettyimages.com/v3/collections

Add your API key to the request header:

Api-Key: <your api key>

Your request would look like this using curl:

curl -X GET -H "Api-Key: <your api key>" -H "Authorization: Bearer <your-token>" https://api.gettyimages.com/v3/collections

The response body will look like the following example:

{
  "collections": [
    {
      "asset_family": "",
      "code": "",
      "id": 0,
      "license_model": "",
      "name": "",
      "product_types": [
        ""
      ]
    }
  ]
}

Request Headers

Api-Key string Provide your API key. Required.
Authorization string Provide access token in the format of 'Bearer {token}'. Required.
Accept-Language string Specifies the language of result values.

Response Body Fields

collections

collections array [ collection ] List of collections that belongs to the client.

collection

asset_family string Indicates the asset family classification. Possible values are: creative, editorial.
code string Specifies the code of the collection.
id integer Specifies the unique identifier for the collection.
license_model string Specifies the licensing model for the asset. Possible values are: royaltyfree, rightsmanaged, rightsready.
name string Specifies the name of the collection.
product_types array [ string ] Specifies the license agreements applied to this collection. Possible values are: premiumaccess, easyaccess, editorialsubscription, imagepack, royaltyfreesubscription, creditpack.

Response Status Codes

200 OK
401 Unauthorized