action shutterstock_search_videos {
  label: "Search for videos"
  description: "This endpoint searches for videos. If you specify more than one search parameter, the API uses an AND condition. Array parameters can be specified multiple times; in this case, the API uses an AND or an OR condition with those values, depending on the parameter. You can also filter search terms out in the `query` parameter by prefixing the term with NOT."
  provider: shutterstock
  method: GET
  path: "/v2/videos/search"
  encoding: json
  input: {
    type: "object"
    properties: {
      added_date: {
        type: "string"
        format: "date"
      }
      added_date_end: {
        type: "string"
        format: "date"
      }
      added_date_start: {
        type: "string"
        format: "date"
      }
      aspect_ratio: {
        type: "string"
        enum: ["4_3", "16_9", "nonstandard"]
      }
      category: {
        type: "string"
      }
      contributor: {
        type: "array"
        items: {
          type: "string"
        }
      }
      contributor_country: {
        type: "array"
        items: {
          type: "string"
          format: "country-code-2"
        }
      }
      duration: {
        type: "integer"
      }
      duration_from: {
        type: "integer"
      }
      duration_to: {
        type: "integer"
      }
      fps: {
        type: "number"
      }
      fps_from: {
        type: "number"
      }
      fps_to: {
        type: "number"
      }
      keyword_safe_search: {
        type: "boolean"
      }
      language: {
        type: "string"
        description: "Language code"
        enum: ["ar", "bg", "bn", "cs", "da", "de", "el", "en", "es", "fi", "fr", "gu", "he", "hi", "hr", "hu", "id", "it", "ja", "kn", "ko", "ml", "mr", "nb", "nl", "or", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "ta", "te", "th", "tr", "uk", "ur", "vi", "zh", "zh-Hant"]
      }
      license: {
        type: "array"
        items: {
          type: "string"
          enum: ["commercial", "editorial"]
        }
      }
      model: {
        type: "array"
        items: {
          type: "string"
        }
      }
      page: {
        type: "integer"
      }
      people_age: {
        type: "string"
        enum: ["infants", "children", "teenagers", "20s", "30s", "40s", "50s", "60s", "older"]
      }
      people_ethnicity: {
        type: "array"
        items: {
          type: "string"
          enum: ["african", "african_american", "black", "brazilian", "chinese", "caucasian", "east_asian", "hispanic", "japanese", "middle_eastern", "native_american", "pacific_islander", "south_asian", "southeast_asian", "other"]
        }
      }
      people_gender: {
        type: "string"
        enum: ["male", "female", "both"]
      }
      people_model_released: {
        type: "boolean"
      }
      people_number: {
        type: "integer"
      }
      per_page: {
        type: "integer"
      }
      query: {
        type: "string"
      }
      resolution: {
        type: "string"
        enum: ["4k", "standard_definition", "high_definition"]
      }
      safe: {
        type: "boolean"
      }
      sort: {
        type: "string"
        enum: ["newest", "popular", "relevance", "random"]
      }
      view: {
        type: "string"
        enum: ["minimal", "full"]
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Video search results"
    required: ["data", "search_id", "total_count"]
    properties: {
      data: {
        type: "array"
        description: "List of videos"
        items: {
          type: "object"
          description: "Information about a video"
          required: ["id", "media_type", "contributor"]
          properties: {
            added_date: {
              type: "string"
              format: "date"
              description: "Date this video was added to the Shutterstock library"
            }
            affiliate_url: {
              type: "string"
              format: "uri"
              description: "Affiliate referral link; appears only for registered affiliate partners"
            }
            aspect: {
              type: "number"
              description: "Aspect ratio of this video in decimal format, such as 0.6667"
            }
            aspect_ratio: {
              type: "string"
              description: "Aspect ratio of the video as a ratio, such as 16:9"
            }
            assets: {
              type: "object"
              description: "Video asset information"
              properties: {
                "4k": {
                  type: "object"
                  description: "Video asset information"
                  properties: {
                    display_name: {
                      type: "string"
                      description: "Display name of this video size"
                    }
                    file_size: {
                      type: "integer"
                      description: "File size (in bytes) of this video size"
                    }
                    format: {
                      type: "string"
                      description: "Format of this video size"
                    }
                    fps: {
                      type: "number"
                      description: "Frames per second of this video size"
                    }
                    height: {
                      type: "integer"
                      description: "Height of this video size"
                    }
                    is_licensable: {
                      type: "boolean"
                      description: "Whether or not videos can be licensed in this video size"
                    }
                    width: {
                      type: "integer"
                      description: "Width of this video size"
                    }
                  }
                }
                hd: {
                  type: "object"
                  additionalProperties: true
                }
                preview_jpg: {
                  type: "object"
                  description: "URL object"
                  required: ["url"]
                  properties: {
                    url: {
                      type: "string"
                      description: "URL that can be used to download the unwatermarked, licensed asset"
                    }
                  }
                }
                preview_mp4: {
                  type: "object"
                  additionalProperties: true
                }
                preview_webm: {
                  type: "object"
                  additionalProperties: true
                }
                sd: {
                  type: "object"
                  additionalProperties: true
                }
                thumb_jpg: {
                  type: "object"
                  additionalProperties: true
                }
                thumb_jpgs: {
                  type: "object"
                  description: "List of URLs"
                  required: ["urls"]
                  properties: {
                    urls: {
                      type: "array"
                      description: "URLs"
                      items: {
                        type: "string"
                      }
                    }
                  }
                }
                thumb_mp4: {
                  type: "object"
                  additionalProperties: true
                }
                thumb_webm: {
                  type: "object"
                  additionalProperties: true
                }
                web: {
                  type: "object"
                  additionalProperties: true
                }
              }
            }
            categories: {
              type: "array"
              description: "List of categories"
              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: "Description of this video"
            }
            duration: {
              type: "number"
              description: "Duration of this video, in seconds"
            }
            has_model_release: {
              type: "boolean"
              description: "Whether or not this video has been released for use by the model appearing in it"
            }
            has_property_release: {
              type: "boolean"
              description: "Whether or not this video has received a release to show the landmark or property appearing in it"
            }
            id: {
              type: "string"
              description: "ID of the video"
            }
            is_adult: {
              type: "boolean"
              description: "Whether or not this video contains adult content"
            }
            is_editorial: {
              type: "boolean"
              description: "Whether or not this video is editorial content"
            }
            keywords: {
              type: "array"
              description: "Keywords associated with the content of this video"
              items: {
                type: "string"
              }
            }
            media_type: {
              type: "string"
              description: "Media type of this video, should always be \"video\""
            }
            models: {
              type: "array"
              description: "List of models in this video"
              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"
                  }
                }
              }
            }
            url: {
              type: "string"
              description: "Link to video information page; included only for certain accounts"
            }
          }
        }
      }
      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"
      }
      search_id: {
        type: "string"
        description: "Unique identifier for the search request"
      }
      total_count: {
        type: "integer"
        description: "Total count of all results across all pages"
      }
    }
  }
}