Getting Started
Workflow Steps
Get Access Token
In order to get download links from search you will need to use a Resource Owner Request as used in the example below
Request
curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d 'grant_type=password&client_id=exampleApiKey&client_secret=exampleSecret&username=someUsername&password=WithSomePassword' https://api.gettyimages.com/oauth2/token
Response
{
"access_token": "123456",
"token_type": "Bearer",
"expires_in": "1800"
}
Search For Images with Largest Downloads field specified
Request
curl -X GET -H "Authorization: Bearer 123456" -H "Api-Key: exampleApiKey" https://api.gettyimages.com/v3/search/images?phrase=Kitties&fields=largest_downloads
Response
{
"result_count": 3662,
"images": [
{
"id": "83454804",
"largest_downloads": [
{
"product_type": "easyaccess",
"uri": "https://api.gettyimages.com/v3/downloads/images/83454804"
}
]
},
{
"id": "103131833",
"largest_downloads": [
{
"product_type": "editorialsubscription",
"uri": "https://api.gettyimages.com/v3/downloads/images/103131833"
}
]
}
]
}
Download the image using its asset id and product type
The largest_downloads array for each image in the response above gives a URI to be used to download the image, as well as the product for which you are authorized to download. To download the image file, create a POST request to the URI and indicate the product_type as a query string parameter as in the example below. The default response to that request is to return the URI where you can download the actual image. If you also set an auto_download parameter to true
, this will execute a 302 redirect which automatically downloads the image file.
Request
curl -X POST -H "Api-Key: exampleApiKey" -H "Authorization: Bearer 123456" -d '' https://api.gettyimages.com/v3/downloads/images/83454804?auto_download=false&product_type=easyaccess
Response
{
"uri": "https://delivery.gettyimages.com/xa/83454804.jpg?....."
}