Getty Images, an HTTP API described by an OpenAPI document.
Every row below was read from the vendor's own OpenAPI document. The summary text is theirs. What this registry adds is that each operation is indexed with its method, path, base URL and auth scheme, so a search for a capability can answer with a call rather than a name, and that the endpoint is probed on a schedule.
Specifications as held by the APIs.guru corpus, whose newest record is 2023-04-21. Operations the vendor has added since are not listed here; the origin links above are the vendor's own current documents.
auth: a p i k e y
find it by capability: POST /search {"query":{"text":"..."}} returns these
operations with their invocation detail. Connect any agent client.
Getty Images, an HTTP API described by an OpenAPI document.
| method | path | what the vendor says it does |
|---|---|---|
GET | /v3/artists/images | Search for images by a photographer Artists |
GET | /v3/artists/videos | Search for videos by a photographer Artists |
PUT | /v3/asset-changes/change-sets | Get asset change notifications. # Asset Changes Get notifications about new, updated or deleted assets for a |
DELETE | /v3/asset-changes/change-sets/{change-set-id} | Confirm asset change notifications. # Delete Asset Changes Confirm asset changes acknowledges receipt of asse |
GET | /v3/asset-changes/channels | Get a list of asset change notification channels. # Get Partner Channels Retrieves the channel data for the p |
POST | /v3/asset-licensing/{assetId} | Endpoint for acquiring extended licenses with iStock credits for an asset. AssetLicensing |
GET | /v3/boards | Get all boards that the user participates in Boards |
POST | /v3/boards | Create a new board Boards |
GET | /v3/boards/{board_id} | Get assets and metadata for a specific board Boards |
PUT | /v3/boards/{board_id} | Update a board Boards |
DELETE | /v3/boards/{board_id} | Delete a board Boards |
PUT | /v3/boards/{board_id}/assets | Add assets to a board Boards |
DELETE | /v3/boards/{board_id}/assets | Remove assets from a board Boards |
PUT | /v3/boards/{board_id}/assets/{asset_id} | Add an asset to a board Boards |
DELETE | /v3/boards/{board_id}/assets/{asset_id} | Remove an asset from a board Boards |
GET | /v3/boards/{board_id}/comments | Get comments from a board Boards |
POST | /v3/boards/{board_id}/comments | Add a comment to a board Boards |
DELETE | /v3/boards/{board_id}/comments/{comment_id} | Delete a comment from a board Boards |
GET | /v3/collections | Gets collections applicable for the customer. Use this endpoint to retrieve collections associated with your G |
GET | /v3/countries | Gets countries codes and names. Returns a list of country objects that contains country name, two letter ISO a |
GET | /v3/customers/current | Returns information about the current user. Returns the first, middle and last name of the authenticated user. |
GET | /v3/downloads | Returns information about a customer's downloaded assets. Returns information about a customer's previously do |
POST | /v3/downloads/images/{id} | Download an image Use this endpoint to generate download URLs and related data for images you are authorized t |
POST | /v3/downloads/videos/{id} | Download a video Use this endpoint to generate download URLs and related data for videos you are authorized to |
GET | /v3/events | Get metadata for multiple events This endpoint returns the detailed event metadata for all specified events. G |
GET | /v3/events/{id} | Get metadata for a single event This endpoint returns the detailed event metadata for a specified event. Getty |
GET | /v3/images | Get metadata for multiple images by supplying multiple image ids This endpoint returns the detailed image meta |
GET | /v3/images/{id} | Get metadata for a single image by supplying one image id This endpoint returns the detailed image metadata fo |
GET | /v3/images/{id}/downloadhistory | Returns information about a customer's download history for a specific asset Images |
GET | /v3/images/{id}/same-series | Retrieve creative images from the same series This endpoint will provide the list of images, if any exist, fro |
GET | /v3/images/{id}/similar | Retrieve similar images This endpoint will provide a list of images that are similar to the specified asset id |
GET | /v3/orders/{id} | Get order metadata This endpoint returns detailed order metadata for a specified order. Use of this endpoint r |
GET | /v3/products | Get Products This endpoint returns all products available to the username used during authentication. As such, |
GET | /v3/purchased-assets | Get Previously Purchased Images and Video This endpoint returns a list of all assets purchased on gettyimages. |
PUT | /v3/search/by-image/uploads/{file-name} | Upload image for use by the search creative images/videos operations Search |
GET | /v3/search/events | Search for events Use this endpoint to search Getty Images news, sports and entertainment events. Getty Images |
GET | /v3/search/images | Search for both creative and editorial images - *** DEPRECATED *** ## _This endpoint draws from such a large d |
GET | /v3/search/images/creative | Search for creative images only Use this endpoint to search our contemporary stock photos, illustrations and a |
GET | /v3/search/images/creative/by-image | Search for creative images based on url Search for **similar creative images** by passing an `image_url` to an |
GET | /v3/search/images/editorial | Search for editorial images only Use this endpoint to search our editorial stock photos, illustrations and arc |
and 9 more operation(s) in this specification, all searchable.
specification origin: https://api.gettyimages.com/swagger/v3/swagger.json
nothing on this page is a rating, an endorsement or a claim about quality. Reachability is what our probes observed from one network; answering is a floor under usefulness, not a measure of it.