Upcoming event search

http://api.songkick.com/api/3.0/events.json?apikey={your_api_key}
http://api.songkick.com/api/3.0/events.xml?apikey={your_api_key}

You must refine the search using one of the following filters:

  • artist_name
  • location

Additionally, you may refine the search further using the following filters:

  • min_date
  • max_date

Artist

You should use the artist API calls to get events for a specific artist. If you want to search by artist name, use the artist_name parameter.

Location

The following options can be used in the location parameter to specify how the content returned should be localised.

Location Type Description
sk:<id> Localise based on a Songkick metro area ID. Use our location search to find an ID.
geo:<lat>,<lng> Localise based on latitude / longitude. Use decimal degrees positive = north and east.
ip:<ip> Localise based on an IP address. Return all results if address is not present in our database.
clientip Localise based on IP address of client. Useful for purely client side implementations.
(nothing) Return all results.

Note that Songkick internally uses defined metro areas rather than latitude / longitude / distance to locate relevant content. This approach removes the need to specify an (often arbitrary) distance, and allows for more complex regions of interest (e.g. respecting country / state boundaries and/or geographical obstacles).

Date range

When specifying min_date or max_date, you need to use both parameters. Use the same value for both to get events for a single day. This search returns only upcoming events.

Pagination

Results are paginated and can be navigated with:

  • page (first page = 1)
  • per_page (max 50)

JSONP

When requesting data in JSON format, JSONP can be specified using the jsoncallback parameter. Here is an example of using JSONP from jQuery:

$.getJSON("http://api.songkick.com/api/3.0/events.json?location=clientip&apikey={your_api_key}&jsoncallback=?",
function(data){
// data is JSON response object
});

Request

Finding events that are near an ip (which is in London) for the artist Vampire Weekend.

http://api.songkick.com/api/3.0/events.json?apikey={your_api_key}&artist_name=vampire+weekend&location=ip:94.228.36.39

Response

{
    "resultsPage": {
        "page": 1,
        "totalEntries": 2,
        "perPage": 50,
        "results": {
            "event": [{
                "displayName": "Vampire Weekend at O2 Academy Brixton (February 16, 2010)",
                "type": "Concert",
                "uri": "http://www.songkick.com/concerts/3037536-vampire-weekend-at-o2-academy-brixton?utm_medium=partner&utm_source=PARTNER_ID",
                "venue": {
                    "lng": -0.1187418,
                    "displayName": "O2 Academy Brixton",
                    "lat": 51.4681089,
                    "id": 17522, ...
                },
                "location": {
                    "lng": -0.1187418,
                    "city": "London, UK",
                    "lat": 51.4681089
                },
                "start": {
                    "time": "19:30:00",
                    "date": "2010-02-16",
                    "datetime": "2010-02-16T19:30:00+0000"
                },
                "performance": [{
                    "artist": {
                        "uri": "http://www.songkick.com/artists/288696-vampire-weekend",
                        "displayName": "Vampire Weekend",
                        "id": 288696,
                        "identifier": [{"mbid": "af37c51c-0790-4a29-b995-456f98a6b8c9"}]
                    }
                   "displayName": "Vampire Weekend",
                   "billingIndex": 1,
                   "id": 5380281,
                   "billing": "headline"
                }],
                "id": 3037536
            },
            {
                "displayName": "Vampire Weekend at O2 Academy Brixton (February 17, 2010)",
                "type": "Concert",
                "uri": "http://www.songkick.com/concerts/3078766-vampire-weekend-at-o2-academy-brixton?utm_medium=partner&utm_source=PARTNER_ID",
                "venue": {
                    "lng": -0.1187418,
                    "displayName": "O2 Academy Brixton",
                    "lat": 51.4681089,
                    "id": 17522, ...
                },
                "location": {
                    "lng": -0.1187418,
                    "city": "London, UK",
                    "lat": 51.4681089
                },
                "start": {
                    "time": "19:30:00",
                    "date": "2010-02-17",
                    "datetime": "2010-02-17T19:30:00+0000"
                },
                "performance": [{
                    "artist": {
                        "uri": "http://www.songkick.com/artists/288696-vampire-weekend",
                        "displayName": "Vampire Weekend",
                        "id": 288696,
                        "identifier": [{"mbid": "af37c51c-0790-4a29-b995-456f98a6b8c9"}]
                    }
                    "displayName": "Vampire Weekend",
                    "billingIndex": 1,
                    "id": 5468321,
                    "billing": "headline"
                }],
                "id": 3078766
            }]
        }
    }
}

Request

Finding events for the Pixies between 1st October 2009 - 30th October 2009.

http://api.songkick.com/api/3.0/events.json?apikey={your_api_key}&artist_name=pixies&min_date=2009-10-01&max_date=2009-10-30

Response

{
  "resultsPage": {
    "totalEntries": 2,
    "perPage": 50,
    "page": 1,
    "results": {
      "event": [{
        "type": "Concert",
        "displayName": "Pixies at O2 Academy Brixton (October 9, 2009)",
        "venue": {
          "displayName": "O2 Academy Brixton",
          "id": 17522
        },
        "location": {
           city: "London, UK",
           lat: null,
           lng: null
        },
        "start": {
          "date": "2009-10-09",
          "time": "19:00:00"
        },
        "performance": [{
          "displayName": "Pixies",
          "id": 3681591
        }],
        "uri": "http://www.songkick.com/concerts/2342061-pixies-at-o2-academy-brixton",
        "id": 2342061
      },
      {
        "type": "Concert",
        "displayName": "Pixies at O2 Academy Brixton (October 6, 2009)",
        "venue": {
          "displayName": "O2 Academy Brixton",
          "id": 17522
        },
        "start": {
          "date": "2009-10-06",
          "time": "19:00:00"
        },
        "location": {
           city: "London, UK",
           lat: null,
           lng: null
        },
        "performance": [{
          "displayName": "Pixies",
          "id": 3681541
        }],
        "uri": "http://www.songkick.com/concerts/2342046-pixies-at-o2-academy-brixton",
        "id": 2342046
      }]
    }
  }
}
                

Request

Using jsoncallback parameter.

http://api.songkick.com/api/3.0/events.json?apikey={your_api_key}&artist_name=pixies&min_date=2009-10-01&max_date=2009-10-30&jsoncallback=myJsonCallbackFunction

Response

myJsonCallbackFunction({
  "resultsPage": {
    "totalEntries": 4,
    "perPage": 50,
    "page": 1,
    // same JSON as previous example ....
  }
})
                

We love feedback

Updated at 22/11/2010 07:12 PM by Sabrina