Skip to main content

Similar tracks

GET /v0/tracks/:trackId/similar

The similar tracks endpoint allows developers to retrieve a list of tracks that are similar to a given reference track. This feature is designed to help users discover tracks that share similar characteristics, such as genre, mood, tempo, and more. This endpoint helps your users replace tracks that don't fit perfectly or discover multiple alternatives to a track they enjoy.

Path Parameters
  • trackId string required

    Track id

Query Parameters
  • offset int32

    Index of the entry track in the response

  • limit int32

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

Responses

Paginated list of similar tracks

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