Integration

Getty Images integration

Search and read the Getty Images and iStock catalog with an API key: search creative and editorial images and videos by phrase and filters (orientation, color, people, composition, date, event, collection), find images or videos similar to a catalog asset or from the same shoot, search news, sports and entertainment events, browse an artist's images and videos, and read full metadata (caption, artist, collection, license model, keywords, preview URLs) for images, videos and events by id. Without an access token, results equal an anonymous search on the Getty Images site. Downloads, licensing, boards, purchases, usage reporting, asset change notifications and AI image generation need an OAuth access token on top of the API key, which this connection cannot send, so they are not included; the deprecated combined image search and the restricted image-match search are left out too. Authentication is the API key issued by Getty Images (through your account representative), sent in the Api-Key header.

Connect Getty Images How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Getty Images.Built from the 20 Getty Images tools below, on the connection you add once.

What you can do with Getty Images

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Image, 7 operations

get_imageGet imageGETReturns detailed metadata of one image (caption, artist, collection, keywords, license model, preview URLs); the image is the single entry of images. Use fields to choose what is returned.
list_imagesList imagesGETReturns detailed metadata for several images at once, by comma-separated ids; ids that do not exist are listed in images_not_found.
list_same_series_imagesList same series imagesGETLists creative images from the same series (usually the same photo shoot) as the given creative image id; does not work for editorial images.
list_similar_imagesList similar imagesGETLists creative images similar to the given image id, page by page (page_size up to 100).
search_creative_imagesSearch creative imagesGETSearches creative stock photos, illustrations and vectors by phrase with many filters; returns images (id, title, caption, preview display_sizes, license model) and result_count. A phrase is expected.
search_creative_images_by_imageSearch creative images by imageGETFinds creative images similar to a catalog image or video (asset_id) or to an image already uploaded to Getty's by-image upload URL (image_url); nudity is always excluded.
search_editorial_imagesSearch editorial imagesGETSearches editorial images (news, sport, entertainment, archival) by phrase, event, people, date and other filters; returns images and result_count.

Video, 7 operations

get_videoGet videoGETReturns detailed metadata of one video: caption, artist, clip length, collection, keywords, license model, preview URLs. Use fields to choose what is returned.
list_same_series_videosList same series videosGETLists videos from the same series (usually the same shoot) as the given creative video id; does not work for editorial videos.
list_similar_videosList similar videosGETLists videos similar to the given video id, page by page (page_size up to 100).
list_videosList videosGETReturns detailed metadata for several videos at once, by comma-separated ids; ids that do not exist are listed in videos_not_found.
search_creative_videosSearch creative videosGETSearches creative stock video, from archival film to 4K and HD footage, by phrase and filters (clip length, frame rate, format, orientation); returns videos and result_count.
search_creative_videos_by_imageSearch creative videos by imageGETFinds creative videos similar to a catalog asset (asset_id) or to an image or frame grab already uploaded to Getty's by-image upload URL (image_url).
search_editorial_videosSearch editorial videosGETSearches editorial video clips of celebrities, newsmakers and events by phrase, event, people, date and other filters; returns videos and result_count.

Event, 3 operations

get_eventGet eventGETReturns one Getty event: name, start date, location, type, editorial segments, keywords, image count, hero image and child events.
list_eventsList eventsGETReturns detailed metadata for several Getty events at once, by comma-separated ids; ids that do not exist are listed in events_not_found.
search_eventsSearch eventsGETSearches Getty news, sports and entertainment events by phrase, editorial segment and start-date range; returns events (id, name, start_date by default) and result_count. Needs only the API key.

Artist image, 1 operation

list_artist_imagesList artist imagesGETLists the images of one photographer by artist name, page by page (page_size default 10, max 100).

Artist video, 1 operation

list_artist_videosList artist videosGETLists the videos of one artist by artist name, page by page (page_size default 10, max 100).

Country, 1 operation

list_countriesList countriesGETLists countries with their name and two- and three-letter ISO codes (the three-letter code is what GI-Country-Code expects).

Use Getty Images from Claude Code, Cursor or Codex

Connect Getty Images in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Getty Images operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Getty Images

Create your workspace
Sign up free. Nothing to install.
Connect Getty Images once
Add your Getty Images connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.