Appget list monthly ranking

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

月間ランキング (GET list/monthly_ranking)

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

概要

URL http://appget.com/android-api/<version>/list/monthly_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(HTMLタグが出る)、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文字) コーナー説明(HTMLタグ適用箇所)
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年8月 Androidゲーム月間無料ランキング vol2)
lead 文字列(32~400文字) 記事リード(HTMLタグ適用箇所)
remarkables 配列 赤マル急上昇ゲーム
rankings 配列 ランキング情報

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

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

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

応答(異常)

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