Skip to main content

List tracks based on mood, genre or BPM

GET /v0/tracks

The tracks endpoint allows you to list all tracks based on a specified mood, genre or BPM.

Query Parameters
  • genre string[]

    Id for genre

  • mood string[]

    Id for mood

  • bpmMin int32

    BPM Min

  • bpmMax int32

    BPM Max

  • limit int32

    Max number of entries returned in the response, default 50 and max 100

  • offset int32

    Index of the entry track in the response

Responses

Tracks response

Schema
  • tracks object[] required
  • Array [
  • id string required

    Unique ID of the track

  • mainArtists string[] required

    The main artist that created the track.

  • featuredArtists string[] required

    Additional artists that contributed to the track.

  • title string required

    Title of the track

  • bpm int32 required

    Beats per minute for the track.

  • length int32 required

    Track length in seconds

  • moods object[] required

    Lists the moods of the track.

  • Array [
  • id string required

    Unique ID of the mood

  • name string required

    Name of the mood

  • ]
  • genres object[] required

    Lists the genres of the track.

  • Array [
  • id string required
  • name string required
  • parent object
  • id string required

    Unique ID of the parent genre

  • name string required

    Name of the parent genre

  • ]
  • images object
  • default string nullable
  • L string nullable
  • M string nullable
  • S string nullable
  • XS string nullable
  • waveformUrl string required

    Reference to the waveform as a json object.

  • hasVocals boolean nullable

    Set to true if the track has vocals. Set to false for instrumental tracks.

  • added string required

    The date the track was released in the format YYYY-mm-dd.

  • tierOption string nullable

    Possible values: [PAID, FREE]

  • isExplicit boolean nullable
  • isPreviewOnly boolean
  • ]
  • pagination object required
  • page int32 required
  • limit int32 required
  • offset int32
  • links object required
  • next string nullable
  • prev string nullable
  • aggregations object
  • moods object[]
  • Array [
  • id string
  • name string
  • count int32
  • ]
  • genres object[]
  • Array [
  • id string
  • name string
  • count int32
  • ]
Loading...