Skip to main content

List users’ liked tracks

GET /v0/users/me/liked/tracks

The liked tracks endpoint lets you list the liked tracks of a connected user. Users can add new tracks to their list on epidemicsound.com or via the Epidemic Sound app, giving them a smooth cross-device experience.

Query Parameters
  • offset int32

    Offset for the pagination. For this endpoint the number of results is fixed at 25, so the offset needs to be evenly divisible by 25.

Responses

Liked 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...