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/autocomplete

Description

Using this method, you can build an autocomplete operating on Jamendo tracks, albums, artists and tags. By default all those four entities are considered, but you can choose to select just one or more of them through the 'entity' parameter. The string given with the 'prefix' parameter is considered as a prefix.
The results document contains the matches for each selected entity, in a number limited by the 'limit' parameter. You can see the matches count value, by turning the 'matchcount' paramter to on; that gives you also an idea of the metrics used for ordering results.
At the moment we cannot return the id of the matching entity, therefore, take into account that the lookup which in your implementation will probably follow the autocomplete request, is a lookup by name, that is a not unique entity.

Required parameters

client_id && prefix

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
limitstringHow many results to return per entity?
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.
prefixstringThe string to be searched as prefix of an entity name. The query on our side correspond to an sql [...WHERE name LIKE 'qvalue%' GROUP BY entity, name ORDER BY name, COUNT(*) DESC]. The minimum string length accepted is 2.
entity[]enum: {artists, albums, tracks, tags}By default the autocomplete method searchs for matches in every entity (tracks, albums, artists, tags). With this parameter, you can specify to search and return only some of those.
matchcountbooleanTurn this parameter value to 'true' if you want to get the match count returned with the match as well. The default value is false.
The matchcount of the entity 'tags' refers only to tracks and not albums or artist tags

Sample

Call:

https://api.jamendo.com/v3.0/autocomplete/?client_id=your_client_id&format=jsonpretty&limit=3&prefix=something&matchcount=1

Response:

{
  "headers":{
    "status":"success",
    "code":0,
    "error_message":"",
    "warnings":"",
    "results_count":4
  },
  "results":{
    "tags":[
      {
        "match":"something",
        "count":1
      },
      {
        "match":"somethingkindofvocalthingy",
        "count":1
      }
    ],
    "artists":[
      {
        "match":"something else (ludovic ribouleau)",
        "count":17
      },
      {
        "match":"somethingelseludovicribouleau",
        "count":17
      },
      {
        "match":"something",
        "count":2
      },
      {
        "match":"something else",
        "count":1
      }
    ],
    "tracks":[
      {
        "match":"something",
        "count":23
      },
      {
        "match":"somethingwrong",
        "count":14
      },
      {
        "match":"somethingelse",
        "count":13
      },
      {
        "match":"something else",
        "count":12
      }
    ],
    "albums":[
      {
        "match":"something",
        "count":34
      },
      {
        "match":"something about us",
        "count":20
      },
      {
        "match":"somethingaboutus",
        "count":20
      },
      {
        "match":"somethings gotta give",
        "count":19
      }
    ]
  }
}

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