Search Getty Images for licensable assets and download a licensed image via its download URI
domain: api.gettyimages.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Obtain an access token via either the client credentials or authorization code grant
Call GET https://api.gettyimages.com/v3/search/images with an Api-Key header, an Authorization Bearer header, a phrase query parameter, and fields=largest_downloads to include download links in results
From the response, read each image's largest_downloads array for a uri and its authorized product_type
Request the actual download with POST to that uri, passing product_type as a query string parameter (e.g. ?product_type=easyaccess)
By default the download POST returns a 302 redirect that delivers the file directly; alternatively pass auto_download=false to get a JSON body with a time-limited delivery URI instead
Follow the redirect (or fetch the returned URI) and read the Content-Disposition response header to determine the correct filename, since the URI path itself is opaque
Known gotchas
Download URIs returned by the API are not permalinks — they are valid for less than 24 hours and must be used promptly
Search calls without fields=largest_downloads will omit download links entirely, even with a valid access token
The largest_downloads array reflects only the product types the current token is authorized for, so a search phrase can return assets the caller cannot actually license/download
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?