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

Description

This method let you select and filter geographical locations which artists have declared as reference for themselves.
Geographical filtering can be expressed by the name of a country and/or a city, or by a longitude/latitude pair of coordinates (location_coords), combined with a km radius (location_radius).

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}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
namestring
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
haslocationbooleanReturn only artsist with (true) or withouth (false) locations
location_country[]enum: {AFG, ALB, DZA, ASM, AND, AGO, AIA, ATA, ATG, ARG, ARM, ABW, ASC, AUS, AUT, AZE, BHS, BHR, BGD, BRB, BLR, BEL, BLZ, BEN, BMU, BTN, BOL, BIH, BWA, BVT, BRA, IOT, VGB, BRN, BGR, BFA, BDI, KHM, CMR, CAN, CPV, BES, CYM, CAF, TCD, CHL, CHN, CXR, CPT, CCK, COL, COM, COG, COD, COK, CRI, HRV, CUB, CUW, CYP, CZE, CIV, DNK, DGA, DJI, DMA, DOM, ECU, EGY, SLV, GNQ, ERI, EST, ETH, FLK, FRO, FJI, FIN, FRA, GUF, PYF, ATF, GAB, GMB, GEO, DEU, GHA, GIB, GRC, GRL, GRD, GLP, GUM, GTM, GGY, GIN, GNB, GUY, HTI, HMD, HND, HKG, HUN, ISL, IND, IDN, IRN, IRQ, IRL, IMN, ISR, ITA, JAM, JPN, JEY, JOR, KAZ, KEN, KIR, XKK, KWT, KGZ, LAO, LVA, LBN, LSO, LBR, LBY, LIE, LTU, LUX, MAC, MKD, MDG, MWI, MYS, MDV, MLI, MLT, MHL, MTQ, MRT, MUS, MYT, MEX, FSM, MDA, MCO, MNG, MNE, MSR, MAR, MOZ, MMR, NAM, NRU, NPL, NLD, ANT, NCL, NZL, NIC, NER, NGA, NIU, NFK, PRK, MNP, NOR, OMN, PAK, PLW, PSE, PAN, PNG, PRY, PER, PHL, PCN, POL, PRT, PRI, QAT, ROU, RUS, RWA, REU, BLM, SHN, KNA, LCA, MAF, SPM, WSM, SMR, SAU, SEN, SRB, SYC, SLE, SGP, SXM, SVK, SVN, SLB, SOM, ZAF, SGS, KOR, SSD, ESP, LKA, VCT, SDN, SUR, SJM, SWZ, SWE, CHE, SYR, STP, TWN, TJK, TZA, THA, TLS, TGO, TKL, TON, TTO, TAA, TUN, TUR, TKM, TCA, TUV, UMI, VIR, UGA, UKR, ARE, GBR, USA, URY, UZB, VUT, VAT, VEN, VNM, WLF, ESH, YEM, ZMB, ZWE, ALA}The artist country (following ISO 3166_1 standard)
location_citystringThe artist city
location_coordsstringThe location coordinates, expressed in the format <latitude>_<longitude>, where both latitude and longitued obviously must be numbers
location_radiusintegerThe coords radius expressed in kilometers. With a radius of value 2, the request will return items located less than 2 km far away the coords point. The default value is 1km, but if no location_coords is declared, this paramter is simply ignored.

Sample

Call:

https://api.jamendo.com/v3.0/artists/locations/?client_id=your_client_id&format=jsonpretty&limit=5&haslocation=true&location_country=ITA&location_city=milan

Response:

{
  "headers":{
    "status":"success",
    "code":0,
    "error_message":"",
    "warnings":"",
    "results_count":5
  },
  "results":[
    {
      "id":"92",
      "name":"Haeresis",
      "website":"http:\/\/www.haeresis.org\/",
      "joindate":"2005-04-09",
      "image":"",
      "shorturl":"https:\/\/jamen.do\/a\/92",
      "shareurl":"https:\/\/www.jamendo.com\/artist\/92",
      "locations":[
        {
          "id":"472",
          "longitude":"9.18813",
          "latitude":"45.4637",
          "country":"ITA",
          "city":"Milan"
        }
      ]
    },
    {
      "id":"339997",
      "name":"Noctiflora",
      "website":"http:\/\/www.ekleipsi.com",
      "joindate":"2008-06-05",
      "image":"",
      "shorturl":"https:\/\/jamen.do\/a\/339997",
      "shareurl":"https:\/\/www.jamendo.com\/artist\/339997",
      "locations":[
        {
          "id":"472",
          "longitude":"9.18813",
          "latitude":"45.4637",
          "country":"ITA",
          "city":"Milan"
        }
      ]
    },
    {
      "id":"340000",
      "name":"Last Souls",
      "website":"http:\/\/www.ekleipsi.com",
      "joindate":"2008-06-05",
      "image":"",
      "shorturl":"https:\/\/jamen.do\/a\/340000",
      "shareurl":"https:\/\/www.jamendo.com\/artist\/340000",
      "locations":[
        {
          "id":"472",
          "longitude":"9.18813",
          "latitude":"45.4637",
          "country":"ITA",
          "city":"Milan"
        }
      ]
    },
    {
      "id":"342338",
      "name":"Over The Trees",
      "website":"http:\/\/www.facebook.com\/pages\/Over-The-Trees\/26106943220",
      "joindate":"2008-10-15",
      "image":"https:\/\/usercontent.jamendo.com?type=artist&id=342338&width=300",
      "shorturl":"https:\/\/jamen.do\/a\/342338",
      "shareurl":"https:\/\/www.jamendo.com\/artist\/342338",
      "locations":[
        {
          "id":"472",
          "longitude":"9.18813",
          "latitude":"45.4637",
          "country":"ITA",
          "city":"Milan"
        }
      ]
    },
    {
      "id":"342450",
      "name":"VV.AA.",
      "website":"http:\/\/www.jonicnoise.com",
      "joindate":"2008-10-19",
      "image":"",
      "shorturl":"https:\/\/jamen.do\/a\/342450",
      "shareurl":"https:\/\/www.jamendo.com\/artist\/342450",
      "locations":[
        {
          "id":"472",
          "longitude":"9.18813",
          "latitude":"45.4637",
          "country":"ITA",
          "city":"Milan"
        }
      ]
    }
  ]
}

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