---
title: "GET /v3/affiliates/search/images"
method: GET
path: "/v3/affiliates/search/images"
tags: ["AffiliateSearch"]
---

# GET /v3/affiliates/search/images

`GET /v3/affiliates/search/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/affiliates/search/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/affiliates/search/images/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `phrase` string
- `style` 'photography' | 'vector': Specifies the graphical style of images desired.

## 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).
- `GI-Country-Code` string: Use of this parameter requires configuration changes to your API key. Please contact your sales representative to learn more.

## Response `200`

OK

- GettyImagesServicesConnectPublicControllersAffiliateAffiliateImageSearchResponse
  - `images` GettyImagesServicesConnectPublicControllersAffiliateAffiliateImage[], nullable
    - `id` string, nullable
    - `title` string, nullable
    - `caption` string, nullable
    - `preview_urls` GettyImagesServicesConnectPublicControllersAffiliateAffiliateImageUrls
      - `small` string, nullable
      - `small_height` integer
      - `small_width` integer
      - `medium` string, nullable
      - `medium_height` integer
      - `medium_width` integer
      - `large` string, nullable
      - `large_height` integer
      - `large_width` integer
    - `destination_url` string, nullable
  - `auto_corrections` GettyImagesServicesConnectPublicModelsSearchAutoCorrections
    - `phrase` string, nullable

## Changes

- **2024-08-26** `00000cbae4c7`: 1 info
  - added the new optional `header` request parameter `GI-Country-Code`

[Operation history](https://skmtc.dev/gettyimages/apis/getty-images-api/changes/v3/affiliates/search/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)