API Doc

API Methods

user.getRecommendedEvents

Get a paginated list of all events recommended to a user by Last.fm, based on their listening profile.

Params

limit (Optional) : The number of results to fetch per page. Defaults to 20.
page (Optional) : The page number to scan to.
latitude (Optional) : Optionally find events at a particular location (must be paired with a valid longitude)
longitude (Optional) : Optionally find events at a particular location (must be paired with a valid latitude)
festivalsonly[0|1] (Optional) : Whether only festivals should be returned, or all events.
country (Optional) : Optionally find events in a particular country (use EITHER lat/long or country)
api_key (Required) : A Last.fm API key.
api_sig (Required) : A Last.fm method signature. See authentication for more information.
sk (Required) : A session key generated by authenticating a user via the authentication protocol.

Auth

This service requires authentication. Please see our authentication how-to.

Sample Response

<events user="RJ" page="1" perPage="20" totalPages="5" total="100">
  <event>
    <id>792218</id>
    <title>Night Slugs presents: TROUBLE & BASS</title>
    <artists>
      <artist>Drop the Lime</artist>
      <artist>Math Head</artist>
      <artist>L-VIS 1990</artist>
      <artist>The Captain</artist>
      <artist>Bok Bok</artist>
      <artist>Star Eyes</artist>
      <headliner>Drop the Lime</headliner>
    </artists>
    <venue>
      <name>East Village</name>
      <location>
        <city>London</city>
        <country>United Kingdom</country>
        <street>89 Great Eastern Street</street>
        <postalcode>EC2A 3HX</postalcode>
        <geo:point>
          <geo:lat>51.4916446565303</geo:lat>
          <geo:long>-0.17852783203125</geo:long>
        </geo:point>
      </location>
      <url>http://www.last.fm/venue/8910355</url>
    </venue>
    <startDate>Thu, 23 Oct 2008 21:00:00</startDate>
    <description>...</description>
    <image size="small">...</image>
    <image size="medium">...</image>
    <image size="large">...</image>
    <attendance>8</attendance>
    <reviews>0</reviews>
    <tag>lastfm:event=792218</tag>
    <url>http://www.last.fm/event/792218</url>
    <website>http://...</website>
    <tickets>
        <ticket supplier="...">http://...</ticket>
        ...
    </tickets>
  </event>
  ...
</events>

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