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:
Additionally, you may refine the search further using the following filters:
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.
Results are paginated and can be navigated with:
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
});
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
{
"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
}]
}
}
}
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
{
"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
}]
}
}
}
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
myJsonCallbackFunction({
"resultsPage": {
"totalEntries": 4,
"perPage": 50,
"page": 1,
// same JSON as previous example ....
}
})
