API Doc

API Methods

artist.getPastEvents

Get a paginated list of all the events this artist has played at in the past.

e.g. http://ws.audioscrobbler.com/2.0/?method=artist.getpastevents&artist=cher&api_key=b25b959554ed7...

Params

artist (Required (unless mbid)] :The name of the artist you would like to fetch event listings for.
mbid (Optional) : The musicbrainz id for the artist
page (Optional) :The page of results to return.
autocorrect[0|1] (Optional) : Transform misspelled artist names into correct artist names, returning the correct version instead. The corrected artist name will be returned in the response.
limit (Optional) : The number of results to fetch per page. Defaults to 50.
api_key (Required) : A Last.fm API key.

Auth

This service does not require authentication.

Sample Response

<events artist="Cher" url="http://www.last.fm/music/Cher/+events" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" page="1" perPage="50" total="41" totalPages="1">
  <event xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#">
    <id>1196301</id>
    <title>pRIvate</title>
    <artists>
      <artist>CSS</artist>
      <artist>Madonna</artist>
      <artist>Britney Spears</artist>
      <artist>Lady GaGa</artist>
      <artist>Cher</artist>
      <artist>RuPaul</artist>
      <headliner>CSS</headliner>
    </artists>
    <venue>
      <id>9064369</id>
      <name>Berlusconni´s</name>
      <location>
        <city>São Paulo</city>
        <country>Brazil</country>
        <street></street>
        <postalcode></postalcode>
        <geo:point>
          <geo:lat>-23.5576930875657</geo:lat>
          <geo:long>-46.669921875</geo:long>
        </geo:point>
      </location>
      <url>http://www.last.fm/venue/9064369+Berlusconni%C2%B4s</url>
      <website></website>
      <phonenumber></phonenumber>
      <image size="small"></image>
      <image size="medium"></image>
      <image size="large"></image>
      <image size="extralarge"></image>
      <image size="mega"></image>
    </venue>
    <startDate>Fri, 28 Aug 2009 04:42:01</startDate>
    <description>
      <![CDATA[<div class="bbcode">Rua Nestor Pestana, 189</div>]]>
    </description>
    <image size="small">http://userserve-ak.last.fm/serve/34/8834875.jpg</image>
    <image size="medium">http://userserve-ak.last.fm/serve/64/8834875.jpg</image>
    <image size="large">http://userserve-ak.last.fm/serve/126/8834875.jpg</image>
    <image size="extralarge">http://userserve-ak.last.fm/serve/252/8834875.jpg</image>
    <attendance>1</attendance>
    <reviews>0</reviews>
    <tag>lastfm:event=1196301</tag>
    <url>http://www.last.fm/event/1196301+pRIvate</url>
    <website></website>
    <tickets></tickets>
    <cancelled>0</cancelled>
  </event>
</events>

Other Formats

Also available as a feed in rss,ical formats

e.g. http://ws.audioscrobbler.com/2.0/artist/cher/pastevents.rss
e.g. http://ws.audioscrobbler.com/2.0/artist/cher/pastevents.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