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

With the release of our new Web API the Metadata API is deprecated. We recommend you migrate your existing code to the new API as soon as possible to take advantage of its richer metadata and improved rate limits for registered applications. For now the Metadata API endpoints are supported, but they will be removed sometime in the future.

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>