action shutterstock_search_editorial_images {
  label: "Search editorial images"
  description: "This endpoint searches for editorial images. If you specify more than one search parameter, the API uses an AND condition. For example, if you set the `category` parameter to \"Alone,Performing\" and also specify a `query` parameter, the results include only images that match the query and are in both the Alone and Performing categories. You can also filter search terms out in the `query` parameter by prefixing the term with NOT."
  provider: shutterstock
  method: GET
  path: "/v2/editorial/images/search"
  encoding: json
  input: {
    type: "object"
    properties: {
      category: {
        type: "string"
      }
      country: {
        type: "string"
        format: "country-code-3"
      }
      cursor: {
        type: "string"
      }
      date_end: {
        type: "string"
        format: "date"
      }
      date_start: {
        type: "string"
        format: "date"
      }
      per_page: {
        type: "integer"
      }
      query: {
        type: "string"
      }
      sort: {
        type: "string"
        enum: ["relevant", "newest", "oldest"]
      }
      supplier_code: {
        type: "array"
        items: {
          type: "string"
        }
      }
    }
    required: ["country"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Editorial search results"
    required: ["data", "total_count"]
    properties: {
      data: {
        type: "array"
        description: "Editorial items"
        items: {
          type: "object"
          description: "Metadata about editorial content"
          required: ["id"]
          properties: {
            aspect: {
              type: "number"
            }
            assets: {
              type: "object"
              description: "Asset information, including size and thumbnail URLs"
              properties: {
                medium_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"
                    }
                  }
                }
                original: {
                  type: "object"
                  additionalProperties: true
                }
                small_jpg: {
                  type: "object"
                  additionalProperties: true
                }
                thumb_170: {
                  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"
                    }
                  }
                }
                thumb_220: {
                  type: "object"
                  additionalProperties: true
                }
                watermark_1500: {
                  type: "object"
                  additionalProperties: true
                }
                watermark_450: {
                  type: "object"
                  additionalProperties: true
                }
              }
            }
            byline: {
              type: "string"
            }
            caption: {
              type: "string"
            }
            categories: {
              type: "array"
              description: "List of categories"
              items: {
                type: "object"
                description: "Name of an editorial category"
                properties: {
                  name: {
                    type: "string"
                  }
                }
              }
            }
            date_taken: {
              type: "string"
              format: "date"
            }
            description: {
              type: "string"
            }
            id: {
              type: "string"
            }
            keywords: {
              type: "array"
              items: {
                type: "string"
              }
            }
            special_instructions: {
              type: "string"
            }
            title: {
              type: "string"
            }
          }
        }
      }
      message: {
        type: "string"
        description: "Optional error message"
      }
      next: {
        type: "string"
        description: "Cursor value that represents the next page of results"
      }
      page: {
        type: "integer"
        description: "Current page of the response"
      }
      per_page: {
        type: "integer"
        description: "Number of results per page"
      }
      prev: {
        type: "string"
        description: "Cursor value that represents the previous page of results"
      }
      search_id: {
        type: "string"
        description: "Unique identifier for the search request"
      }
      total_count: {
        type: "integer"
        description: "Total count of all results"
      }
    }
  }
}