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/artists/albums

Description

Display the artists' albums and let them be reordered or filtered by some basic parameter

Required parameters

client_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
order[]enum: {name, id, joindate, popularity_total, popularity_month, popularity_week, album_name, album_id, album_releasedate, album_name}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.
All rating orders (such as "popularity_total") follow a more specific norm: they use "desc" as default and will forcedly use "desc" even if you requested an "asc".
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 artist id
namestringAn artist name
namesearchstringSearch an artist by name (artist_name matching *seachquery*)
hasimageenum: {true, 1}Return only artists with an image
datebetweenstringFilter on the artist joining date (the date artists joined Jamendo). This parameter need a value to be used for a between closed interval. The "from" and "to" parts are both mandatory, must be separated by an underscore ("_"), and must be both in the yyyy-mm-dd format
album_id[]stringOne or more album id
album_namestringAn album name
album_datebetweenstringCreated between dates. This parameter need a value to be used for a between closed interval. The "from" and "to" parts are both mandatory, must be separated by an underscore ("_"), and must be both in the yyyy-mm-dd format
imagesizeThe cover size in pixel (if not specified, a default one will be returned)The album cover size in pixel (if not specified, a default one will be returned)

Sample

Call:

https://api.jamendo.com/v3.0/artists/albums/?client_id=your_client_id&format=jsonpretty&name=we+are+fm&album_datebetween=0000-00-00_2012-01-01

Response:

{
  "headers":{
    "status":"success",
    "code":0,
    "error_message":"",
    "warnings":"",
    "results_count":1
  },
  "results":[
    {
      "id":"376782",
      "name":"WE ARE FM",
      "website":"https:\/\/www.facebook.com\/wearefm",
      "joindate":"2011-12-29",
      "image":"https:\/\/usercontent.jamendo.com?type=artist&id=376782&width=300",
      "albums":[
        {
          "id":"104336",
          "name":"Season One",
          "releasedate":"2011-12-29",
          "image":"https:\/\/images.jamendo.com\/albums\/s104\/104336\/covers\/1.200.jpg"
        }
      ]
    }
  ]
}

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