action shutterstock_get_image_list {
  label: "List images"
  description: "This endpoint lists information about one or more images, including the available sizes."
  provider: shutterstock
  method: GET
  path: "/v2/images"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "array"
        items: {
          type: "string"
          format: "asset-id"
        }
      }
      search_id: {
        type: "string"
      }
      view: {
        type: "string"
        enum: ["minimal", "full"]
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    description: "List of images"
    properties: {
      data: {
        type: "array"
        description: "Images"
        items: {
          type: "object"
          description: "Information about an image"
          required: ["id", "media_type", "contributor"]
          properties: {
            added_date: {
              type: "string"
              format: "date"
              description: "Date that the image was added by the contributor"
            }
            affiliate_url: {
              type: "string"
              format: "uri"
              description: "Affiliate referral link; appears only for registered affiliate partners"
            }
            aspect: {
              type: "number"
              description: "Aspect ratio of the image in decimal format, such as 0.6667"
            }
            assets: {
              type: "object"
              description: "Information about the assets that are part of an image"
              properties: {
                huge_jpg: {
                  type: "object"
                  description: "Image size information"
                  properties: {
                    display_name: {
                      type: "string"
                      description: "Display name of this image size"
                    }
                    dpi: {
                      type: "integer"
                    }
                    file_size: {
                      type: "integer"
                      description: "File size (in bytes) of this image size"
                    }
                    format: {
                      type: "string"
                      description: "Format of this image size"
                    }
                    height: {
                      type: "integer"
                      description: "Height of this image size"
                    }
                    is_licensable: {
                      type: "boolean"
                      description: "Whether or not this image can be licensed in this image size"
                    }
                    width: {
                      type: "integer"
                      description: "Width of this image size"
                    }
                  }
                }
                huge_thumb: {
                  type: "object"
                  description: "Image thumbnail information"
                  required: ["url", "height", "width"]
                  properties: {
                    height: {
                      type: "integer"
                      description: "Height in pixels of the image thumbnail"
                    }
                    url: {
                      type: "string"
                      description: "Direct URL to the image"
                    }
                    width: {
                      type: "integer"
                      description: "Width in pixels of the image thumbnail"
                    }
                  }
                }
                large_thumb: {
                  type: "object"
                  additionalProperties: true
                }
                medium_jpg: {
                  type: "object"
                  additionalProperties: true
                }
                preview: {
                  type: "object"
                  additionalProperties: true
                }
                preview_1000: {
                  type: "object"
                  additionalProperties: true
                }
                preview_1500: {
                  type: "object"
                  additionalProperties: true
                }
                small_jpg: {
                  type: "object"
                  additionalProperties: true
                }
                small_thumb: {
                  type: "object"
                  additionalProperties: true
                }
                supersize_jpg: {
                  type: "object"
                  additionalProperties: true
                }
                vector_eps: {
                  type: "object"
                  additionalProperties: true
                }
              }
            }
            categories: {
              type: "array"
              description: "Categories that this image is a part of"
              items: {
                type: "object"
                description: "Category information"
                properties: {
                  id: {
                    type: "string"
                    description: "Category ID"
                  }
                  name: {
                    type: "string"
                    description: "Category name"
                  }
                }
              }
            }
            contributor: {
              type: "object"
              description: "Information about a contributor"
              required: ["id"]
              properties: {
                id: {
                  type: "string"
                  description: "ID of the contributor"
                }
              }
            }
            description: {
              type: "string"
              description: "Detailed description of the image"
            }
            has_model_release: {
              type: "boolean"
              description: "Indicates whether there are model releases for the image"
            }
            has_property_release: {
              type: "boolean"
              description: "Indicates whether there are property releases for the image"
            }
            id: {
              type: "string"
              description: "Image ID"
            }
            image_type: {
              type: "string"
              description: "Type of image"
            }
            insights: {
              type: "object"
              description: "AI-powered insights about how the asset will perform for the objective and audience"
              properties: {
                labels: {
                  type: "array"
                  items: {
                    type: "string"
                  }
                }
              }
            }
            is_adult: {
              type: "boolean"
              description: "Whether or not this image contains adult content"
            }
            is_editorial: {
              type: "boolean"
              description: "Whether or not this image is editorial content"
            }
            is_illustration: {
              type: "boolean"
              description: "Whether or not this image is an illustration"
            }
            keywords: {
              type: "array"
              description: "Keywords associated with the content of this image"
              items: {
                type: "string"
              }
            }
            media_type: {
              type: "string"
              description: "Media type of this image, should always be \"image\""
            }
            model_releases: {
              type: "array"
              description: "List of model releases"
              items: {
                type: "object"
                description: "Model and property release metadata"
                properties: {
                  id: {
                    type: "string"
                    description: "ID of the model or property release"
                  }
                }
              }
            }
            models: {
              type: "array"
              description: "List of models"
              items: {
                type: "object"
                description: "Information about a human model or property that appears in media; used to search for assets that this model is in"
                required: ["id"]
                properties: {
                  id: {
                    type: "string"
                    description: "ID of the model"
                  }
                }
              }
            }
            releases: {
              type: "array"
              description: "List of all releases of this image"
              items: {
                type: "string"
              }
            }
            url: {
              type: "string"
              description: "Link to image information page; included only for certain accounts"
            }
          }
        }
      }
      errors: {
        type: "array"
        description: "Error list; appears only if there was an error"
        items: {
          type: "object"
          description: "Error object"
          required: ["message"]
          properties: {
            code: {
              type: "string"
              description: "The error code of this error"
            }
            data: {
              type: "string"
              description: "Debugging information about the error"
            }
            items: {
              type: "array"
              description: "A list of items that produced the error"
              items: {
                type: "object"
              }
            }
            message: {
              type: "string"
              description: "Specific details about this error"
            }
            path: {
              type: "string"
              description: "Internal code reference to the source of the error"
            }
          }
        }
      }
      message: {
        type: "string"
        description: "Server-generated message, if any"
      }
      page: {
        type: "integer"
        description: "Current page that is returned"
      }
      per_page: {
        type: "integer"
        description: "Number of results per page"
      }
      total_count: {
        type: "integer"
        description: "Total count of all results across all pages"
      }
    }
  }
}