Sections

API Methods

CHART.ARTISTS.GET

This api provides you the list of the top artists of a given country.

Parameters

country
A valid country code (default US)
page
Define the page number for paginated results
page_size
Define the page size for paginated results. Range is 1 to 100.
format
Decide the output type (json or xml)

Authentication

This method requires authentication.

Examples

Get an artist chart.
Request
I want the top 3 artists in Italy
chart.artists.get?page=1&page_size=3&country=it
Json Response
{
  "message": {
    "header": {
      "status_code": 200,
      "execute_time": 0.093447923660278
    },
    "body": {
      "artist_list": [
        {
          "artist": {
            "artist_id": 13916103,
            "artist_mbid": "",
            "artist_name": "Maroon 5 feat. Wiz Khalifa",
            "artist_alias_list": [

            ],
            "artist_rating": 81,
            "updated_time": "2012-04-17T10:22:35Z"
          }
        },
        {
          "artist": {
            "artist_id": 13639930,
            "artist_mbid": "ec6eaf55-d743-46ce-89b6-014943a2773c",
            "artist_name": "Emma",
            "artist_alias_list": [

            ],
            "artist_rating": 66,
            "updated_time": "2011-06-03T09:43:10Z"
          }
        },
        {
          "artist": {
            "artist_id": 13834953,
            "artist_mbid": "",
            "artist_name": "Gotye feat. Kimbra",
            "artist_alias_list": [

            ],
            "artist_rating": 84,
            "updated_time": "2012-04-07T18:22:16Z"
          }
        }
      ]
    }
  }
}
XML Response
<?xml version="1.0" encoding="utf-8"?>
<message>
  <header>
    <status_code>200</status_code>
    <execute_time>0.030817031860352</execute_time>
  </header>
  <body>
    <artist_list>
      <artist>
        <artist_id>13916103</artist_id>
        <artist_mbid/>
        <artist_name>Maroon 5 feat. Wiz Khalifa</artist_name>
        <artist_alias_list/>
        <artist_rating>81</artist_rating>
        <updated_time>2012-04-17T10:22:35Z</updated_time>
      </artist>
      <artist>
        <artist_id>13639930</artist_id>
        <artist_mbid>ec6eaf55-d743-46ce-89b6-014943a2773c</artist_mbid>
        <artist_name>Emma</artist_name>
        <artist_alias_list/>
        <artist_rating>66</artist_rating>
        <updated_time>2011-06-03T09:43:10Z</updated_time>
      </artist>
      <artist>
        <artist_id>13834953</artist_id>
        <artist_mbid/>
        <artist_name>Gotye feat. Kimbra</artist_name>
        <artist_alias_list/>
        <artist_rating>84</artist_rating>
        <updated_time>2012-04-07T18:22:16Z</updated_time>
      </artist>
    </artist_list>
  </body>
</message>