Getty Images API

by gettyimages.com

Overview

Build applications using the world's most powerful imagery

Getty Images is a photography API from gettyimages.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 52 endpoints.

At a glance

Authentication: OAuth
HTTPS: Yes
CORS: Unknown
Category: Photography
Version: 3
Endpoints: 52
OpenAPI: Specification ↗
Spec updated: 2023-03-06

Endpoints

Method	Path	What it does
GET	`/v3/affiliates/search/images`	—
GET	`/v3/affiliates/search/videos`	—
GET	`/v3/artists/images`	Search for images by a photographer
GET	`/v3/artists/videos`	Search for videos by a photographer
PUT	`/v3/asset-changes/change-sets`	Get asset change notifications.
DELETE	`/v3/asset-changes/change-sets/{change-set-id}`	Confirm asset change notifications.
GET	`/v3/asset-changes/channels`	Get a list of asset change notification channels.
POST	`/v3/asset-licensing/{assetId}`	Endpoint for acquiring extended licenses with iStock credits for an asset.
GET	`/v3/asset-management/assets/send-events`	—
GET	`/v3/boards`	Get all boards that the user participates in
POST	`/v3/boards`	Create a new board
GET	`/v3/boards/{board_id}`	Get assets and metadata for a specific board
PUT	`/v3/boards/{board_id}`	Update a board
DELETE	`/v3/boards/{board_id}`	Delete a board
PUT	`/v3/boards/{board_id}/assets`	Add assets to a board
DELETE	`/v3/boards/{board_id}/assets`	Remove assets from a board
PUT	`/v3/boards/{board_id}/assets/{asset_id}`	Add an asset to a board
DELETE	`/v3/boards/{board_id}/assets/{asset_id}`	Remove an asset from a board
GET	`/v3/boards/{board_id}/comments`	Get comments from a board
POST	`/v3/boards/{board_id}/comments`	Add a comment to a board
DELETE	`/v3/boards/{board_id}/comments/{comment_id}`	Delete a comment from a board
GET	`/v3/collections`	Gets collections applicable for the customer.
GET	`/v3/countries`	Gets countries codes and names.
GET	`/v3/customers/current`	Returns information about the current user.
GET	`/v3/downloads`	Returns information about a customer's downloaded assets.
POST	`/v3/downloads/images/{id}`	Download an image
POST	`/v3/downloads/videos/{id}`	Download a video
GET	`/v3/events`	Get metadata for multiple events
GET	`/v3/events/{id}`	Get metadata for a single event
GET	`/v3/images`	Get metadata for multiple images by supplying multiple image ids
GET	`/v3/images/{id}`	Get metadata for a single image by supplying one image id
GET	`/v3/images/{id}/downloadhistory`	Returns information about a customer's download history for a specific asset
GET	`/v3/images/{id}/same-series`	Retrieve creative images from the same series
GET	`/v3/images/{id}/similar`	Retrieve similar images
GET	`/v3/orders/{id}`	Get order metadata
GET	`/v3/products`	Get Products
GET	`/v3/purchased-assets`	Get Previously Purchased Images and Video
PUT	`/v3/search/by-image/uploads/{file-name}`	Upload image for use by the search creative images/videos operations
GET	`/v3/search/events`	Search for events
GET	`/v3/search/images`	Search for both creative and editorial images - * DEPRECATED *
GET	`/v3/search/images/creative`	Search for creative images only
GET	`/v3/search/images/creative/by-image`	Search for creative images based on url
GET	`/v3/search/images/editorial`	Search for editorial images only
GET	`/v3/search/videos/creative`	Search for creative videos
GET	`/v3/search/videos/creative/by-image`	Search for creative videos based on url
GET	`/v3/search/videos/editorial`	Search for editorial videos
PUT	`/v3/usage-batches/{id}`	Report usage of assets via a batch format.
GET	`/v3/videos`	Get metadata for multiple videos by supplying multiple video ids
GET	`/v3/videos/{id}`	Get metadata for a single video by supplying one video id
GET	`/v3/videos/{id}/downloadhistory`	Returns information about a customer's download history for a specific asset
GET	`/v3/videos/{id}/same-series`	Retrieve creative videos from the same series
GET	`/v3/videos/{id}/similar`	Retrieve similar videos

Questions

Does the Getty Images API need an API key?

Yes. The Getty Images API uses OAuth authentication; the documentation explains how to get credentials.

Does the Getty Images API support HTTPS?

Yes, the Getty Images API is served over HTTPS.

How many endpoints does the Getty Images API have?

Its OpenAPI description lists 52 endpoints in version 3. All of them are shown on this page.

What are alternatives to the Getty Images API?

Other Photography APIs include Giphy, Remove.bg, Unsplash, Imgur, shutterstock.

Compare alternatives →

Giphy

Photography

The GIPHY Developer Portal is how you integrate the world's best GIF API into your business, app or project.

API key10 endpoints

Remove.bg

Photography

Image Background removal

API key3 endpoints

Unsplash

Photography

Create with the largest collection of high-quality images that are free to use. Trusted by Trello, Medium, and thousands of other API applications to power their free picture needs.

OAuth

Imgur

Photography

## API Status Status for the API can be found at [status.imgur.com](http://status.imgur.com)! ## Getting Started Imgur's API exposes the entire Imgur infrastructure via a standardized programmatic interface. Using Imgur's API, you can do just about anything you can do on imgur.com, while using your programming language of choice. The Imgur API is a RESTful API based on HTTP requests and JSON respo

OAuth