action gettyimages_get_v3_images {
  label: "Get metadata for multiple images by supplying multiple image ids"
  description: "This endpoint returns the detailed image metadata for all specified images.\n\nYou'll need an API key and access token to use this resource.\n\n## Working with Fields Sets\n\nFields sets are used in the **fields** request parameter to receive a suite of metadata fields. The following fields sets are available:\n\n#### Summary Fields Set\n\nThe **summary_set** query string parameter fields value represents a small batch of metadata fields that are often used to build \nsearch response results. The following fields are provided for every image in your result set when you include **summary_set** in your request.\n\n```\n{\n    \"images\":\n    [\n        \"artist\",\n        \"asset_family\",\n        \"caption\",\n        \"collection_code\",\n        \"collection_id\",\n        \"collection_name\",\n        \"license_model\",\n        \"max_dimensions\",\n        \"title\"\n    ]\n}\n```\n\n#### Detail Fields Set\n\nThe **detail_set** query string parameter fields value represents a large batch of metadata fields that are often used to build a \ndetailed view of images. The following fields are provided for every image in your result set when you include **detail_set** in your request.\n\n```\n{\n    \"images\":\n    [\n        \"allowed_use\",\n        \"artist\", \n        \"artist_title\", \n        \"asset_family\",\n        \"call_for_image\",\n        \"caption\", \n        \"city\",\n        \"collection_code\",\n        \"collection_id\", \n        \"collection_name\",\n        \"color_type\", \n        \"copyright\", \n        \"country\", \n        \"credit_line\", \n        \"date_created\", \n        \"date_submitted\",\n        \"download_sizes\", \n        \"editorial_segments\",\n        \"event_ids\",\n        \"graphical_style\",\n        \"license_model\",\n        \"max_dimensions\",\n        \"orientation\",\n        \"product_types\",\n        \"quality_rank\",\n        \"referral_destinations\",\n        \"state_province\", \n        \"title\"\n    ]\n}\n```\n\n#### Display Fields Set\n\nThe **display_set** query string parameter fields value represents the fields that provide you with URLs for the low resolution\nfiles that are most frequently used to build a UI displaying search results. The following fields are provided for every image \nin your result set when you include **display_set** in your request.\n\nThe URI provided is subject to change at any time and must be used as-is with no modification.\n\n```\n{\n    \"images\":\n    [\n        \"display_sizes\": \n        [\n            {\n                \"is_watermarked\": <boolean>,\n                \"name\": \"comp\",\n                \"uri\": \"<link>\"\n            },\n            {\n                \"is_watermarked\": <boolean>,\n                \"name\": \"preview\",\n                \"uri\": \"<link>\"\n            },\n            {\n                \"is_watermarked\": <boolean>,\n                \"name\": \"thumb\",\n                \"uri\": \"<link>\"\n            }\n        ]\n    ]\n}\n```\n\n## Request Usage Considerations\n\n- Specifying the \"entity_details\" response field can have significant performance implications. The field should be used only when necessary.\n"
  provider: gettyimages
  method: GET
  path: "/v3/images"
  encoding: json
  input: {
    type: "object"
    properties: {
      "Accept-Language": {
        type: "string"
        description: "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)."
      }
      fields: {
        type: "array"
        description: "Specifies fields to return. Defaults to 'summary_set'. NOTE: Bytes, height, and width returned by 'download_sizes' field are estimates."
        items: {
          type: "string"
          enum: ["allowed_use", "alternative_ids", "artist", "artist_title", "asset_family", "call_for_image", "caption", "city", "collection_code", "collection_id", "collection_name", "color_type", "comp", "copyright", "country", "credit_line", "date_camera_shot", "date_created", "date_submitted", "detail_set", "display_set", "download_sizes", "download_product", "downloads", "editorial_segments", "editorial_source", "entity_details", "event_ids", "graphical_style", "id", "istock_collection", "istock_licenses", "keywords", "largest_downloads", "license_model", "links", "max_dimensions", "object_name", "orientation", "people", "preview", "product_types", "quality_rank", "referral_destinations", "state_province", "summary_set", "thumb", "title", "uri_oembed"]
        }
      }
      ids: {
        type: "array"
        description: "Specifies one or more image ids to return. Use comma delimiter when requesting multiple ids.  Maximum of 100 ids."
        items: {
          type: "string"
        }
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      images: {
        type: "object"
      }
      images_not_found: {
        type: "array"
        items: {
          type: "string"
        }
      }
    }
    additionalProperties: false
  }
}