Web Services


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

Example URLs

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


long (Optional) : Specifies a longitude value 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)
location (Optional) : Specifies a location to retrieve events for (service returns nearby events by default)
distance (Optional) : Find events within a specified radius (in kilometres)
page (Optional) : The page number to fetch. Defaults to first page.
tag (Optional) : Specifies a tag to filter by.
festivalsonly[0|1] (Optional) : Whether only festivals should be returned, or all events.
limit (Optional) : The number of results to fetch per page. Defaults to 10.
api_key (Required) : A API key.


This service does not require authentication.

Sample Response

<events location="New York" page="1" totalpages="105" total="1050">
  <title>Nikka Costa</title>
    <artist>Nikka Costa</artist>
    <headliner>Nikka Costa</headliner>
    <name>Bowery Ballroom</name>
      <city>New York</city>
      <country>United States</country>
      <street>6 Delancey</street>
  <startDate>Mon, 30 Jun 2008</startDate>
  <description><![CDATA[Doors 8pm<br />
$20<br />
  <image size="small">...</image>
  <image size="medium">...</image>
  <image size="large">...</image>
    <ticket supplier="...">http://...</ticket>

Other Formats

Also available as a feed in rss,ical formats



  • 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
  • 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
  • 29 : Rate limit exceeded - Your IP has made too many requests in a short period