Search
Workflow
Make a request against the search endpoint with a search phrase. The search can be performed with or without an access token. To get an access token, see our authorization documentation.
Search for images by phrase
Search for images using your Api-Key and a search phrase.
Curl command:
curl -X GET -H "Api-Key: <YOUR_API_KEY>" "https://api.gettyimages.com/v3/search/images/creative?phrase=kittens"
Curl command with access token:
curl -X GET -H "Api-Key: <YOUR_API_KEY>" -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" "https://api.gettyimages.com/v3/search/images/creative?phrase=kittens"
Example response:
{
"result_count": 61906,
"images": [
{
"id": "1199241887",
"asset_family": "creative",
"caption": "Cute tabby kitten stealing cream from a cup on the breakfast table",
"collection_code": "DV",
"collection_id": 13,
"collection_name": "DigitalVision",
"display_sizes": [
{
"is_watermarked": false,
"name": "thumb",
"uri": "https://media.gettyimages.com/photos/kitten-drinking-from-a-cup-picture-id1199241887?b=1&k=6&m=1199241887&s=170x170&h=0oucmO6iNsDJJNLx61Xy-_dK1kIard4mWQmfVIxCQpQ="
}
],
"license_model": "royaltyfree",
"max_dimensions": {
"height": 4480,
"width": 6720
},
"title": "Kitten drinking from a cup"
},
{
"id": "1175346404",
"asset_family": "creative",
"caption": "Close up to a 4 weeks old kitten, playing on a blue blanket at bed.",
"collection_code": "FKF",
"collection_id": 348,
"collection_name": "Moment",
"display_sizes": [
{
"is_watermarked": false,
"name": "thumb",
"uri": "https://media.gettyimages.com/photos/four-weeks-old-kitten-posing-on-a-bed-picture-id1175346404?b=1&k=6&m=1175346404&s=170x170&h=RdGmg0HNBhlXMAZVS52doa17WubNELijP9pEOm3t5cw="
}
],
"license_model": "royaltyfree",
"max_dimensions": {
"height": 3376,
"width": 6000
},
"title": "Four Weeks Old Kitten Posing on a Bed"
}
]
}