Experiment with this API

Products

This endpoint returns all products available to the username used during authentication. As such, this endpoint requires the use of a fully authorized access_token. The product data can then be used as search filters, restricting results to images from a specific product.

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 return your Getty Image product listing:

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

To include your API token and a Bearer token to the header (example in curl):

-H "Api-Key: <your api key>"
-H "Authorization: Bearer <your-token>"

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/products

The response body will look like the following example:

{
    "products": [
        {
            "application_website": "",
            "credits_remaining": 0,
            "download_limit": 0,
            "download_limit_duration": "",
            "download_limit_reset_utc_date": "",
            "downloads_remaining": 0,
            "expiration_utc_date": "",
            "id": 0,
            "name": "",
            "status": "",
            "type": "",
            "download_requirements": {
                "is_note_required": false,
                "is_project_code_required": false,
                "project_codes": [
                    ""
                ]
            },
            "overage": {
                "limit": 0,
                "remaining": 0,
                "count": 0,
                "overages_reached": false
            },
            "agreement_name": ""
        }
    ]
}

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.

Querystring Parameters

fields array Comma separated list of fields. Allows product download requirements to be returned. Possible values: download_requirements

Response Body Fields

ProductsResult

products array [ product ] List of available Getty Images products.

product

application_website string URI of application website.
credits_remaining integer Specifies the remaining credit pack limit
download_limit integer Specifies the download limit for product or package.
download_limit_duration string Specifies the end date of current download limit.
download_limit_reset_utc_date string Specifies the date when download limit will reset, in ISO 8601 format (e.g., 1999-12-31T00:00:00-00:00).
downloads_remaining integer Specifies the remaining available downloads.
expiration_utc_date string Specifies the expiration date, in ISO 8601 format (e.g., 1999-12-31T00:00:00-00:00).
id integer Specifies the unique identifier for the product.
name string Specifies the name of Getty Images product.
status string Specifies if product status is active or inactive.
type string List of product types available. Possible values are: premiumaccess, easyaccess, editorialsubscription, imagepack, royaltyfreesubscription, creditpack.
download_requirements Specifies the download requirements a company can apply on its users.
overage Describes the current state of the download overage provision on a Premium Access agreement
agreement_name string Specifies the customer-defined name of the Premium Access agreement
imagepack_resolution string Indicates the resolution for the image pack. Possible values are: high, medium, low.

download_requirements

is_note_required boolean Indicates if users must enter a note on download.
is_project_code_required boolean Indicates if users must enter a product code on download.
project_codes array [ string ] Only users who have been set up with a project code by Getty Sales need to use this field.

overage

limit integer Maximum count of download overages allowed on a Premium Access agreement
remaining integer Count of remaining download overages available on a Premium Access agreement
count integer Count of download overages used to date on a Premium Access agreement
overages_reached boolean Specifies whether the download limit has been reached and download overages are being used on a Premium Access agreement

Response Status Codes

200 OK
400 InvalidParameterValue
401 Unauthorized
401 NoAgreement
401 AuthorizationTokenRequired