Getty Images · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Getty Images Sets API

3 actions 3 updates update extends openapi/getty-images-sets-api-openapi.yml
Derived by API Evangelist Built from the contracts Getty Images publishes. Getty Images did not publish this file.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-providerx-apievangelist-enrichedx-upstream-contractx-upstream-contract-versionx-operations-in-this-documentx-apievangelist-tagsx-runtime-semanticsx-contract-quality-gaps

Targets 1

$.info

OpenAPI Overlay

Raw ↑
overlay: 1.0.0
info:
  title: API Evangelist enhancements for Getty Images Sets API
  version: 1.0.0
extends: openapi/getty-images-sets-api-openapi.yml
x-generated: '2026-09-12'
x-method: generated
x-source: https://api.gettyimages.com/swagger/v3/swagger.json + https://developer.gettyimages.com/docs/
x-note: Records API Evangelist enrichment findings against this document without mutating it. The upstream contract
  this repo split from is the provider's live OpenAPI 3.0.4 at https://api.gettyimages.com/swagger/v3/swagger.json,
  harvested verbatim on 2026-09-12 to openapi/_original/getty-images-swagger-v3-openapi.json. Every value asserted
  below was read from the provider's own contract or documentation; nothing here is invented.
actions:
- target: $.info
  update:
    x-apievangelist-provider: getty-images
    x-apievangelist-enriched: '2026-09-12'
    x-upstream-contract: https://api.gettyimages.com/swagger/v3/swagger.json
    x-upstream-contract-version: OpenAPI 3.0.4
    x-operations-in-this-document: 2
    x-apievangelist-tags:
    - Sets
- target: $.info
  update:
    x-runtime-semantics:
      authentication: 'Api-Key header required on every request; Authorization: Bearer additionally required for
        downloads, download fields, boards, purchase history and all Gen AI operations.'
      oauth-token-endpoint: https://authentication.gettyimages.com/oauth2/token
      error-envelope: 'application/vnd.getty.error+json with ErrorCode / ErrorMessage; edge failures return {"message":
        "..."}'
      rfc9457: false
      idempotency: none - no Idempotency-Key or equivalent exists anywhere in the Getty contract
      rate-limit-headers: none - no RateLimit-*/X-RateLimit-*/Retry-After; 429 carries X-Error-Detail on the QPS
        path
      pagination: page / page_size querystring; result_count in the body; page_size limited to an enumerated value
        set
      field-expansion: fields=summary_set (default) | detail_set | comma-delimited list; download fields must be
        requested explicitly and need a bearer token
      sandbox: none published
      webhooks: none - catalogue changes are pulled via /v3/asset-changes
      detail:
      - conventions/getty-images-conventions.yml
      - errors/getty-images-problem-types.yml
      - rate-limits/getty-images-rate-limits.yml
      - authentication/getty-images-authentication.yml
- target: $.info
  update:
    x-contract-quality-gaps:
      operation-ids: The upstream contract declares no operationId on any of its 76 operations, so no operation
        in this document has one either. Every derived artifact in this repo addresses operations by METHOD + PATH
        as a result.
      in-spec-examples: The upstream contract carries no request or response examples.
      schema-naming: Many component schemas carry leaked .NET fully-qualified type names (GettyImages.Services.Connect.Public.Controllers.*),
        indicating the spec is emitted from the implementation rather than authored.
      observed-on: '2026-09-12'

Work with this as data

Every overlay 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 openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • 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.
All 92 tools →

Call it yourself

curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/getty-images-sets-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.