Products

This endpoint returns all products available to the username used during authentication. As such, this endpoint requires the use of a fully authorized access_token. The product data can then be used as search filters, restricting results to images from a specific product.

You'll need an API key and access token to use this resource.

get/v3/products

Request

  • Base URL
    https://api.gettyimages.com (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header Api-Key
    • or OAuth 2
      Authorization codehttps://authentication.gettyimages.com/oauth2/auth
      Client credentials
      Password
      Token URLhttps://authentication.gettyimages.com/oauth2/token
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

fieldsGettyImagesServicesConnectPublicControllersProductsProductFieldValues[]

Comma separated list of fields. Allows product download requirements to be returned.

Headers

Accept-Languagestring

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

OK

Changes

    • warning

      added the new aigen enum value to the // response property for the response status

    • info

      added the optional property // to the response with the status