The Metadata API’s search service lets applications search Spotify’s music catalog for items that match a keyword string.

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.
Please, have a look at the Web API Search endpoint.

Search Albums

Endpoints

http://ws.spotify.com/search/1/album

http://ws.spotify.com/search/1/album.json

Request Query Arguments

q
Required. The search string encoded in UTF-8 format.
page
Optional. The page of the result set to return. Default = 1.

Example Requests

Example Response

<?xml version="1.0" encoding="utf-8"?>
<albums xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns="http://www.spotify.com/ns/music/1">
  <opensearch:Query role="request" startPage="1" searchTerms="foo"/>
  <opensearch:totalResults>65</opensearch:totalResults>
  <opensearch:startIndex>0</opensearch:startIndex>
  <opensearch:itemsPerPage>100</opensearch:itemsPerPage>
  <album href="spotify:album:1zCNrbPpz5OLSr6mSpPdKm">
    <name>Greatest Hits</name>
    <artist href="spotify:artist:7jy3rLJdDQY21OgRLCZ9sD">
      <name>Foo Fighters</name>
    </artist>
    <id type="upc">884977373295</id>
    <popularity>0.83412</popularity>
    <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 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 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 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 UY UZ VA VC VE VG VN VU WF WS YE YT ZA ZM ZW</territories>
    </availability>
  </album>
  ...
</albums>

Search Artists

Endpoints

http://ws.spotify.com/search/1/artist

http://ws.spotify.com/search/1/artist.json

Request Query Arguments

q
Required. The search string encoded in UTF-8 format.
page
Optional. The page of the result set to return. Default = 1.

Example Requests

Example Response

<?xml version="1.0" encoding="utf-8"?>
<artists xmlns="http://www.spotify.com/ns/music/1"
    xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">
  <opensearch:Query role="request" searchTerms="foo" startPage="1"/>
  <opensearch:totalResults>4711</opensearch:totalResults>
  <opensearch:startIndex>0</opensearch:startIndex>
  <opensearch:itemsPerPage>100</opensearch:itemsPerPage>
  <artist href="spotify:artist:7jy3rLJdDQY21OgRLCZ9sD">
    <name>Foo Fighters</name>

    <popularity>0.76</popularity>
  </artist>
  <!-- ... -->
</artists>

Search Tracks

Endpoints

http://ws.spotify.com/search/1/track

http://ws.spotify.com/search/1/track.json

Request Query Arguments

q
Required. The search string encoded in UTF-8 format.
page
Optional. The page of the result set to return. Default = 1.

Example Requests

Example Response

<?xml version="1.0" encoding="utf-8"?>
<tracks xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns="http://www.spotify.com/ns/music/1">
  <opensearch:Query role="request" startPage="1" searchTerms="foo"/>
  <opensearch:totalResults>768</opensearch:totalResults>
  <opensearch:startIndex>0</opensearch:startIndex>
  <opensearch:itemsPerPage>100</opensearch:itemsPerPage>
  <track href="spotify:track:3ZsjgLDSvusBgxGWrTAVto">
    <name>The Pretender</name>
    <artist href="spotify:artist:7jy3rLJdDQY21OgRLCZ9sD">
      <name>Foo Fighters</name>
    </artist>
    <id type="isrc">USRW30700007</id>
    <id type="isrc">USRW30700007</id>
    <album href="spotify:album:2ovXUTjkBkNlgAU7DTIxX9">
      <name>Echoes, Silence, Patience & Grace</name>
      <released>2007</released>
      <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 CD CF CG CH CI CK CL CM 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 HN HR HT HU IE IL IO IQ IR IS IT JM JO KE KG KH KI KM KN KP 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 MZ NA NC NE NG NI NL NO NP NR NU NZ OM PA PE PF PG PK PL PM PN PR PS PT PW PY QA RE RO RU RW SA SB SC SD SE SH SI SK SL SM SN SO SR ST SV SY SZ TC TD TF TG TJ TK TL TM TN TO TR TT TV TZ UA UG UY UZ VA VC VE VG VN VU WF WS YE YT ZA ZM ZW</territories>
      </availability>
    </album>
    <track-number>1</track-number>
    <length>269.373000</length>
    <popularity>0.79251</popularity>
  </track>
  ...
</tracks>