Getty Images Artists API
The Artists API from Getty Images — 2 operation(s) for artists.
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-artists-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 Artists API
version: '3'
description: 'Operations tagged Artists across 2 of this provider''s published API definitions: getty-images-openapi.yml, getty-images-swagger-v3-openapi.json. Each path carries the servers of the definition it was published in.'
security:
- Api-Key: []
- OAuth2: []
tags:
- name: Artists
paths:
/v3/artists/images:
get:
tags:
- Artists
summary: Search for images by a photographer
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: artist_name
in: query
description: Name of artist for desired images
schema:
type:
- string
- 'null'
description: Name of artist for desired images
- name: fields
in: query
description: Comma separated list of fields. Allows restricting which fields are returned. If no fields are selected, the summary_set of fields are returned.
style: form
explode: false
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ArtistsImageSearchFieldValues'
description: Comma separated list of fields. Allows restricting which fields are returned. If no fields are selected, the summary_set of fields are returned.
- name: page
in: query
description: Identifies page to return. Default page is 1.
schema:
type: integer
description: Identifies page to return. Default page is 1.
format: int32
default: 1
- name: page_size
in: query
description: Specifies page size. Default page_size is 10, maximum page_size is 100.
schema:
type: integer
description: Specifies page size. Default page_size is 10, maximum page_size is 100.
format: int32
default: 10
responses:
'200':
description: OK
'400':
description: InvalidParameterValue
'401':
description: Unauthorized
operationId: getV3ArtistsImages
x-operation-id-source: derived
/v3/artists/videos:
get:
tags:
- Artists
summary: Search for videos by a photographer
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: artist_name
in: query
description: Name of artist for desired images
schema:
type:
- string
- 'null'
description: Name of artist for desired images
- name: fields
in: query
description: Comma separated list of fields. Allows restricting which fields are returned. If no fields are selected, the summary_set of fields are returned.
style: form
explode: false
schema:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ArtistsVideoSearchFieldValues'
description: Comma separated list of fields. Allows restricting which fields are returned. If no fields are selected, the summary_set of fields are returned.
- name: page
in: query
description: Identifies page to return. Default page is 1.
schema:
type: integer
description: Identifies page to return. Default page is 1.
format: int32
default: 1
- name: page_size
in: query
description: Specifies page size. Default page_size is 10, maximum page_size is 100.
schema:
type: integer
description: Specifies page size. Default page_size is 10, maximum page_size is 100.
format: int32
default: 10
responses:
'200':
description: OK
'400':
description: InvalidParameterValue
'401':
description: Unauthorized
operationId: getV3ArtistsVideos
x-operation-id-source: derived
components:
schemas:
ArtistsVideoSearchFieldValues:
enum:
- id
- allowed_use
- alternative_ids
- artist
- asset_family
- asset_type
- call_for_image
- caption
- clip_length
- collection_id
- collection_code
- collection_name
- comp
- copyright
- date_created
- date_submitted
- detail_set
- display_set
- editorial_segments
- event_ids
- graphical_style
- keywords
- license_model
- max_dimensions
- orientation
- preview
- product_types
- quality_rank
- referral_destinations
- summary_set
- thumb
- title
type: string
ArtistsImageSearchFieldValues:
enum:
- id
- allowed_use
- alternative_ids
- artist
- asset_family
- asset_type
- call_for_image
- caption
- collection_id
- collection_code
- collection_name
- comp
- comp_webp
- copyright
- date_created
- date_submitted
- detail_set
- display_set
- editorial_segments
- event_ids
- graphical_style
- high_res_comp_webp
- keywords
- license_model
- max_dimensions
- mid_res_comp_webp
- orientation
- preview
- product_types
- quality_rank
- referral_destinations
- summary_set
- thumb
- title
type: string
GettyImages.Services.Connect.Public.Models.Search.VideoSearchItemDisplaySize:
type: object
properties:
is_watermarked:
type: boolean
name:
type:
- string
- 'null'
uri:
type:
- string
- 'null'
aspect_ratio:
type:
- string
- 'null'
additionalProperties: false
GettyImages.Services.Connect.Public.Models.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
GettyImages.Services.Connect.Public.Models.Videos.VideoDownloadAuthorization:
type: object
properties:
product_id:
type:
- string
- 'null'
product_type:
type:
- string
- 'null'
uri:
type:
- string
- 'null'
agreement_name:
type:
- string
- 'null'
additionalProperties: false
GettyImages.Services.Connect.Public.Models.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
editorial_use_only:
type: boolean
description: Indicates whether the asset is for editorial use only
additionalProperties: false
GettyImages.Services.Connect.Public.Models.Videos.VideoDownloadSize:
type: object
properties:
bit_depth:
type:
- string
- 'null'
broadcast_video_standard:
type:
- string
- 'null'
compression:
type:
- string
- 'null'
content_type:
type:
- string
- 'null'
description:
type:
- string
- 'null'
downloads:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Videos.VideoDownloadAuthorization'
format:
type:
- string
- 'null'
frame_rate:
type:
- number
- 'null'
format: double
frame_size:
type:
- string
- 'null'
height:
type:
- number
- 'null'
format: double
interlaced:
type: boolean
bytes:
type: integer
format: int64
name:
type:
- string
- 'null'
width:
type: integer
format: int32
additionalProperties: false
GettyImages.Services.Connect.Public.Controllers.Artists.ArtistsVideoSearchFieldValues:
enum:
- id
- allowed_use
- alternative_ids
- artist
- asset_family
- asset_type
- call_for_image
- caption
- clip_length
- collection_id
- collection_code
- collection_name
- comp
- copyright
- date_created
- date_submitted
- display_set
- editorial_segments
- event_ids
- graphical_style
- keywords
- license_model
- max_dimensions
- orientation
- preview
- product_types
- quality_rank
- referral_destinations
- summary_set
- thumb
- title
type: string
GettyImages.Services.Connect.Public.Models.Images.ImageDownloadAuthorization:
type: object
properties:
product_id:
type:
- string
- 'null'
product_type:
type:
- string
- 'null'
uri:
type:
- string
- 'null'
agreement_name:
type:
- string
- 'null'
additionalProperties: false
GettyImages.Services.Connect.Public.Models.Search.ImageSearchItemDisplaySize:
type: object
properties:
is_watermarked:
type: boolean
name:
type:
- string
- 'null'
uri:
type:
- string
- 'null'
additionalProperties: false
GettyImages.Services.Connect.Public.Domain.Services.CreditPack.AssetLicenseName:
enum:
- Standard
- Multiseat
- Unlimited
- Resale
- Indemnification
type: string
GettyImages.Services.Connect.Public.Models.IStockLicense:
type: object
properties:
license_type:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Domain.Services.CreditPack.AssetLicenseName'
credits:
type: integer
format: int32
additionalProperties: false
GettyImages.Services.Connect.Public.Models.TeeShirtSize:
enum:
- x_small
- small
- medium
- large
- x_large
- xx_large
- vector
type: string
GettyImages.Services.Connect.Public.Models.Search.NewModels.Video.ArtistVideoSearchResponse:
type: object
properties:
videos:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Search.NewModels.Video.Video'
result_count:
type: integer
format: int32
additionalProperties: false
GettyImages.Services.Connect.Public.Models.Search.NewModels.Image:
type: object
properties:
istock_collection:
type:
- string
- 'null'
istock_exclusive:
type:
- boolean
- 'null'
allowed_use:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.AllowedUse'
alternative_ids:
type:
- object
- 'null'
additionalProperties:
type:
- string
- 'null'
artist:
type:
- string
- 'null'
asset_family:
type:
- string
- 'null'
asset_type:
type:
- string
- 'null'
call_for_image:
type:
- boolean
- 'null'
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'
contributor:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Contributor'
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/GettyImages.Services.Connect.Public.Models.Search.ImageSearchItemDisplaySize'
download_product:
type:
- string
- 'null'
download_sizes:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Images.ImageDownloadSize'
graphical_style:
type:
- string
- 'null'
id:
type:
- string
- 'null'
keywords:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Keyword'
largest_downloads:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Download'
license_model:
type:
- string
- 'null'
max_dimensions:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.MaxDimensions'
orientation:
type:
- string
- 'null'
product_types:
type:
- array
- 'null'
items:
type: string
quality_rank:
type:
- integer
- 'null'
format: int32
referral_destinations:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.ReferralDestination'
territory_restrictions:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.TerritoryRestriction'
title:
type:
- string
- 'null'
uri_oembed:
type:
- string
- 'null'
date_submitted:
type:
- string
- 'null'
format: date-time
additionalProperties: false
GettyImages.Services.Connect.Public.Models.Keyword:
type: object
properties:
keyword_id:
type:
- string
- 'null'
text:
type:
- string
- 'null'
type:
type:
- string
- 'null'
relevance:
type:
- integer
- 'null'
format: int32
additionalProperties: false
GettyImages.Services.Connect.Public.Models.TerritoryRestriction:
type: object
properties:
country_code:
type:
- string
- 'null'
type:
type:
- string
- 'null'
description:
type:
- string
- 'null'
additionalProperties: false
GettyImages.Services.Connect.Public.Models.ReferralDestination:
type: object
properties:
site_name:
type:
- string
- 'null'
uri:
type:
- string
- 'null'
additionalProperties: false
GettyImages.Services.Connect.Public.Models.Search.NewModels.Video.Video:
type: object
properties:
id:
type:
- string
- 'null'
allowed_use:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.AllowedUse'
alternative_ids:
type:
- object
- 'null'
additionalProperties:
type:
- string
- 'null'
artist:
type:
- string
- 'null'
aspect_ratio:
type:
- string
- 'null'
asset_family:
type:
- string
- 'null'
asset_type:
type:
- string
- 'null'
call_for_image:
type:
- boolean
- 'null'
caption:
type:
- string
- 'null'
clip_length:
type:
- string
- 'null'
collection_id:
type:
- integer
- 'null'
format: int32
collection_code:
type:
- string
- 'null'
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
date_submitted:
type:
- string
- 'null'
format: date-time
display_sizes:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Search.VideoSearchItemDisplaySize'
download_product:
type:
- string
- 'null'
download_sizes:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Videos.VideoDownloadSize'
istock_collection:
type:
- string
- 'null'
istock_exclusive:
type:
- boolean
- 'null'
keywords:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Keyword'
largest_downloads:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Download'
license_model:
type:
- string
- 'null'
mastered_to:
type:
- string
- 'null'
max_dimensions:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.MaxDimensions'
orientation:
type:
- string
- 'null'
originally_shot_on:
type:
- string
- 'null'
product_types:
type:
- array
- 'null'
items:
type: string
quality_rank:
type:
- integer
- 'null'
format: int32
referral_destinations:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.ReferralDestination'
shot_speed:
type:
- string
- 'null'
title:
type:
- string
- 'null'
istock_licenses:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.IStockLicense'
object_name:
type:
- string
- 'null'
additionalProperties: false
GettyImages.Services.Connect.Public.Models.Search.NewModels.ArtistImageSearchResponse:
type: object
properties:
images:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Search.NewModels.Image'
result_count:
type: integer
format: int32
additionalProperties: false
GettyImages.Services.Connect.Public.Models.Contributor:
type: object
properties:
member_name:
type:
- string
- 'null'
description: The contributor's member name
display_name:
type:
- string
- 'null'
description: The contributor's display name
additionalProperties: false
description: Contributor information for an image or video
GettyImages.Services.Connect.Public.Models.MaxDimensions:
type: object
properties:
height:
type: integer
format: int32
width:
type: integer
format: int32
additionalProperties: false
GettyImages.Services.Connect.Public.Controllers.Artists.ArtistsImageSearchFieldValues:
enum:
- id
- allowed_use
- alternative_ids
- artist
- asset_family
- asset_type
- call_for_image
- caption
- collection_id
- collection_code
- collection_name
- comp
- comp_webp
- copyright
- date_created
- date_submitted
- display_set
- editorial_segments
- event_ids
- graphical_style
- high_res_comp_webp
- keywords
- license_model
- max_dimensions
- mid_res_comp_webp
- orientation
- preview
- product_types
- quality_rank
- referral_destinations
- summary_set
- thumb
- title
type: string
GettyImages.Services.Connect.Public.Models.Images.ImageDownloadSize:
type: object
properties:
bytes:
type: integer
format: int64
downloads:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.Images.ImageDownloadAuthorization'
height:
type: integer
format: int32
media_type:
type:
- string
- 'null'
name:
$ref: '#/components/schemas/GettyImages.Services.Connect.Public.Models.TeeShirtSize'
width:
type: integer
format: int32
dpi:
type: integer
format: int32
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: {}
x-refined-from:
- getty-images-openapi.yml
- getty-images-swagger-v3-openapi.json