API response object reference

All requests to the Songkick API return a response object in either JSON or XML. This page provides a reference for the format of these response objects.

List of response objects:

The Event object

Example

  {
    "id":11129128,
    "type":"Concert",
    "uri":"http://www.songkick.com/concerts/11129128-wild-flag-at-fillmore?utm_source=PARTNER_ID&utm_medium=partner",
    "displayName":"Wild Flag at The Fillmore (April 18, 2012)",
    "start": {
      "time":"20:00:00",
      "date":"2012-04-18",
      "datetime":"2012-04-18T20:00:00-0800"
    },
    "performance": [
      {
        "artist":{
          "uri":"http://www.songkick.com/artists/29835-wild-flag?utm_source=PARTNER_ID&utm_medium=partner",
          "displayName":"Wild Flag",
          "id":29835,
          "identifier":[]
        },
        "id":21579303,
        "displayName":"Wild Flag",
        "billingIndex":1,
        "billing":"headline"
      }
    ],
    "location": {
      "city":"San Francisco, CA, US",
      "lng":-122.4332937,
      "lat":37.7842398
    },
    "venue": {
      "id":6239,
      "displayName":"The Fillmore",
      "uri":"http://www.songkick.com/venues/6239-fillmore?utm_source=PARTNER_ID&utm_medium=partner",
      "lng":-122.4332937,
      "lat":37.7842398,
      "metroArea": {
        "uri":"http://www.songkick.com/metro-areas/26330-us-sf-bay-area?utm_source=PARTNER_ID&utm_medium=partner",
        "displayName":"SF Bay Area",
        "country": { "displayName":"US" },
        "id":26330,
        "state": { "displayName":"CA" }
      }
    },
    "status":"ok",
    "popularity":0.012763
  }
Attribute Type Description
id Integer The Songkick ID of the event
type String The type of the event. 'Concert' or 'Festival'
uri String The URI of the event on Songkick
displayName String A textual representation of the event
start Object An object representing the start time for this event
end Object Festivals only. An object representing the end time for this event
performance Array An array of Performance objects, representing individual artist performances at the event
location Object An object representing the location of the event, in the form of a Songkick Location object
venue Object An object representing the event venue, in the form of a simplified Songkick Venue object
status String The status of the event. 'ok', 'cancelled' or 'postponed'
ageRestriction String The age restriction for the event, if known (nullable)

The Performance object

Example

  {
    "artist":{
      "uri":"http://www.songkick.com/artists/29835-wild-flag?utm_source=PARTNER_ID&utm_medium=partner",
      "displayName":"Wild Flag",
      "id":29835,
      "identifier":[]
    },
    "displayName":"Wild Flag",
    "billingIndex":1,
    "id":21579303,
    "billing":"headline"
  }
Attribute Type Description
artist Object An object representing the performing artist, in the form of a simplified Songkick Artist object
displayName String A name of the artist in this performance
billingIndex Integer Where this performance features on the event billing (Starts at 1)
id Integer The Songkick performance ID
billing String The lineup billing of this performance. 'headline' or 'support'

The Artist object

Example

  {
    id: 253846,
    displayName: "Radiohead",
    uri: "http://www.songkick.com/artists/253846-radiohead?utm_source=45852&utm_medium=partner",
    identifier: [
      {
        href: "http://api.songkick.com/api/3.0/artists/mbid:a74b1b7f-71a5-4011-9441-d0b5e4122711.json",
        mbid: "a74b1b7f-71a5-4011-9441-d0b5e4122711"
      }
    ],
    onTourUntil: "2018-04-25"
  }
Attribute Type Description
id Integer The Songkick ID of the artist
displayName String The artist name, as it is displayed on Songkick
uri String The URI of the artist on Songkick
identifier Array MusicBrainz identifiers for this artist. It is possible that an artist has mutliple MusicBrainz IDs if we are not sure which is correct
onTourUntil Date The date until which this artist is on tour, in the form 'YYYY-MM-DD'. 'null' if this artist is not currently touring

The Location object

Location is a simplified object representing a city on Songkick.

Example

  {
    "city":"San Francisco, CA, US",
    "lat":37.7842398,
    "lng":-122.4332937
  }
Attribute Type Description
city String The name of the city, suffixed with the state and country name
lat Float The latitude value of this city (nullable)
lng Float The longitude value of this city (nullable)

The Venue object

Example

  {
    "id":17522,
    "displayName":"O2 Academy Brixton",
    "uri":"http://www.songkick.com/venues/17522-o2-academy-brixton",
    "city": {
      "id":24426,
      "uri":"http://www.songkick.com/metro-areas/24426-uk-london",
      "displayName":"London",
      "country": {"displayName":"UK"}
    },
    "street":"211 Stockwell Road",
    "zip":"SW9 9SL",
    "lat":51.4651268,
    "lng":-0.115187,
    "phone":"020 7771 3000",
    "website":"http://www.brixton-academy.co.uk",
    "capacity":4921,
    "description": "Brixton Academy is an award winning music venue situated in the heart of Brixton, South London.",
    "metroArea": {
      "id":24426,
      "uri":"http://www.songkick.com/metro-areas/24426-uk-london",
      "displayName":"London","country":{"displayName":"UK"}
    }
  }
Attribute Type Description
id Integer The Songkick ID of this venue
displayName String The name of this venue, as displayed on Songkick
uri String The URI of the venue on Songkick
city Object An object representing the city in which this venue is situated, in the form of a City object
lat Float The latitude value of this city (nullable)
lng Float The longitude value of this city (nullable)
street String The venue street (nullable)
zip String The venue zip/postal code (nullable)
phone String The venue phone number (nullable)
website String The venue website (nullable)
capacity Integer The capacity of the venue, if known (nullable)
description String A description of the venue (nullable)
metroArea Object An object containing further information about the location of this venue. This is mostly used for internal location identification so we recommend not using when integrating into a feature such as a listings page.

The City object

Example

  {
    "id":24426,
    "displayName":"London",
    "uri":"http://www.songkick.com/metro-areas/24426-uk-london",
    "country": {"displayName":"UK"}
  }
Attribute Type Description
id Integer The Songkick ID of this city
displayName String The name of this city, as displayed on Songkick
uri String The URI of the city on Songkick
country Object An object representing the city's country. This object contains a single displayName attribute which represents the name of the country

Get started

api requests

api responses

  • api object reference

For artists

We love feedback