Appget list weekly ranking

amg-spicysoft edited this page May 27, 2013 · 10 revisions

週間ランキング (GET list/weekly_ranking)

毎週金~木曜日のマーケットへの誘導数データを木曜日23:59:59に〆てランキング情報に対する編集部からのレビューを添えて土曜日のAM6:30に公開されるランキング情報。無料ゲームのみ、有料ゲームのみがある。
Android、iOS対応アプリそれぞれのランキングを取得できる。

概要

URL http://appget.com/android-api/<version>/list/weekly_ranking.<format>
内容 週間ランキングデータを返す
バージョン 1~3
対応フォーマット json,rss,csv
対応リクエスト形式 HTTP/GET
要認証 不要
アクセス制限 なし

要求

対応バージョン 変数名 必須 値形式(定義値/範囲) 意味(例)
共通 callback × 文字列(半角英数字および"_" “.”) JSONPのコールバック関数名(フォーマットjson指定時に有効)
共通 type 種別ID(free,paid) ランキング種別(無料のみ/有料のみ)
共通 volume × 整数(1~) バックナンバーの号数(指定しない場合は最新の週のもの)
共通 date × ISO 8601(YYYY-MM-DD) 指定した日が含まれるランキングデータ(指定しない場合は最新の週のもの)
共通 count × 1~100(既定値:10) 一回の要求での取得件数
共通 page × 0~(既定値:0) ページ番号(最大:100件÷count - 1)
共通 tag × Yes/No デフォルトはYes(強調タグが出る)、Noだと出ない
3 platform o プラットフォームID(android, ios) 取得したい対応プラットフォーム(Android, iOS)

応答(正常)

変数名 値形式(定義値/範囲) 意味(例)
date ISO 8601(YYYY-MM-DD) ランキング〆日
volume 整数(1~) ランキング番号(号)
corner_title 文字列(8~30文字) コーナー名
corner_lead 文字列(32~400文字) コーナー説明(強調タグ適用箇所)
reviewer_id 整数形式ID(1~9999) レビュワーID
reviewer_name 文字列(1文字~8文字) レビュワー名(例:78納谷)
reviewer_expression (normal,smile,weep,shame,angry) レビュワーの表情
reviewer_faceshot URL レビュワーの顔イメージ
reviewer_bodyshot URL レビュワーの全身イメージ
banner URL コーナーバナー画像
copyright 文字列(~128文字) 著作権表記
title 文字列(8~30文字) 記事タイトル(例:2011年9月3日 Androidゲーム週間無料ランキング vol2)
lead 文字列(32~400文字) 記事リード(強調タグ適用箇所)
remarkables 配列 赤マル急上昇ゲーム
rankings 配列 ランキング情報

赤マル急上昇ゲーム情報の定義

変数名 値形式(定義値/範囲) 意味(例)
order 表示順番 表示の優先順位
app_id 整数 アプリID
title 文字列(20文字~60文字) 記事見出し(強調タグ適用箇所)
comment 文字列(100~400文字) 記事文(強調タグ適用箇所)
caption 文字列(10~30文字) 画像キャプション
screenshot_thumbnail URL プレビュー画像のスクリーンショット
screenshot_full URL フル画像のスクリーンショット

上記定義内の配列や強調タグの定義はこちらから

応答(異常)

要求に誤りがあった場合は 404を返答する