User’s trackings

Tracked metro areas

Request

http://api.songkick.com/api/3.0/users/{username}/metro_areas/tracked.json?apikey={your_api_key}
http://api.songkick.com/api/3.0/users/{username}/metro_areas/tracked.xml?apikey={your_api_key}

Response

Paginated list of metro areas.

Tracked artists

Request

http://api.songkick.com/api/3.0/users/{username}/artists/tracked.json?apikey={your_api_key}
http://api.songkick.com/api/3.0/users/{username}/artists/tracked.xml?apikey={your_api_key}

Response

Paginated list of artists.

Muted artists

Request

http://api.songkick.com/api/3.0/users/{username}/artists/muted.json?apikey={your_api_key}
http://api.songkick.com/api/3.0/users/{username}/artists/muted.xml?apikey={your_api_key}

Response

Paginated list of muted artists. These are artists which the user once tracked but have been subsequently untracked.

Pagination

Results are paginated and can be navigated with:

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

As a special case for pagination of artists and metro-areas, per_page may be set to 'all' in order to receive all trackings in a single response. This might be slower for a large number of trackings.

Field filtering

The caller may specify a subset of fields to return in the response:

• fields=key[,key]* e.g. fields=id,displayName

Creation-time filtering

The caller may specify that only items created on or after a specified time/date should be included in the response:

• created_after=<timestamp> using ISO8601 format, e.g. 2012-02-29T13:37:00Z

Technical limitations mean that created_after can't be supported for muted artists at present.

Tracking for a metro area or artist

Request

http://api.songkick.com/api/3.0/users/{username}/trackings/metro_area:{metro_area_id}.json?apikey={your_api_key}
http://api.songkick.com/api/3.0/users/{username}/trackings/metro_area:{metro_area_id}.xml?apikey={your_api_key}

http://api.songkick.com/api/3.0/users/{username}/trackings/artist:{artist_id}.json?apikey={your_api_key}
http://api.songkick.com/api/3.0/users/{username}/trackings/artist:{artist_id}.xml?apikey={your_api_key}

Response

If the user is tracking the metro area or artist, returns a tracking. Otherwise a 404 response is returned.

Attendance (tracking an event)

Request

http://api.songkick.com/api/3.0/users/{username}/trackings/event:{event_id}.json?apikey={your_api_key}
http://api.songkick.com/api/3.0/users/{username}/trackings/event:{event_id}.xml?apikey={your_api_key}

Response

If the user is attending or did attend the event, returns a tracking with its attendance (im_going|i_might_go). Otherwise a 404 response is returned.

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
});