Search

Workflow

Make a request against the search endpoint with your query phrase

For the example below our Api-Key will be j878g39yx378pa77djthzzpn.

Search for images by Phrase

You can search through our images with your Api-Key.

Quick Things to Know

  • Protect your information: Do not post credentials against the endpoints without using SSL!

Curl Command:

curl -X GET -H "Api-Key: <YOUR_API_KEY>" https://api.gettyimages.com/v3/search/images/creative?phrase=kittens

JSFiddle Example

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"
        }
    ]
}