action shutterstock_get_track_list {
  label: "List audio tracks"
  description: "This endpoint lists information about one or more audio tracks, including the description and publication date."
  provider: shutterstock
  method: GET
  path: "/v2/audio"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "array"
        items: {
          type: "string"
        }
      }
      search_id: {
        type: "string"
      }
      view: {
        type: "string"
        enum: ["minimal", "full"]
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    description: "List of tracks"
    properties: {
      data: {
        type: "array"
        description: "Tracks"
        items: {
          type: "object"
          description: "Audio metadata"
          required: ["id", "media_type", "contributor"]
          properties: {
            added_date: {
              type: "string"
              format: "date"
              description: "Date this track was added to the Shutterstock library"
            }
            affiliate_url: {
              type: "string"
              description: "Affiliate referral link; appears only for registered affiliate partners"
            }
            album: {
              type: "object"
              description: "Album metadata"
              required: ["id", "title"]
              properties: {
                id: {
                  type: "string"
                  description: "The album ID"
                }
                title: {
                  type: "string"
                  description: "The album title"
                }
              }
              additionalProperties: false
            }
            artists: {
              type: "array"
              description: "List of artists"
              items: {
                type: "object"
                description: "Metadata about the artist that created the media"
                required: ["name"]
                properties: {
                  name: {
                    type: "string"
                    description: "The artist's name"
                  }
                }
              }
            }
            assets: {
              type: "object"
              description: "Files that are available as part of an audio asset"
              properties: {
                album_art: {
                  type: "object"
                  description: "Information about a file that is part of an audio asset"
                  properties: {
                    file_size: {
                      type: "integer"
                      description: "File size of the track"
                    }
                    url: {
                      type: "string"
                      description: "URL the track is available at"
                    }
                  }
                }
                clean_audio: {
                  type: "object"
                  additionalProperties: true
                }
                original_audio: {
                  type: "object"
                  additionalProperties: true
                }
                preview_mp3: {
                  type: "object"
                  additionalProperties: true
                }
                preview_ogg: {
                  type: "object"
                  additionalProperties: true
                }
                shorts_loops_stems: {
                  type: "object"
                  description: "Links for Shorts, Loops and Stems previews"
                  properties: {
                    loops: {
                      type: "object"
                    }
                    shorts: {
                      type: "object"
                    }
                    stems: {
                      type: "object"
                    }
                  }
                }
                waveform: {
                  type: "object"
                  additionalProperties: true
                }
              }
            }
            bpm: {
              type: "integer"
              description: "BPM (beats per minute) of this track"
            }
            contributor: {
              type: "object"
              description: "Information about a contributor"
              required: ["id"]
              properties: {
                id: {
                  type: "string"
                  description: "ID of the contributor"
                }
              }
            }
            deleted_time: {
              type: "string"
              format: "date-time"
            }
            description: {
              type: "string"
              description: "Description of this track"
            }
            duration: {
              type: "number"
              description: "Duration of this track in seconds"
            }
            genres: {
              type: "array"
              description: "List of all genres for this track"
              items: {
                type: "string"
                description: "Genre that is associated with this track"
              }
            }
            id: {
              type: "string"
              description: "Shutterstock ID of this track"
            }
            instruments: {
              type: "array"
              description: "List of all instruments that appear in this track"
              items: {
                type: "string"
                description: "Instrument that appears in this track"
              }
            }
            is_adult: {
              type: "boolean"
              description: "Whether or not this track contains adult content"
            }
            is_instrumental: {
              type: "boolean"
              description: "Whether or not this track is purely instrumental (lacking lyrics)"
            }
            isrc: {
              type: "string"
            }
            keywords: {
              type: "array"
              description: "List of all keywords for this track"
              items: {
                type: "string"
                description: "Keyword for this track"
              }
            }
            language: {
              type: "string"
              description: "Language of this track's lyrics"
            }
            lyrics: {
              type: "string"
              description: "Lyrics of this track"
            }
            media_type: {
              type: "string"
              description: "Media type of this track; should always be \"audio\""
            }
            model_releases: {
              type: "array"
              description: "List of all model releases for this track"
              items: {
                type: "object"
                description: "Model and property release metadata"
                properties: {
                  id: {
                    type: "string"
                    description: "ID of the model or property release"
                  }
                }
              }
            }
            moods: {
              type: "array"
              description: "List of all moods of this track"
              items: {
                type: "string"
                description: "Mood of this track"
              }
            }
            published_time: {
              type: "string"
              format: "date-time"
              description: "Time this track was published"
            }
            recording_version: {
              type: "string"
              description: "Recording version of this track"
            }
            releases: {
              type: "array"
              description: "List of all releases of this track"
              items: {
                type: "string"
                description: "Release of this track"
              }
            }
            similar_artists: {
              type: "array"
              description: "List of all similar artists of this track"
              items: {
                type: "object"
                additionalProperties: true
              }
            }
            submitted_time: {
              type: "string"
              format: "date-time"
              description: "Time this track was submitted"
            }
            title: {
              type: "string"
              description: "Title of this track"
            }
            updated_time: {
              type: "string"
              format: "date-time"
              description: "Time this track was last updated"
            }
            url: {
              type: "string"
            }
            vocal_description: {
              type: "string"
              description: "Vocal description of this track"
            }
          }
        }
      }
      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"
      }
    }
  }
}