Skip to main content

Get tracks matching an image

GET /v0/tracks/matching-image/:imageId

Gets tracks that match an image uploaded by the user

Path Parameters
  • imageId string required

    Image 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

  • genre string[]

    Id for genre

  • mood string[]

    Id for mood

Responses

Paginated list of 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...