Brand Brand
  • API docs(current)
  • Jamendo Apps
  • Jamendo-Dev GoogleGroup
  • Your account
  • Introduction

    • Rest-like API
    • Http[s] methods
    • Document format
    • Old (deprecated) Api
    • XML dump
    • Need an help?
    • Api Terms of Use
  • Authentication

    • App authentication
    • Oauth2 introduction
    • Workflow
    • Requirements
    • Wich API methods
    • OAuth2 Authorize request
    • OAuth2 Grant request (new)
    • OAuth2 Grant request (refresh)
  • Response Codes

  • Read Methods

    • albums
      • file
      • tracks
      • musicinfo
    • artists
      • tracks
      • albums
      • locations
      • musicinfo
    • autocomplete
    • feeds
    • playlists
      • file
      • tracks
    • radios
      • stream
    • reviews
      • albums
      • tracks
    • tracks
      • file
      • similar
    • users
      • artists
      • albums
      • tracks
  • Write Methods

    • setuser
      • fan
      • favorite
      • like
      • dislike
      • myalbum

Jamendo Api Documentation

GET /v3.0/tracks/similar

Description

Given the id of a Jamendo track, /tracks/similar let you find other similar Jamendo tracks. The 'no_artist' and 'no_album' filters aim to improve results by filtering out typically the album and/or artist relater to the song you are asking similarity for.
Similarity is mostly based on tags (genre, instrument, mood, etc), then acousticelectric, vocalinstrumental, and less important xartists_idstr, lang, gender.
Results are sorted by relevancy, and relevancy is represented by the field 'score' (max score is 1).

Required parameters

client_id && id

Parameter List

NameTypeDescription
client_idstringA Client Id provided by devportal.jamendo.com.
formatenum: {xml, json, jsonpretty}The results formatting type
callbackstringUse this parameter to have the response json wrapped in a callback function (jsonp technique). Such feature is enable only for json format and GET requests; if used in combination with other formats or a not-get request, the callback parameter is simply ignored and a warning is raised
offsetintegerThe position to start returning results from
limitstringThe max number of results to return. Default is 10 and Max is 200. Using the keyword 'all' still a max of 200 rows will be returned
fullcountbooleanSetting this parameter to true, the document header will be enriched with the 'results_fullcount' value, that is, the absolute number of rows the query would return if there was no limit and offset parameter. This value is of course very useful for pagination, but please: use it only if you really need it, as it affects performances! For this performance reasons such parameter is not available in most heavy methods.
imagesizeenum: {25, 35, 50, 55, 60, 65, 70, 75, 85, 100, 130, 150, 200, 300, 400, 500, 600}The cover size in pixel (if not specified, a default one will be returned)
audioformatenum: {mp31, mp32, ogg, flac}The audio format you wish to get in the 'audio' returned field: mp31 (96kbs), mp32 (VBR, good quality), ogg and flac are the available formats. If no 'audioformat' is declared, mp31 will be used by default.
audiodlformatenum: {mp31, mp32, ogg, flac}The audio download format you wish to get in the 'audiodownload' returned field: mp31 (96kbs), mp32 (VBR, good quality), ogg and flac are the available formats. If no 'audiodlformat' is declared, the value given to 'audioformat' will be used as default, and if neither 'audioformat' is declared, 'mp32' will be the default
include[]enum: {licenses, musicinfo, stats, lyrics}With this special parameter you can append to the results some additional fields, not returned by default.
idintegerThe id of the track which the returned similar tracks must be similar to
no_artistintegerIf you have the artist_id information of the track you are searching similarity for, you can use that artist_id to exclude his tracks from the results
no_albumintegerIf you have the artist_id information of the track you are searching similarity for, you can use that artist_id to exclude his tracks from the results

Sample

Call:

https://api.jamendo.com/v3.0/tracks/similar/?client_id=your_client_id&format=jsonpretty&limit=3&include=musicinfo&id=628410&no_album=72779

Response:

{
  "headers":{
    "status":"success",
    "code":0,
    "error_message":"",
    "warnings":"",
    "results_count":0
  },
  "results":[

  ]
}

API powered by 3scale API Management solution
  • Contact
  • Jobs
  • Api Terms of Use
Jamendo Music logo Jamendo Licensing logo