action shutterstock_get_track {
  label: "Get details about audio tracks"
  description: "This endpoint shows information about a track, including its genres, instruments, and other attributes."
  provider: shutterstock
  method: GET
  path: "/v2/audio/{id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      id: {
        type: "integer"
      }
      search_id: {
        type: "string"
      }
      view: {
        type: "string"
        enum: ["minimal", "full"]
      }
    }
    required: ["id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Audio metadata"
    required: ["contributor", "id", "media_type"]
    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"
      }
    }
  }
}