---
title: "Search for images by a photographer"
method: GET
path: "/v3/artists/images"
tags: ["Artists"]
---

# Search for images by a photographer

`GET /v3/artists/images`

## Request

- Base URL: `https://api.gettyimages.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gettyimages.com/v3/artists/images`
- Auth: one of:
  - API key in header `Api-Key`
  - OAuth 2
    - Authorization code: `https://authentication.gettyimages.com/oauth2/auth`
    - Client credentials
    - Password
    - Token URL: `https://authentication.gettyimages.com/oauth2/token`
- TypeScript: <https://skmtc.dev/gettyimages/apis/getty-images-api/docs/v3/artists/images/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `artist_name` string
- `fields` GettyImagesServicesConnectPublicControllersArtistsArtistsImageSearchFieldValues[]
- `page` integer
- `page_size` integer

## Headers

- `Accept-Language` string: 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).

## Response `200`

OK

- GettyImagesServicesConnectPublicModelsSearchNewModelsArtistImageSearchResponse
  - `images` GettyImagesServicesConnectPublicModelsSearchNewModelsImage[], nullable
    - `istock_collection` string, nullable
    - `istock_exclusive` boolean, nullable
    - `allowed_use` GettyImagesServicesConnectPublicModelsAllowedUse
      - `how_can_i_use_it` string, nullable: Indicates how the asset can be used
      - `release_info` string, nullable: Indicates release status
      - `usage_restrictions` string[], nullable: Indicates asset usage restriction, if any
      - `editorial_use_only` boolean: Indicates whether the asset is for editorial use only
    - `alternative_ids` object, nullable
    - `artist` string, nullable
    - `asset_family` string, nullable
    - `asset_type` string, nullable
    - `call_for_image` boolean, nullable
    - `caption` string, nullable
    - `collection_code` string, nullable
    - `collection_id` integer, nullable
    - `collection_name` string, nullable
    - `color_type` string, nullable
    - `contributor` GettyImagesServicesConnectPublicModelsContributor: Contributor information for an image or video
      - `member_name` string, nullable: The contributor's member name
      - `display_name` string, nullable: The contributor's display name
    - `copyright` string, nullable
    - `date_camera_shot` string, date-time, nullable
    - `date_created` string, date-time, nullable
    - `display_sizes` GettyImagesServicesConnectPublicModelsSearchImageSearchItemDisplaySize[], nullable
      - `is_watermarked` boolean
      - `name` string, nullable
      - `uri` string, nullable
    - `download_product` string, nullable
    - `download_sizes` GettyImagesServicesConnectPublicModelsImagesImageDownloadSize[], nullable
      - `bytes` integer
      - `downloads` GettyImagesServicesConnectPublicModelsImagesImageDownloadAuthorization[], nullable
        - `product_id` string, nullable
        - `product_type` string, nullable
        - `uri` string, nullable
        - `agreement_name` string, nullable
      - `height` integer
      - `media_type` string, nullable
      - `name` 'x_small' | 'small' | 'medium' | 'large' | 'x_large' | 'xx_large' | 'vector'
      - `width` integer
      - `dpi` integer
    - `graphical_style` string, nullable
    - `id` string, nullable
    - `keywords` GettyImagesServicesConnectPublicModelsKeyword[], nullable
      - `keyword_id` string, nullable
      - `text` string, nullable
      - `type` string, nullable
      - `relevance` integer, nullable
    - `largest_downloads` GettyImagesServicesConnectPublicModelsDownload[], nullable
      - `product_id` string, nullable
      - `product_type` string, nullable
      - `uri` string, nullable
      - `agreement_name` string, nullable
    - `license_model` string, nullable
    - `max_dimensions` GettyImagesServicesConnectPublicModelsMaxDimensions
      - `height` integer
      - `width` integer
    - `orientation` string, nullable
    - `product_types` string[], nullable
    - `quality_rank` integer, nullable
    - `referral_destinations` GettyImagesServicesConnectPublicModelsReferralDestination[], nullable
      - `site_name` string, nullable
      - `uri` string, nullable
    - `territory_restrictions` GettyImagesServicesConnectPublicModelsTerritoryRestriction[], nullable
      - `country_code` string, nullable
      - `type` string, nullable
      - `description` string, nullable
    - `title` string, nullable
    - `uri_oembed` string, nullable
    - `date_submitted` string, date-time, nullable
  - `result_count` integer

## Other responses

- `400`: InvalidParameterValue
- `401`: Unauthorized

## Changes

- **2026-09-04** `ddfa6c9c9f0c`: 1 breaking
  - removed the enum value `detail_set` from the property `items/` of the `query` request parameter `fields`
- **2026-06-08** `410649649a3f`: 1 info
  - added the optional property `images/items/istock_exclusive` to the response with the `200` status
- **2025-11-20** `81cb0e852242`: 1 breaking, 1 info
  - the response property `images/items/alternative_ids/additionalProperties/` became nullable for the status `200`
  - added the optional property `images/items/allowed_use/editorial_use_only` to the response with the `200` status
- **2025-05-16** `ff5eea8aa032`: 1 info
  - added the media type `application/json` for the response with the status `200`
- **2024-08-26** `00000cbae4c7`: 3 info
  - added the enum value `comp_webp` to the property `items/` of the `query` request parameter `fields`
  - added the enum value `high_res_comp_webp` to the property `items/` of the `query` request parameter `fields`
  - added the enum value `mid_res_comp_webp` to the property `items/` of the `query` request parameter `fields`

[Operation history](https://skmtc.dev/gettyimages/apis/getty-images-api/changes/v3/artists/images/get.md)

---

[API](https://skmtc.dev/gettyimages/apis/getty-images-api.md) - [All operations](https://skmtc.dev/gettyimages/apis/getty-images-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gettyimages/apis/getty-images-api/revisions/f20ce986456b?raw)