API Doc

API Methods

geo.getEvents

Get all events in a specific location by country or city name.

e.g. http://ws.audioscrobbler.com/2.0/?method=geo.getevents&location=madrid&api_key=b25b959554ed7605...

Params

location (Optional) : Specifies a location to retrieve events for (service returns nearby events by default)
lat (Optional) : Specifies a latitude value to retrieve events for (service returns nearby events by default)
long (Optional) : Specifies a longitude value to retrieve events for (service returns nearby events by default)
page (Optional) : Display more results by pagination
distance (Optional) : Find events within a specified radius (in kilometres)
api_key (Required) : A Last.fm API key.

Auth

This service does not require authentication.

Sample Response

<events location="New York" page="1" totalpages="105" total="1050">
<event>
  <id>640418</id>
  <title>Nikka Costa</title>
  <artists>
    <artist>Nikka Costa</artist>
    <headliner>Nikka Costa</headliner>
  </artists>
  <venue>
    <name>Bowery Ballroom</name>
    <location>
      <city>New York</city>
      <country>United States</country>
      <street>6 Delancey</street>
      <postalcode>10002</postalcode>
      <geo:point>
         <geo:lat>40.71417</geo:lat>
         <geo:long>-74.00639</geo:long>
      </geo:point>
      <timezone>EST</timezone>
    </location>
    <url>http://www.last.fm/venue/8779095</url>
  </venue>
  <startDate>Mon, 30 Jun 2008</startDate>
  <startTime>20:00</startTime>
  <description><![CDATA[Doors 8pm<br />
$20<br />
18+]]></description>
  <image size="small">...</image>
  <image size="medium">...</image>
  <image size="large">...</image>
 <attendance>42</attendance>
  <reviews>0</reviews>
  <tag>lastfm:event=640418</</tag>
  <url>http://www.last.fm/event/640418</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/geo/spain/events.rss
e.g. http://ws.audioscrobbler.com/2.0/geo/spain/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.