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

Description

With this method you can get the main information about a user. We chose to let this method be only a 'look up' rather than a 'search' to afford just a light access to our user base.

Required parameters

client_id && (id || access_token || name)

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
order[]enum: {}Sort results by the queried field(s).
You can specify whether to follow an ascending or descending order adding the suffix _asc or _desc to every field (order=field_asc). Asc is the default one.
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.
id[]integerOne or more user id (without requiring any access token)
access_tokenstringA valid access token corresponding to the Jamendo user you want to get data for. The authorization token is obtained through the OAuth2 process.
namestringOne or more user names
imagesizeenum: {30, 50, 100}The user avatar size in pixel (if not specified, a default one will be returned)

Sample

Call:

https://api.jamendo.com/v3.0/users/?client_id=your_client_id&format=jsonpretty&name=claudod

Response:

{
  "headers":{
    "status":"success",
    "code":0,
    "error_message":"",
    "warnings":"",
    "results_count":1
  },
  "results":[
    {
      "name":"claudod",
      "dispname":"claudod",
      "id":"972174",
      "lang":"en",
      "creationdate":"2010-10-17",
      "image":"https:\/\/images.jamendo.com\/users\/s972\/972174\/covers\/1.50.jpg"
    }
  ]
}

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