2014/04/08

Search APIを使ってiOSアプリの詳細情報を表示する

 iTunes, JavaScript, jQuery

今回は「Search API」のLookup Requestを使用します。
前回同様、Ajaxで取得します。

APIのgetパラメータにアプリ固有のID(前回のSearch Requestで取得したtrackId)を指定して、該当するアプリの詳細情報を取得します。



サンプルコード

lookup_url = "http://itunes.apple.com/lookup?";
lookup_url = lookup_url + "id=" + id;     // Search Requestで取得したtrackIdを指定
lookup_url = lookup_url + "&country=JP";  // 日本のAppStoreマーケットを指定

$.ajax({
   type: 'GET',
   url: lookup_url,
   dataType : 'jsonp', // クロスドメイン接続を考慮してJSONPにする
   success: function(json, status){
      var len = json.length;

      count = json['resultCount'];
      if (count==0) {
         // 検索結果0件
      } else {
         results = json['results'];

         jQuery.each(results, function(cnt, result) {

            alert(result['version']);           // アプリのバージョン
            alert(result['artistName']);        // アプリ開発者
            alert(result['sellerUrl']);         // 販売者のURL
            alert(result['formattedPrice']);    // 価格(表示用にフォーマット済)
            alert(result['fileSizeBytes']);     // アプリのファイルサイズ
            alert(result['description']);       // アプリの説明

         });
      }
   },
   error: function(XMLHttpRequest, textStatus, errorThrown) {
        // エラー処理
   },
   complete : function(data) {
        // Ajax通信完了
   }
});


ファイルサイズは整形されていないので、サイズに応じてMB/KB等の表示に修正した方が良いです。
アプリの説明(description)は、英語や他言語のものも取得できるケースがありますが、日本向けのサイトであれば日本語表示だけにしておいた方が無難です。
前回のSearch Requestと組み合わせて、アプリ一覧から選択された時にこのLookup Requestを呼び出すようにすれば良いと思います。

次回は、アプリのAppStoreランキング情報を取得してみたいと思います。

(上記APIを使用した画面 : iOSアプリ ランキング検索(β版))


 関連記事1:「Search APIを使ってiOSアプリ一覧を表示する」

 関連記事2:「AppStoreランキング情報を表示する」