action shutterstock_search_sfx {
  label: "Search for sound effects"
  description: "This endpoint searches for sound effects. If you specify more than one search parameter, the API uses an AND condition."
  provider: shutterstock
  method: GET
  path: "/v2/sfx/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"
      }
      duration: {
        type: "integer"
      }
      duration_from: {
        type: "integer"
      }
      duration_to: {
        type: "integer"
      }
      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"]
      }
      page: {
        type: "integer"
      }
      per_page: {
        type: "integer"
      }
      query: {
        type: "string"
      }
      safe: {
        type: "boolean"
      }
      sort: {
        type: "string"
        enum: ["popular", "newest", "relevance", "random", "oldest"]
      }
      view: {
        type: "string"
        enum: ["minimal", "full"]
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Sound effects search results"
    required: ["data", "search_id", "total_count"]
    properties: {
      data: {
        type: "array"
        description: "List of tracks"
        items: {
          type: "object"
          description: "SFX metadata"
          required: ["id", "media_type", "contributor"]
          properties: {
            added_date: {
              type: "string"
              format: "date"
              description: "Date this sound effect was added to the Shutterstock library"
            }
            affiliate_url: {
              type: "string"
              description: "Affiliate referral link; appears only for registered affiliate partners"
            }
            artist: {
              type: "string"
              description: "Artist of the sound effect"
            }
            assets: {
              type: "object"
              description: "Files that are available as part of an sound effect asset"
              properties: {
                preview_mp3: {
                  type: "object"
                  description: "Information about a file that is part of an sound effect asset"
                  properties: {
                    file_size: {
                      type: "integer"
                      description: "File size of the sound effect"
                    }
                    url: {
                      type: "string"
                      description: "URL the sound effect is available at"
                    }
                  }
                }
                waveform: {
                  type: "object"
                  additionalProperties: true
                }
              }
            }
            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 sound effect"
            }
            duration: {
              type: "number"
              description: "Duration of this sound effect in seconds"
            }
            id: {
              type: "string"
              description: "Shutterstock ID of this sound effect"
            }
            keywords: {
              type: "array"
              description: "List of all keywords for this sound effect"
              items: {
                type: "string"
                description: "Keyword for this track"
              }
            }
            media_type: {
              type: "string"
              description: "Media type of this track; should always be \"sfx\""
            }
            releases: {
              type: "array"
              description: "List of all releases of this sound effect"
              items: {
                type: "string"
                description: "Release of this sound effect"
              }
            }
            title: {
              type: "string"
              description: "Title of this sound effect"
            }
            updated_time: {
              type: "string"
              format: "date-time"
              description: "Time this sound effect was last updated"
            }
            url: {
              type: "string"
            }
          }
        }
      }
      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: "ID of the search"
      }
      total_count: {
        type: "integer"
        description: "Total count of all results across all pages"
      }
    }
  }
}