Getty Images Series API
The Series API from Getty Images — 2 operation(s) for series.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/getty-images-series-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Getty Images Series API
version: '3'
description: '
Developer resources for the Getty Images API including SDK, documentation,
release notes, status, notifications and sample code.'
servers:
- url: https://api.gettyimages.com
description: Base URL declared by the provider in apis.yml (roadmap#122).
security:
- Api-Key: []
- OAuth2: []
tags:
- name: Series
paths:
/v3/images/{id}/same-series:
get:
tags:
- Series
summary: Retrieve creative images from the same series
description: "This endpoint will provide the list of images, if any exist, from the same series as the specified creative asset id. These images are typically from the same photo shoot. This functionality will not work for editorial assets.\n\nYou'll need an API key and access token to use this resource.\n\n## Working with Fields Sets\n\nFields sets are used in the **fields** request parameter to receive a suite of metadata fields. The following fields sets are available:\n\n#### Summary Fields Set\n\nThe **summary_set** query string parameter fields value represents a small batch of metadata fields that are often used to build\nsearch response results. The following fields are provided for every image in your result set when you include **summary_set** in your request.\n\n```\n{\n \"images\":\n [\n \"asset_family\",\n \"caption\",\n \"collection_code\",\n \"collection_id\",\n \"collection_name\",\n \"display_sizes\": \n [\n {\n \"name\": \"thumb\"\n }\n ]\n \"license_model\",\n \"max_dimensions\",\n \"title\"\n ]\n}\n```\n\n#### Detail Fields Set\n\nThe **detail_set** query string parameter fields value represents a large batch of metadata fields that are often used to build a \ndetailed view of images. The following fields are provided for every image in your result set when you include **detail_set** in your request.\n\n```\n{\n \"images\":\n [\n \"allowed_use\",\n \"artist\",\n \"asset_family\",\n \"call_for_image\",\n \"caption\",\n \"collection_code\",\n \"collection_id\",\n \"collection_name\",\n \"copyright\",\n \"date_created\",\n \"display_sizes\": \n [\n {\n \"name\": \"comp\"\n },\n {\n \"name\": \"preview\"\n },\n {\n \"name\": \"thumb\"\n }\n ],\n \"editorial_segments\",\n \"event_ids\",\n \"graphical_style\",\n \"license_model\",\n \"max_dimensions\",\n \"orientation\",\n \"product_types\",\n \"quality_rank\",\n \"referral_destinations\",\n \"title\"\n ]\n}\n```\n\n#### Display Fields Set\n\nThe **display_set** query string parameter fields value represents the fields that provide you with URLs for the low resolution files \nthat are most frequently used to build a UI displaying search results. The following fields are provided for every image in your result\nset when you include **display_set** in your request.\n\nThe URI provided is subject to change at any time and must be used as-is with no modification.\n\n```\n{\n \"images\":\n [\n \"display_sizes\": \n [\n {\n \"is_watermarked\": <boolean>,\n \"name\": \"comp\",\n \"uri\": \"<link>\"\n },\n {\n \"is_watermarked\": <boolean>,\n \"name\": \"preview\",\n \"uri\": \"<link>\"\n },\n {\n \"is_watermarked\": <boolean>,\n \"name\": \"thumb\",\n \"uri\": \"<link>\"\n }\n ]\n ]\n}\n```\n"
parameters:
- name: Accept-Language
in: header
description: 'Provide a header to specify the language of result values. Supported values: cs (iStock only), de, en-GB, en-US, es, fi (iStock only), fr, hu (iStock only), id (iStock only), it, ja, ko (creative assets only), nl, pl (creative assets only), pt-BR, pt-PT, ro (iStock only), ru (creative assets only), sv, th (iStock only), tr, uk (iStock only), vi (iStock only), zh-HK (creative assets only).'
schema:
type: string
description: 'Provide a header to specify the language of result values. Supported values: cs (iStock only), de, en-GB, en-US, es, fi (iStock only), fr, hu (iStock only), id (iStock only), it, ja, ko (creative assets only), nl, pl (creative assets only), pt-BR, pt-PT, ro (iStock only), ru (creative assets only), sv, th (iStock only), tr, uk (iStock only), vi (iStock only), zh-HK (creative assets only).'
- name: id
in: path
description: Identifies an existing image
required: true
schema:
type:
- string
- 'null'
description: Identifies an existing image
- name: fields
in: query
description: 'Specifies fields to return. Defaults to ''summary_set''. NOTE: Bytes, height, and width returned by ''download_sizes'' field are estimates.'
style: form
explode: false
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ImagesFieldValues'
description: 'Specifies fields to return. Defaults to ''summary_set''. NOTE: Bytes, height, and width returned by ''download_sizes'' field are estimates.'
- name: page
in: query
description: Identifies page to return. Default is 1.
schema:
type: integer
description: Identifies page to return. Default is 1.
format: int32
default: 1
- name: page_size
in: query
description: Specifies page size. Default is 30, maximum page_size is 100.
schema:
type: integer
description: Specifies page size. Default is 30, maximum page_size is 100.
format: int32
default: 30
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ImageSearchItemSearchResults'
'400':
description: InvalidParameterValue
'401':
description: AuthorizationTokenRequired
'403':
description: UnauthorizedDisplaySize
'404':
description: ImageNotFound
'500':
description: InvalidIStockCollection
/v3/videos/{id}/same-series:
get:
tags:
- Series
summary: Retrieve creative videos from the same series
description: "This endpoint will provide the list of videos, if any exist, from the same series as the specified creative asset id. These images are typically from the same photo shoot. This functionality will not work for editorial assets.\n\nYou'll need an API key and access token to use this resource.\n\n## Working with Fields Sets\n\nFields sets are used in the **fields** request parameter to receive a suite of metadata fields. The following fields sets are available:\n\n#### Summary Fields Set\n\nThe **summary_set** query string parameter fields value represents a small batch of metadata fields that are often used to build search response results. The following fields are provided for every video in your result set when you include **summary_set** in your request.\n\n```\n{\n \"videos\":\n [\n \"asset_family\",\n \"caption\",\n \"collection_code\",\n \"collection_name\",\n \"display_sizes\":\n [\n {\n \"name\": \"comp\"\n },\n {\n \"name\": \"preview\"\n },\n {\n \"name\": \"thumb\"\n }\n ],\n \"license_model\",\n \"title\"\n ]\n}\n```\n\n#### Detail Fields Set\n\nThe **detail_set** query string parameter fields value represents a large batch of metadata fields that are often used to build a detailed view of videos. The following fields are provided for every video in your result set when you include **detail_set** in your request.\n\n```\n{\n \"videos\":\n [\n \"allowed_use\",\n \"artist\",\n \"asset_family\",\n\t\t\"call_for_image\",\n \"caption\",\n \"clip_length\",\n \"collection_code\",\n \"collection_id\",\n \"collection_name\",\n \"color_type\",\n \"copyright\",\n \"date_created\",\n \"display_sizes\":\n [\n {\n \"name\": \"comp\"\n },\n {\n \"name\": \"preview\"\n },\n {\n \"name\": \"thumb\"\n }\n ],\n \"download_sizes\",\n \"era\",\n \"license_model\",\n \"mastered_to\",\n \"originally_shot_on\",\n \"product_types\",\n \"quality_rank\",\n \"shot_speed\",\n \"source\",\n \"title\"\n ]\n}\n```\n\n#### Display Fields Set\n\nThe **display_set** query string parameter fields value represents the fields that provide you with URLs for the low resolution files that are most frequently used to build a UI displaying search results. The following fields are provided for every video in your result set when you include **display_set** in your request.\n\nThe URI provided is subject to change at any time and must be used as-is with no modification.\n\n```\n{\n \"videos\":\n [\n \"display_sizes\": \n [\n {\n \"is_watermarked\": <boolean>,\n \"name\": \"comp\",\n \"uri\": \"<link>\"\n },\n {\n \"is_watermarked\": <boolean>,\n \"name\": \"preview\",\n \"uri\": \"<link>\"\n },\n {\n \"is_watermarked\": <boolean>,\n \"name\": \"thumb\",\n \"uri\": \"<link>\"\n }\n ]\n ]\n}\n```\n"
parameters:
- name: Accept-Language
in: header
description: 'Provide a header to specify the language of result values. Supported values: cs (iStock only), de, en-GB, en-US, es, fi (iStock only), fr, hu (iStock only), id (iStock only), it, ja, ko (creative assets only), nl, pl (creative assets only), pt-BR, pt-PT, ro (iStock only), ru (creative assets only), sv, th (iStock only), tr, uk (iStock only), vi (iStock only), zh-HK (creative assets only).'
schema:
type: string
description: 'Provide a header to specify the language of result values. Supported values: cs (iStock only), de, en-GB, en-US, es, fi (iStock only), fr, hu (iStock only), id (iStock only), it, ja, ko (creative assets only), nl, pl (creative assets only), pt-BR, pt-PT, ro (iStock only), ru (creative assets only), sv, th (iStock only), tr, uk (iStock only), vi (iStock only), zh-HK (creative assets only).'
- name: id
in: path
description: Identifies an existing video
required: true
schema:
type:
- string
- 'null'
description: Identifies an existing video
- name: fields
in: query
description: 'Specifies fields to return. Defaults to ''summary_set''. NOTE: Bytes returned by ''download_sizes'' field is an estimate.'
style: form
explode: false
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/AssociatedVideoDetailFieldValues'
description: 'Specifies fields to return. Defaults to ''summary_set''. NOTE: Bytes returned by ''download_sizes'' field is an estimate.'
- name: page
in: query
description: Identifies page to return. Default is 1.
schema:
type: integer
description: Identifies page to return. Default is 1.
format: int32
default: 1
- name: page_size
in: query
description: Specifies page size. Default is 30, maximum page_size is 100.
schema:
type: integer
description: Specifies page size. Default is 30, maximum page_size is 100.
format: int32
default: 30
responses:
'200':
description: OK
'400':
description: InvalidParameterValue
'401':
description: AuthorizationTokenRequired
'403':
description: UnauthorizedDisplaySize
'404':
description: VideosNotFound
'500':
description: InvalidIStockCollection
components:
schemas:
MaxDimensions:
type: object
properties:
height:
type: integer
format: int32
width:
type: integer
format: int32
additionalProperties: false
AllowedUse:
type: object
properties:
how_can_i_use_it:
type:
- string
- 'null'
description: Indicates how the asset can be used
release_info:
type:
- string
- 'null'
description: Indicates release status
usage_restrictions:
type:
- array
- 'null'
items:
type: string
description: Indicates asset usage restriction, if any
additionalProperties: false
AssociatedVideoDetailFieldValues:
enum:
- allowed_use
- artist
- aspect_ratio
- asset_family
- call_for_image
- caption
- clip_length
- collection_code
- collection_id
- collection_name
- color_type
- comp
- copyright
- date_created
- date_submitted
- detail_set
- display_set
- download_product
- download_sizes
- editorial_segments
- entity_details
- era
- event_ids
- id
- istock_collection
- keywords
- largest_downloads
- license_model
- mastered_to
- orientation
- originally_shot_on
- preview
- product_types
- quality_rank
- referral_destinations
- shot_speed
- source
- summary_set
- thumb
- title
- istock_licenses
type: string
ReferralDestination:
type: object
properties:
site_name:
type:
- string
- 'null'
uri:
type:
- string
- 'null'
additionalProperties: false
ImageSearchItemSearchResults:
type: object
properties:
result_count:
type: integer
format: int32
images:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ImageSearchItem'
related_searches:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/RelatedSearch'
additionalProperties: false
AssetLicenseName:
enum:
- Standard
- Multiseat
- Unlimited
- Resale
- Indemnification
type: string
RelatedSearch:
type: object
properties:
phrase:
type:
- string
- 'null'
url:
type:
- string
- 'null'
additionalProperties: false
Keyword:
type: object
properties:
keyword_id:
type:
- string
- 'null'
text:
type:
- string
- 'null'
type:
type:
- string
- 'null'
relevance:
type:
- integer
- 'null'
format: int32
entity_uris:
type:
- array
- 'null'
items:
type: string
entity_types:
type:
- array
- 'null'
items:
type: string
additionalProperties: false
IStockLicense:
type: object
properties:
license_type:
$ref: '#/components/schemas/AssetLicenseName'
credits:
type: integer
format: int32
additionalProperties: false
ImageSearchItemDisplaySize:
type: object
properties:
is_watermarked:
type: boolean
name:
type:
- string
- 'null'
uri:
type:
- string
- 'null'
additionalProperties: false
ImagesFieldValues:
enum:
- accessrestriction
- allowed_use
- alternative_ids
- artist
- asset_family
- call_for_image
- caption
- collection_code
- collection_id
- collection_name
- color_type
- comp
- comp_webp
- copyright
- date_camera_shot
- date_created
- date_submitted
- detail_set
- display_set
- download_product
- download_sizes
- editorial_segments
- editorial_source
- entity_details
- event_ids
- graphical_style
- id
- istock_collection
- keywords
- largest_downloads
- license_model
- max_dimensions
- orientation
- people
- preview
- product_types
- quality_rank
- referral_destinations
- summary_set
- thumb
- title
- uri_oembed
type: string
ImageSearchItem:
type: object
properties:
allowed_use:
$ref: '#/components/schemas/AllowedUse'
alternative_ids:
type:
- object
- 'null'
additionalProperties:
type: string
artist:
type:
- string
- 'null'
asset_family:
type:
- string
- 'null'
call_for_image:
type: boolean
caption:
type:
- string
- 'null'
collection_code:
type:
- string
- 'null'
collection_id:
type:
- integer
- 'null'
format: int32
collection_name:
type:
- string
- 'null'
color_type:
type:
- string
- 'null'
copyright:
type:
- string
- 'null'
date_camera_shot:
type:
- string
- 'null'
format: date-time
date_created:
type:
- string
- 'null'
format: date-time
display_sizes:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ImageSearchItemDisplaySize'
download_product:
type:
- string
- 'null'
editorial_segments:
type:
- array
- 'null'
items:
type: string
event_ids:
type:
- array
- 'null'
items:
type: integer
format: int32
graphical_style:
type:
- string
- 'null'
id:
type:
- string
- 'null'
keywords:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/Keyword'
largest_downloads:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/Download'
license_model:
type:
- string
- 'null'
max_dimensions:
$ref: '#/components/schemas/MaxDimensions'
orientation:
type:
- string
- 'null'
people:
type:
- array
- 'null'
items:
type: string
product_types:
type:
- array
- 'null'
items:
type: string
quality_rank:
type: integer
format: int32
referral_destinations:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ReferralDestination'
title:
type:
- string
- 'null'
uri_oembed:
type:
- string
- 'null'
istock_licenses:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/IStockLicense'
additionalProperties: false
Download:
type: object
properties:
product_id:
type:
- string
- 'null'
product_type:
type:
- string
- 'null'
uri:
type:
- string
- 'null'
agreement_name:
type:
- string
- 'null'
additionalProperties: false
securitySchemes:
Api-Key:
type: apiKey
name: Api-Key
in: header
OAuth2:
type: oauth2
flows:
password:
tokenUrl: https://api.gettyimages.com/v4/oauth2/token
refreshUrl: https://api.gettyimages.com/v4/oauth2/token
scopes: {}
clientCredentials:
tokenUrl: https://api.gettyimages.com/v4/oauth2/token
scopes: {}
authorizationCode:
authorizationUrl: https://api.gettyimages.com/v4/oauth2/auth
tokenUrl: https://api.gettyimages.com/v4/oauth2/token
refreshUrl: https://api.gettyimages.com/v4/oauth2/token
scopes: {}