API Doc

API Methods

venue.getEvents

Get a list of upcoming events at this venue.

e.g. http://ws.audioscrobbler.com/2.0/?method=venue.getevents&api_key=b25b959554ed76058ac220b7b2e0a0...

Params

venue (Required) :The id for the venue you would like to fetch event listings for.
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 venue="Cafe OTO">
  <event>
    <id>835264</id>
    <title>Calling Signals 08</title>
    <artists>
      <artist>Frode Gjerstad</artist>
      <artist>Lol Coxhill</artist>
      <artist>Paal Nilssen-Love</artist>
      <artist>Nick Stephens</artist>
      <headliner>Frode Gjerstad</headliner>
    </artists>
    <venue>
      <id>8908030</id>
      <name>Cafe OTO</name>
      <location>
        <city>London</city>
        <country>United Kingdom</country>
        <street>20 Ashwin St</street>
        <postalcode>E8 3DL</postalcode>
        <geo:point>
          <geo:lat>51.4916446565303</geo:lat>
          <geo:long>-0.17852783203125</geo:long>
        </geo:point>
      </location>
      <url>http://www.last.fm/venue/8908030</url>
    </venue>
    <startDate>Mon, 15 Dec 2008 20:00:00</startDate>
    <description>...</description>
    <image size="small">...</image>
    <image size="medium">...</image>
    <image size="large">...</image>
    <attendance>2</attendance>
    <reviews>0</reviews>
    <tag>lastfm:event=835264</tag>
    <url>http://www.last.fm/event/835264</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/venue/8908030/events.rss
e.g. http://ws.audioscrobbler.com/2.0/venue/8908030/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