The Metadata API’s Lookup service makes it possible for applications to retrieve items from Spotify’s extensive music catalog.

 

Lookup an Artist

Endpoints

http://ws.spotify.com/lookup/1/
http://ws.spotify.com/lookup/1/.json/

Request Query Arguments

uri
Required. A Spotify artist URI.
extras
Optional. A comma-separated list of words that defines the detail level expected in the response:

  • album — returns basic information about all the albums the artist is featured in.
  • albumdetail — returns detailed information about all the albums the artist is featured in.

Example Requests

Example Responses

Basic XML response with no extras

<?xml version="1.0" encoding="utf-8"?>
<artist xmlns="http://www.spotify.com/ns/music/1">
  <name>Basement Jaxx</name>
</artist>

XML response when extras=album

<?xml version="1.0" encoding="utf-8"?>
<artist xmlns="http://www.spotify.com/ns/music/1">
  <name>Basement Jaxx</name>
  <albums>
    <album href="spotify:album:4iMh930ASjKvgFhA19mVGa">
      <name>Jaxx Unreleased</name>
      <artist href="spotify:artist:4YrKBkKSVeqDamzBPWVnSJ">
        <name>Basement Jaxx</name>
      </artist>
    </album>
    ...
  </albums>
</artist>

XML response when extras=albumdetail

<?xml version="1.0" encoding="utf-8"?>
<artist xmlns="http://www.spotify.com/ns/music/1">
  <name>Basement Jaxx</name>
  <albums>
    <album href="spotify:album:0vQbb9UeAU7R8wk3ZAjNx6">
      <name>Crazy Itch Radio</name>
      <artist href="spotify:artist:4YrKBkKSVeqDamzBPWVnSJ">
        <name>Basement Jaxx</name>
      </artist>
      <released>2006</released>
      <id type="upc">634904020583</id>
    </album>
    ...
  </albums>
</artist>

Lookup an Album

Endpoints

http://ws.spotify.com/lookup/1/
http://ws.spotify.com/lookup/1/.json/

Request Query Arguments

uri
Required. A Spotify album URI.
extras
Optional. A comma-separated list of words that defines the detail level expected in the response:

  • track — returns basic information about all tracks in the album.
  • trackdetail — returns detailed information about all tracks in the album.

Example Requests

Example Responses

Basic XML Response

<?xml version="1.0" encoding="utf-8"?>
<album xmlns="http://www.spotify.com/ns/music/1">
  <name>Remedy</name>
  <artist href="spotify:artist:4YrKBkKSVeqDamzBPWVnSJ">
    <name>Basement Jaxx</name>
  </artist>
  <released>1999</released>
  <id type="upc">634904012922</id>
  <availability>
    <territories>AD AE AF AG AL AM AN AO AR AS AT AU AW AZ BA BB BD BE BF BG BH BI BJ BO BR BS BT BW BY BZ CA CC CF CG CH CL CM CN CO CR CU CX CY CZ DE DJ DK DM DO DZ EC EE EG ER ES ET FI FJ FK FR GA GB GD GE GF GH GI GL GM GN GP GQ GR GT GW GY HK HM HN HR HT HU ID IE IL IN IQ IR IS IT JM JO JP 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 ME MG MK ML MN MO MQ MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PG PH PK PL PM PR PT PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SK SL SM SN SO SR ST SV SY SZ TC TD TG TH TJ TK TM TR TV TW TZ UA UG UY UZ VA VC VE VG VI VN VU WF WS YE ZA ZM</territories>
  </availability>
</album>

XML response when extras=track

<?xml version="1.0" encoding="utf-8"?>
<album xmlns="http://www.spotify.com/ns/music/1">
  <name>Remedy</name>
  <artist href="spotify:artist:4YrKBkKSVeqDamzBPWVnSJ">
    <name>Basement Jaxx</name>
  </artist>
  <released>1999</released>
  <id type="upc">634904012922</id>
  <tracks>
    <track href="spotify:track:3zBhJBEbDD4a4SO1EaEiBP">
      <name>Rendez-vu</name>
      <artist href="spotify:artist:4YrKBkKSVeqDamzBPWVnSJ">
        <name>Basement Jaxx</name>
      </artist>
      <available>true</available>
    </track>
    ...
  </tracks>
  <availability>
    <territories>AD AE AF AG AL AM AN AO AR AS AT AU AW AZ BA BB BD BE BF BG BH BI BJ BO BR BS BT BW BY BZ CA CC CF CG CH CL CM CN CO CR CU CX CY CZ DE DJ DK DM DO DZ EC EE EG ER ES ET FI FJ FK FR GA GB GD GE GF GH GI GL GM GN GP GQ GR GT GW GY HK HM HN HR HT HU ID IE IL IN IQ IR IS IT JM JO JP 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 ME MG MK ML MN MO MQ MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PG PH PK PL PM PR PT PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SK SL SM SN SO SR ST SV SY SZ TC TD TG TH TJ TK TM TR TV TW TZ UA UG UY UZ VA VC VE VG VI VN VU WF WS YE ZA ZM</territories>
  </availability>
</album>

XML response when extras=trackdetail

<?xml version="1.0" encoding="utf-8"?>
<album xmlns="http://www.spotify.com/ns/music/1">
  <name>Remedy</name>
  <artist href="spotify:artist:4YrKBkKSVeqDamzBPWVnSJ">
    <name>Basement Jaxx</name>
  </artist>
  <released>1999</released>
  <id type="upc">634904012922</id>
  <tracks>
    <track href="spotify:track:3zBhJBEbDD4a4SO1EaEiBP">
      <name>Rendez-vu</name>
      <artist href="spotify:artist:4YrKBkKSVeqDamzBPWVnSJ">
        <name>Basement Jaxx</name>
      </artist>
      <available>true</available>
      <id type="isrc">GBBKS9900090</id>
      <disc-number>1</disc-number>
      <track-number>1</track-number>
      <length>345.000000</length>
      <popularity>0.457756996155</popularity>
    </track>
    ...
  </tracks>
  <availability>
    <territories>AD AE AF AG AL AM AN AO AR AS AT AU AW AZ BA BB BD BE BF BG BH BI BJ BO BR BS BT BW BY BZ CA CC CF CG CH CL CM CN CO CR CU CX CY CZ DE DJ DK DM DO DZ EC EE EG ER ES ET FI FJ FK FR GA GB GD GE GF GH GI GL GM GN GP GQ GR GT GW GY HK HM HN HR HT HU ID IE IL IN IQ IR IS IT JM JO JP 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 ME MG MK ML MN MO MQ MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PG PH PK PL PM PR PT PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SK SL SM SN SO SR ST SV SY SZ TC TD TG TH TJ TK TM TR TV TW TZ UA UG UY UZ VA VC VE VG VI VN VU WF WS YE ZA ZM</territories>
  </availability>
</album>

Lookup a Track

Endpoints

http://ws.spotify.com/lookup/1/
http://ws.spotify.com/lookup/1/.json/

Request Query Arguments

uri
Required. A Spotify album URI.

Example Requests

Example Response

<?xml version="1.0" encoding="utf-8"?>
<track xmlns="http://www.spotify.com/ns/music/1">
  <name>Bøn Fra Helvete - Live</name>
  <artist href="spotify:artist:1s1DnVoBDfp3jxjjew8cBR">
    <name>Kaizers Orchestra</name>
  </artist>
  <album href="spotify:album:6K8NUknbPh5TGaKeZdDwSg">
    <name>Mann Mot Mann</name>
    <availability>
      <territories>AD AE AF AG AI AL AM AN AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BM BN BO BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CX 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 GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IN IO IQ IR IS IT JM JO JP 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 ME MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF 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 RS RU RW SA SB SC SD SE SG SH SI SJ 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 UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW</territories>
    </availability>
  </album>
  <available>true</available>
  <id type="isrc">NOPVA0203020</id>
  <track-number>2</track-number>
  <length>317.040000</length>
  <popularity>0.40003</popularity>
</track>