User’s trackings

This page lists the endpoints that return information about what a user is tracking on Songkick.

The metro area, artist and muted artist trackings endpoints all accept certain optional parameters that are outlined separately here.

Tracked metro areas

For more information about metro areas, see the Getting Started Guide.

Request

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

Parameters

Parameter	Type	Value
apikey	Required	Your API key.
username	Required	The username of the user to return tracked metro areas for.

Response

A paginated array of Songkick Metro Area objects.

Tracked artists

Request

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

Parameters

Parameter	Type	Value
apikey	Required	Your API key.
username	Required	The username of the user to return tracked artists for.

Response

A paginated array of Songkick Artist objects.

Muted artists

Muted artists are artists which the user once tracked but has subsequently untracked.

Request

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

Parameters

Parameter	Type	Value
apikey	Required	Your API key.
username	Required	The username of the user to return muted artists for.

Response

A paginated array of Songkick Artist objects.

Optional parameters

The metro area, artist and muted artist trackings endpoints all accept the following optional parameters:

Parameters

Parameter	Type	Value
page	Optional	Results are paginated. This specifies the results page number. (First page = 1)
per_page	Optional	The number of results to return in each page. 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.
fields	Optional	The caller may specify a subset of fields to return in the response, in the form fields=key[,key]*. For example fields=id,displayName
created_after	Optional	Specifies that only items created on or after a given time/date should be included in the response. Use ISO8601 format, e.g. 2018-02-28T13:37:00Z. Technical limitations mean that created_after can’t be supported for muted artists at present.

Determine if a user tracks a metro area or artist

Request

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

https://api.songkick.com/api/3.0/users/{username}/trackings/artist:{artist_id}.json?apikey={your_api_key}
https://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.

Determine if a user tracks an event

Request

https://api.songkick.com/api/3.0/users/{username}/trackings/event:{event_id}.json?apikey={your_api_key}
https://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.

On Songkick.com, the attendance “I might go” was renamed to Track event” then later renamed to "Interested." In order not to break existing API clients, this change was not reflected in the API. The “Interested” behaviour is exactly the same as “I might go” and "Track event", so clicking a “Interested” button on Songkick.com would return an “I might go” attendance in the API.