API Doc

API Methods

artist.getEvents

Get a list of upcoming events for this artist. Easily integratable into calendars, using the ical standard (see feeds section below).

e.g. http://ws.audioscrobbler.com/2.0/?method=artist.getevents&artist=Cher&api_key=b25b959554ed76058...

Params

artist (Required) : The artist name in question
api_key (Required) : A Last.fm API key.

Auth

This service does not require authentication.

Sample Response

<events artist="Cher" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" total="4">
<event>
    <id>599858</id>
  <title>Cher</title>
  <artists>
    <artist>Cher</artist>
    <headliner>Cher</headliner>
  </artists>
  <venue>
    <name>The Colosseum at Caesars Palace</name>
    <location>
      <city>Las Vegas</city>
      <country>United States</country>
      <street></street>
      <postalcode></postalcode>
      <geo:point>
         <geo:lat>36.2265501474709</geo:lat>
         <geo:long>-115.0048828125</geo:long>
      </geo:point>
      <timezone>PST</timezone>
     </location>
    <url>http://www.last.fm/venue/8841108</url>
  </venue>
  <startDate>Sat, 16 Aug 2008</startDate>
  <startTime>19:30</startTime>
  <description></description>
  <image size="small">...</image>
  <image size="medium">...</image>
  <image size="large">...</image>
  <attendance>42</attendance>
  <reviews>0</reviews>
  <tag>lastfm:event=669027</tag>
  <url>http://www.last.fm/event/599858</url>
  <website>http://...</website>
  <tickets>
    <ticket supplier="...">http://...</ticket>
    ...
  </tickets>
</event>
...
</events>

Other Formats

Also available as a feed in rss,ical formats

e.g. http://ws.audioscrobbler.com/2.0/artist/cher/events.rss
e.g. http://ws.audioscrobbler.com/2.0/artist/cher/events.ical

Errors

2 : Invalid service -This service does not exist
3 : Invalid Method - No method with that name in this package
4 : Authentication Failed - You do not have permissions to access the service
5 : Invalid format - This service doesn't exist in that format
6 : Invalid parameters - Your request is missing a required parameter
7 : Invalid resource specified
9 : Invalid session key - Please re-authenticate
10 : Invalid API key - You must be granted a valid key by last.fm
11 : Service Offline - This service is temporarily offline. Try again later.
12 : Subscription Error - The user needs to be subscribed in order to do that
13 : Invalid method signature supplied
18 : This user has no free radio plays left. Subscription required.