Last.fm Web Services

artist.getEvents

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

Example URLs

To get an example URL for this API call you'll first need to join Last.fm and then get an API account.

Params

artist (Required (unless mbid)] : The artist name
mbid (Optional) : The musicbrainz id for the artist
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.
page (Optiona) : The page number to fetch. Defaults to first page.
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 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
e.g. http://ws.audioscrobbler.com

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