グレースノートのWeb APIはHTTPを介して音楽メタデータを提供し、ネットサービスでのインタラクティブ・エクスペリエンスの向上に役立ちます。音楽アーティスト、アルバム、トラック等のテキストベースの検索が可能になり、検索結果には、ジャンル、地域、気分、さらにカバーアート、アーティスト画像、経歴、およびその他の関連する記述メタデータを返します。CDや音声認識などのルックアップモードを使用する場合には、 GNSDKMobile Clientなどを使用する必要があります。

Music Web API Developer's Guide (英語のみ)

最初にクライアントIDを取得して下さい。これがグレースノートサービスへの呼び出しを行う際にあなたを認証するGracenote APIキーとなります。取得するには、あなたの開発者アカウントでログインしている必要があります。「マイアプリ」ページに移動し、「Add a new app 」 をクリックしてください。アプリケーションが作成されると、アプリケーションの詳細をクリックして確認できます。クライアントIDは 「Client ID for Mobile Client and Web API」 の下に表示されます。  

URL

Web APIへのリクエストは、以下のURLに送信する必要があります。

https://cXXXXXXX.web.cddbp.net/webapi/xml/1.0/

XXXXXXXは、あなたのクライアントIDのハイフンの前にある番号になります。

ユーザー登録

Gracenoteサービスへの呼び出しは、ユーザーIDを伴う必要があります。ユーザーIDを登録するには、上記のURLに以下のクエリを送信して下さい。

<QUERIES>
  <QUERY CMD="REGISTER">
    <CLIENT>XXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</CLIENT>
  </QUERY>
</QUERIES> 

グレースノートに登録するのは一回だけですが、アプリケーションのインストールごとにも登録が必要になります。 サーバーサイドアプリを構築している場合は、一度登録して 後続のすべての呼び出しのためにユーザーIDを格納する必要があります。モバイルアプリやデスクトップアプリを構築している場合は、各ユーザーのアプリは独自のユーザーIDを取得するために一度登録する必要があります。(例:アプリケーションの最初の起動時など)そしてこのユーザーIDを格納し後続の呼び出しのためにそれを使用します。 

基本的な楽曲検索

クライアントIDとユーザーIDを取得すると、アーティスト名、アルバム名、トラック名から基本的なテキスト検索を行い、ジャンルと楽曲IDを取得することができます。次のサンプルクエリで試すことが可能です。デフォルトではディスクリプターは英語で返ってきますが、日本語で取得したい場合は日本語の言語設定を行って下さい。 <LANG>jpn</LANG>

Query:

<QUERIES>
  <AUTH>
    <CLIENT>XXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXX</CLIENT>
    <USER>XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</USER>
  </AUTH>
  <LANG>jpn</LANG>
  <QUERY CMD="ALBUM_SEARCH">
    <MODE>SINGLE_BEST</MODE>
    <TEXT TYPE="ARTIST">Perfume</TEXT>
    <TEXT TYPE="ALBUM_TITLE">GAME</TEXT>
    <TEXT TYPE="TRACK_TITLE">チョコレイト・ディスコ</TEXT>
  </QUERY>
</QUERIES>

Response:

<RESPONSES>
 <RESPONSE STATUS="OK">
   <ALBUM>
      <GN_ID>153857537-C0E89B7AA71C102BD8986ADD02B0DE9C</GN_ID>
      <ARTIST>Perfume</ARTIST>
      <TITLE>GAME</TITLE>
      <PKG_LANG>JPN</PKG_LANG>
      <DATE>2008</DATE>
      <GENRE NUM="105247" ID="35495">ダンス & クラブ</GENRE>
      <MATCHED_TRACK_NUM>5</MATCHED_TRACK_NUM>
      <TRACK_COUNT>12</TRACK_COUNT>
      <TRACK>
         <TRACK_NUM>5</TRACK_NUM>
         <GN_ID>153857542-F5B1994A6C9EBF79D7FFB02EDF189A1D</GN_ID>
         <TITLE>チョコレイト・ディスコ</TITLE>
      </TRACK>
   </ALBUM>
 </RESPONSE>
</RESPONSES>

 

楽曲の詳細属性を検索

このクエリでは楽曲の詳細情報を返します。各ディスクリプター・タイプの詳細レベルを指定するには、Ord=Xを使用してください。

Query:

<QUERIES>
  <AUTH>
    <CLIENT>XXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</CLIENT>
    <USER>XXXXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</USER>
  </AUTH>
  <QUERY CMD="ALBUM_SEARCH">
    <MODE>SINGLE_BEST_COVER</MODE>
    <TEXT TYPE="ARTIST">perfume</TEXT>
    <TEXT TYPE="ALBUM_TITLE">GAME</TEXT>
    <TEXT TYPE="TRACK_TITLE">チョコレイト・ディスコ</TEXT>
    <OPTION>
      <PARAMETER>SELECT_EXTENDED</PARAMETER>
      <VALUE>COVER,REVIEW,ARTIST_BIOGRAPHY,ARTIST_IMAGE,ARTIST_OET,MOOD,TEMPO</VALUE>
    </OPTION>
    <OPTION>
      <PARAMETER>SELECT_DETAIL</PARAMETER>
      <VALUE>GENRE:3LEVEL,MOOD:2LEVEL,TEMPO:3LEVEL,ARTIST_ORIGIN:4LEVEL,ARTIST_ERA:2LEVEL,ARTIST_TYPE:2LEVEL</VALUE>
    </OPTION>
  </QUERY>
</QUERIES>

 

Response:

<RESPONSES>
 <RESPONSE STATUS="OK">
   <ALBUM>
      <GN_ID>153857537-C0E89B7AA71C102BD8986ADD02B0DE9C</GN_ID>
      <ARTIST>Perfume</ARTIST>
      <ARTIST_ORIGIN ORD="1" ID="29899">アジア</ARTIST_ORIGIN>
      <ARTIST_ORIGIN ORD="2" ID="30032">日本</ARTIST_ORIGIN>
      <ARTIST_TYPE ORD="1" ID="29423">女性</ARTIST_TYPE>
      <ARTIST_TYPE ORD="2" ID="29453">女性グループ</ARTIST_TYPE>
      <ARTIST_ERA ORD="1" ID="42877">2010年代</ARTIST_ERA>
      <TITLE>GAME</TITLE>
      <PKG_LANG>JPN</PKG_LANG>
      <DATE>2008</DATE>
<GENRE ORD="1" NUM="105216" ID="35470">エレクトロニカ</GENRE>
<GENRE ORD="2" NUM="105247" ID="35495">ダンス & クラブ</GENRE>
<GENRE ORD="3" NUM="62042" ID="25634">クラブ ダンス</GENRE>
      <MATCHED_TRACK_NUM>5</MATCHED_TRACK_NUM>
      <TRACK_COUNT>12</TRACK_COUNT>
      <TRACK>
         <TRACK_NUM>5</TRACK_NUM>
         <GN_ID>153857542-F5B1994A6C9EBF79D7FFB02EDF189A1D</GN_ID>
         <TITLE>チョコレイト・ディスコ</TITLE>
         <MOOD ORD="1" ID="42960">エキサイティング</MOOD>
         <MOOD ORD="2" ID="65355">アップビート / ポップ・グルーヴ</MOOD>
         <TEMPO ORD="1" ID="34283">ミディアム テンポ</TEMPO>
         <TEMPO ORD="2" ID="34291">若干速い</TEMPO>
         <TEMPO ORD="3" ID="34325">120台</TEMPO>
      </TRACK>
      <URL TYPE="COVERART" SIZE="MEDIUM">https://web.content.cddbp.net/cgi-bin/content-thin?id=8D1DE5C1792B0154&client=2711808&class=cover&origin=front&size=medium&type=image/jpeg&tag=02fxid2WzuZuPwLOrQAxrn0tGJahsk1VgC4wy2nK5c.8rRwhMAYxgn1w</URL>
      <URL TYPE="ARTIST_BIOGRAPHY">https://web.content.cddbp.net/cgi-bin/content-thin?id=F2765F0FCA839C03&client=2711808&class=biography&type=text/plain&tag=02r989rbdwo887oDw186TALRYL7LvrvIkM6vx0.it-i82qQ7RuNaL4cw</URL>
      <URL TYPE="ARTIST_IMAGE">https://web.content.cddbp.net/cgi-bin/content-thin?id=CF7049B64DECB3EB&client=2711808&class=image&size=medium&type=image/jpeg&tag=02-BfxvmCgO8kK0ePThDtNTHUjL.SqHwWSVSkH9TSe9Y9VipErba9iew</URL>
      <URL TYPE="REVIEW">https://web.content.cddbp.net/cgi-bin/content-thin?id=F450814EBE27254A&client=2711808&class=review&type=text/plain&tag=02xFfJ888pH2aeh48tOrCwKpKWoyfKOeAt8JccjaQncbdyNmZPSsHO0A</URL>
   </ALBUM>
 </RESPONSE>
</RESPONSES>

最も一般的なオプションで、アーティスト名、アルバム名、トラック名のメタデータをテキスト検索できXMLプロトコルをアブストラクトする様々な言語に対応したWeb APIの非公式ラッパーもあります。

これらは非公式のプロジェクトですので、Gracenoteはサポートや保証を提供していません。ご質問がある場合、もしくはそれらを使用して問題がある場合は、コードをホストしているリポジトリのフィードバックから直接作者に連絡して下さい。

Python

PHP

Java

ColdFusion