Search endpoints

Artist search

searchArtist($name, <$page>)

Example response:

{
  "info": {
    "num_results": 9,
    "limit": 100,
    "offset": 0,
    "query": "Bon Jovi",
    "type": "artist",
    "page": 1
  },
  "artists": [{
    "href": "spotify:artist:58lV9VcRSjABbAbfWS6skp",
    "name": "Bon Jovi",
    "popularity": "0.62129"
  },
  {
    "href": "spotify:artist:6h2bWHWTJL38N8dqocVaif",
    "name": "Jon Bon Jovi",
    "popularity": "0.40019"
  },
  {
    "href": "spotify:artist:2plNRHCXvi8mysjsNoBdK2",
    "name": "Karaoke - Bon Jovi",
    "popularity": "0.00153"
  }]
}

Album search

searchAlbum($title, <$page>)

Example response:

{
  "info": {
    "num_results": 113,
    "limit": 100,
    "offset": 0,
    "query": "foo",
    "type": "album",
    "page": 1
  },
  "albums": [{
    "name": "Greatest Hits",
    "popularity": "0.78891",
    "external-ids": [{
      "type": "upc",
      "id": "884977373295"
    }],
    "href": "spotify:album:1zCNrbPpz5OLSr6mSpPdKm",
    "artists": [{
      "href": "spotify:artist:7jy3rLJdDQY21OgRLCZ9sD",
      "name": "Foo Fighters"
    }],
    "availability":{
      "territories": "AD AE AF AG AI AL AM AN AO AQ AR AT AU AZ BA BB BD BE BF BG BH BI BJ BM BN BO BR BS BT BW BY BZ CA CD CF CG CH CI CK CL CM CN CO CR CU CV CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GH GI GL GM GN GP GQ GR GT GU GW GY HK HN HR HT HU ID IE IL IN IO IQ IR IS IT JM JO KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RU RW SA SB SC SD SE SG SH SI SK SL SM SN SO SR ST SV SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG US UY UZ VA VC VE VG VN VU WF WS YE YT ZA ZM ZW ZZ"
    }
  }]
}

Track search

searchTrack($title, <$page>)

Example response:

{
  "info": {
    "num_results": 162,
    "limit": 100,
    "offset": 0,
    "query": "You give love a bad name",
    "type": "track",
    "page": 1
  },
  "tracks": [{
    "album": {
      "released": "2005",
      "href": "spotify:album:5uduy563XjmdkLryIna87r",
      "name": "Cross Road (Sound & Vision)",
      "availability": {
        "territories": "AU GB IN NO PL SE SG"
      }
    },
    "name": "You Give Love A Bad Name",
    "popularity": "0.67464",
    "external-ids": [{
      "type": "isrc",
      "id": "USPR39402224"
    },
    {
      "type": "isrc",
      "id": "USPR39402224"
    }],
    "length": 223.866,
    "href": "spotify:track:3i17RhgJVzIHoXVoqybyYs",
    "artists": [{
      "href": "spotify:artist:58lV9VcRSjABbAbfWS6skp",
      "name": "Bon Jovi"
    }],
    "track-number": "7"
  },
  {
    "album": {
      "released": "2010",
      "href": "spotify:album:3Ad4QdO0EJr1c2livr9cmm",
      "name": "Bon Jovi Greatest Hits",
      "availability": {
        "territories": "AT AU BE CH CN CZ DE DK EE ES FI GB HR HU IE IN IT LT LV NL NO NZ PL PT RU SE SG SK UA ZA"
      }
    },
    "name": "You Give Love A Bad Name",
    "popularity": "0.62693",
    "external-ids": [{
      "type": "isrc",
      "id": "USPR39402224"
    }],
    "length": 223.146,
    "href": "spotify:track:61lqNlVRnWYiR9C7BDJw2l",
    "artists": [{
      "href": "spotify:artist:58lV9VcRSjABbAbfWS6skp",
      "name": "Bon Jovi"
    }],
    "track-number": "2"
  }]
}