Release Notes

2018-08-30 - Updates to the site

We have transitioned our API management provider from Mashery to AWS. This change allows us to more quickly update our APIs and takes advantage of the scale of service that comes from with working with AWS. As such, we've made some updates to this site, removing certain sections that were operated by Mashery.

  • Forums - we now have a Status page where we'll post updates during service interruptions. And this Release Notes page will be kept updated with notes on all the cool new functionality we're making availabile.
  • Sign in and Account pages - if you need to retrieve your keys/secrets, please email us at
  • Contact - all Contact links now point to the Contact page on

We've also cleaned up the Docs section, removing several outdated pages. The API Documentation link now points to our Open API (Swagger) page. This is a more useful tool than the previous documentation - it provides the same info and has the added benefit of letting you actually try the API directly in the documentation.

As always, let us know if you have any questions.

2018-08-08 - NEW: istock_collection metadata field

We've added a new metadata field called "istock_collection" to the following endpoints. This field, with values of "essentials" or "signature", will tell you which iStock collection an iStock image is from. Customers with access to the iStock collection (collection code SKP) via their Getty API key (as opposed to an iStock API key) may find this useful as a way of further categorizing iStock images beyond their Getty collection.

  • GET /v3/search/images/creative
  • GET /v3/search/images/creative/by-image
  • GET /v3/search/videos/creative
  • GET /v3/images
  • GET /v3/images/{id}
  • GET /v3/images/{id}/similar
  • GET /v3/videos
  • GET /v3/videos/{id}
  • GET /v3/videos/{id}/similar

2018-07-15 - NEW: exclude vectors from image search results

A common feature request from many partners is to be able to filter an image search so that vector art is excluded from image search results. Imagine you're a business that prints photos for large scale wall installations. The last thing you want is for goofy little icon sets to show up in your customer's searches.

To accomplish this, we've added two things: a value of "vector" to the existing graphical_styles parameter and a new parameter called graphical_styles_filter_type with values of "include" and "exclude". Here's how you would exclude vector art from your search request:

This functionality is available in the following endpoints:

  • GET /v3/search/images
  • GET /v3/search/images/creative
  • GET /v3/search/images/editorial

Setting the graphical_styles_filter_type to "include" is the same as not using the filter.

2018-03-30 - New functionality: download with iStock Team Credits

This week, we released an update that lets iStock users download images using their iStock Team Credits.

First, the /products response now provides you with the number of team credits held by the authenticated iStock user via the "team_credits" field. Here's an example. Note that "credits_remaining" indicates the number of personal credits held by the user.

  "products": [
      "application_website": "iStockPhoto",
      "credits_remaining": 62,
      "download_limit": null,
      "download_limit_duration": null,
      "download_limit_reset_utc_date": null,
      "downloads_remaining": null,
      "expiration_utc_date": null,
      "id": 0,
      "name": null,
      "status": "active",
      "type": "creditpack",
      "agreement_name": null,
      "imagepack_resolution": null,
      "team_credits": 4

Second, the /downloads/images/{id} and /downloads/videos/{id} requests now have a "use_team_credits" parameter that, when set to "true", will use team credits to download the specified image. Setting the value to "false" or excluding the parameter entirely will download the image with the user's personal credits. Example request:

2018-02-19 - New functionality: Search By Image

You may have noticed that our sites ( and have functionality that allows you search for images by uploading your own photo to receive results of similar content from our catalog of creative images.

Well... I have good news for all you Getty Images API fanatics! This same functionality is now available in our API! Load an image to our AWS S3 bucket, receive a URL, then use that URL as the search parameter in your request to /v3/search/images/creative-by-image.

The uses for this functionality are endless... let your users take a photo and then find similar images from the pool of creative content in your license agreement. Find a photo of some tasty donuts online, see what we have in our catalog that's equally delicious. Tired of using the same stock photo of business people shaking hands? See what other agreeable professionals are lurking in our library! Insider tip: there's a lot and they're happily takin' care of Business.

Try it on Swagger