API Doc

API Methods

user.getEvents

Get a list of upcoming events that this user is attending. Easily integratable into calendars, using the ical standard (see 'more formats' section below).

e.g. http://ws.audioscrobbler.com/2.0/?method=user.getevents&user=mokele&api_key=b25b959554ed76058ac...

Params

user (Required) : The user to fetch the events for.
page (Optional) : The page number to fetch. Defaults to first page.
limit (Optional) : The number of results to fetch per page. Defaults to 50.
festivalsonly[0|1] (Optional) : Whether only festivals should be returned, or all events.
api_key (Required) : A Last.fm API key.

Auth

This service does not require authentication.

Sample Response

<events user="mokele" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" total="23">
<event status="0">
  <id>544957</id>
  <title>Cult of Luna</title>
  <artists>
    <artist>Cult of Luna</artist>
    <artist>The Ocean</artist>
    <artist>Devil Sold His Soul</artist>
    <headliner>Cult of Luna</headliner>
  </artists>
  <venue>
    <name>Scala</name>
    <location>
      <city>London</city>
      <country>United Kingdom</country>
      <street>275 Pentonville Road, Kings Cross</street>
      <postalcode>N1 9NL</postalcode>
      <geo:point>
         <geo:lat>51.530767071208</geo:lat>
         <geo:long>-0.120263446498872</geo:long>
      </geo:point>
      <timezone>GMT</timezone>
    </location>
    <url>http://www.last.fm/venue/8777871</url>
  </venue>
  <startDate>Tue, 01 Jul 2008</startDate>
  <description></description>
  <image size="small">...</image>
  <image size="medium">...</image>
  <image size="large">...</image>
  <attendance>42</attendance>
  <reviews>0</reviews>
  <tag>lastfm:event=544957</tag>
  <url>http://www.last.fm/event/544957</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/user/rj/events.rss
e.g. http://ws.audioscrobbler.com/2.0/user/rj/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
8 : Operation failed - Something else went wrong
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.
13 : Invalid method signature supplied
16 : There was a temporary error processing your request. Please try again
26 : Suspended API key - Access for your account has been suspended, please contact Last.fm
29 : Rate limit exceeded - Your IP has made too many requests in a short period