PPDB API v2 ですわ♪


[アイドルマスターシンデレラガールズ プロデューサー&プロダクション データベース(PPDB)](https://ppdb.momoka-sakurai.com/)に登録されているデータを外部から利用するためのAPIです。 出力形式はJSONまたはCSVです。URL末尾の`json`を`csv`に変更することで、CSV形式で取得することができます。 ヘッダに`Access-Control-Allow-Origin: *`が付加されるためAjaxアプリケーションから直接利用することができます。 ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/limit.json APIの使用制限量と、現在の使用量を出力します。 現在**limitRownum**以外の値は使用されていません。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(array<object>)| |┣name|項目名(str)| |┗value|値(int)| ### 使用例 https://ppdb.momoka-sakurai.com/api/2/limit.json?pretty=1 ``` { "result": true, "message": null, "data": [ { "name": "remoteAddress", "value": "127.0.0.1" }, { "name": "clearPeriod", "value": 1800 }, { "name": "limitRownum", "value": 4096 }, { "name": "limitTraffic", "value": 134217728 }, { "name": "currentTraffic", "value": 0 }, { "name": "isExceeded", "value": false } ] } ``` ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/data.json 存在するデータの一覧を出力します。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| |※|id|絞り込むデータID| ||idMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| |※|name|絞り込むデータ名称| ||nameMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||full|1を指定するとデータ取得日時を出力| ※ - どちらか必須(空文字列可) ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(array<object>)| |┣DataID|データID(int)| |┣DataName|データ名称(int)| |┗DateTime|データ取得日時(str) [full=1 時のみ]| データIDの最上位桁が ... (1 = プロデューサーデータ, 2 = プロダクションデータ) ### 使用例 https://ppdb.momoka-sakurai.com/api/2/data.json?pretty=1&name=サバイバル&nameMode=1 ``` { "result": true, "message": null, "data": [ { "DataID": 220000213, "DataName": "アイドルサバイバルinフラワーガーデン" }, { "DataID": 120000213, "DataName": "アイドルサバイバルinフラワーガーデン" }, { "DataID": 120000212, "DataName": "アイドルサバイバル 秋の大運動会" }, { "DataID": 220000212, "DataName": "アイドルサバイバル 秋の大運動会" }, { "DataID": 220000211, "DataName": "アイドルサバイバルinサマーバケーション" }, { "DataID": 120000211, "DataName": "アイドルサバイバルinサマーバケーション" }, { "DataID": 220000210, "DataName": "アイドルサバイバルinテーマパーク2013" }, { "DataID": 120000210, "DataName": "アイドルサバイバルinテーマパーク2013" }, { "DataID": 220000209, "DataName": "アイドルサバイバル ひな祭り2013" }, { "DataID": 120000209, "DataName": "アイドルサバイバル ひな祭り2013" } ] } ``` ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/search.json 指定された検索条件をもとに抽出されたデータを出力します。 このAPIでは1回のリクエストで取得できるデータ行数が制限されています。 制限はlimit.jsonで確認できます。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| |✔|dataId|取得対象のデータID(data.jsonで確認できます)| ||start|取得を開始する行インデックス| ||length|取得する行数(制限に注意 -> limit.json)| ||sortBy|ソートする列番号| ||sortDir|ソートする方向(ASC, DESC)| ||[検索条件]|下記を参照| ### 検索条件 : プロデューサー |必須|パラメータ|説明| |---|---|---| ||userID|ユーザーID| ||userIDMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||prodID|所属プロダクションID| ||prodIDMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||prodName|所属プロダクション名| ||prodNameMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||unitName|ユニット名| ||unitNameMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||title|肩書| ||titleMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||userName|ユーザー名| ||userNameMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||leader|リーダー| ||leaderMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||comment|コメント| ||commentMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||wishIdol1|ホシイモノ1| ||wishIdol1Mode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||wishIdol2|ホシイモノ2| ||wishIdol2Mode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||wishIdol3|ホシイモノ3| ||wishIdol3Mode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||fanMin|最小ファン数| ||fanMax|最大ファン数| ||levelMin|最小レベル| ||levelMax|最大レベル| ||liveMin|最小総LIVEバトル数| ||liveMax|最大総LIVEバトル数| ||winMin|最小LIVEバトル勝利数| ||winMax|最大LIVEバトル勝利数| ||albumMin|最小アルバム枚数| ||albumMax|最大アルバム枚数| ||friendlyIdolMin|最小親愛度MAXアイドル人数| ||friendlyIdolMax|最大親愛度MAXアイドル人数| ||rankingMin|最小順位| ||rankingMax|最大順位| ||scoreMin|最小スコア| ||scoreMax|最大スコア| ||type|プロデューサーのタイプ
(0=全て, 1=キュート, 2=クール, 3=パッション)| ||rank[?]|ランク(0を指定すると除外)
([?] : 1=F, 2=E, 3=D, 4=C, 5=B, 6=A, 7=S, 8=SS, 9=S3,
10=S4, 11=S5, 12=S6, 13=S7, 14=S8, 15=S9, 16=S10)| ||awardRank[?]|順位発表時ランク(0を指定すると除外)
([?] : 1=F, 2=E, 3=D, 4=C, 5=B, 6=A, 7=S, 8=SS, 9=S3,
10=S4, 11=S5, 12=S6, 13=S7, 14=S8, 15=S9, 16=S10)| ### 検索条件 : プロダクション |必須|パラメータ|説明| |---|---|---| ||prodID|プロダクションID| ||prodIDMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||prodName|プロダクション名| ||prodNameMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||presidentID|代表ID| ||presidentIDMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||presidentName|代表名| ||presidentNameMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||comment|コメント| ||commentMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||fanMin|最小総ファン数| ||fanMax|最大総ファン数| ||levelMin|最小PLv| ||levelMax|最大PLv| ||developmentMin|最小発展度| ||developmentMax|最大発展度| ||moneyMin|最小マニー| ||moneyMax|最大マニー| ||memberMin|最小社員数| ||memberMax|最大社員数| ||rankingMin|最小順位| ||rankingMax|最大順位| ||scoreMin|最小スコア| ||scoreMax|最大スコア| ||estheticRoom|エステルーム(0=指定なし, 1=あり, 2=なし)| ||cafeTerrace|カフェテラス(0=指定なし, 1=あり, 2=なし)| ||saunaRoom|サウナルーム(0=指定なし, 1=あり, 2=なし)| ||rank[?]|ランク(0を指定すると除外)
([?] : 1=F, 2=E, 3=D, 4=C, 5=B, 6=A, 7=S, 8=SS, 9=S3,
10=S4, 11=S5, 12=S6, 13=S7, 14=S8, 15=S9, 16=S10)| ||awardRank[?]|順位発表時ランク(0を指定すると除外)
([?] : 1=F, 2=E, 3=D, 4=C, 5=B, 6=A, 7=S, 8=SS, 9=S3,
10=S4, 11=S5, 12=S6, 13=S7, 14=S8, 15=S9, 16=S10)| ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(object)| |┣id|データID(int)| |┣total|データ全体の行数(int)| |┣found|抽出された行数(int)| |┣start|開始行インデックス(int)| |┣length|取得行数(int)| |┣sortBy|ソートされた列番号(int)| |┣sortDir|ソートされた方向(str)| |┗records|データ(array<object>)
下記を参照| ### データ : プロデューサー |レスポンス|説明| |---|---| |DateTime|データ取得日時(str)| |UserID|ユーザーID(int)| |ProdName|所属プロダクションID(int)| |ProdName|所属プロダクション名(str)| |UnitName|ユニット名(str)| |Title|肩書(str)| |UserName|ユーザー名(str)| |Rank|ランク(int)
(1=F, 2=E, 3=D, 4=C, 5=B, 6=A, 7=S, 8=SS, 9=S3,
10=S4, 11=S5, 12=S6, 13=S7, 14=S8, 15=S9, 16=S10)| |Fan|ファン数(int)| |Leader|リーダー(str)| |Level|レベル(int)| |Type|タイプ(int)
(1=キュート, 2=クール, 3=パッション)| |Live|総LIVEバトル数(int)| |Win|LIVEバトル勝利数(int)| |Album|アルバム枚数(int)| |FriendlyIdol|親愛度MAXアイドル人数(int)| |Comment|コメント(str)| |WishIdol1|ホシイモノ1(str)| |WishIdol2|ホシイモノ2(str)| |WishIdol3|ホシイモノ3(str)| |AwardRank|順位発表時ランク(int)
(1=F, 2=E, 3=D, 4=C, 5=B, 6=A, 7=S, 8=SS, 9=S3,
10=S4, 11=S5, 12=S6, 13=S7, 14=S8, 15=S9, 16=S10)| |Ranking|順位(int)| |Score|スコア(int)| ### データ : プロダクション |レスポンス|説明| |---|---| |DateTime|データ取得日時(int)| |ProdID|プロダクションID(int)| |ProdName|プロダクション名(str)| |Rank|ランク(int)
(1=F, 2=E, 3=D, 4=C, 5=B, 6=A, 7=S, 8=SS, 9=S3,
10=S4, 11=S5, 12=S6, 13=S7, 14=S8, 15=S9, 16=S10)| |Fan|総ファン数(int)| |Level|PLv(int)| |Development|発展度(int)| |Money|マニー(int)| |PresidentID|代表ID(int)| |PresidentName|代表(str)| |Member|社員数(int)| |Comment|コメント(str)| |EstheticRoom|エステルーム(int)
(1=あり, 0=なし)| |CafeTerrace|カフェテラス(int)
(1=あり, 0=なし)| |SaunaRoom|サウナルーム(int)
(1=あり, 0=なし)| |AwardRank|順位発表時ランク(int)
(1=F, 2=E, 3=D, 4=C, 5=B, 6=A, 7=S, 8=SS, 9=S3,
10=S4, 11=S5, 12=S6, 13=S7, 14=S8, 15=S9, 16=S10)| |Ranking|順位(int)| |Score|スコア(int)| ### 使用例 https://ppdb.momoka-sakurai.com/api/2/search.json?pretty=1&start=0&length=50&sortBy=20&sortDir=desc&leader=未央&leaderMode=1&levelMin=5&levelMax=10&rank1=0&type=3&dataId=120000711 ``` { "result": true, "message": null, "data": { "id": 120000711, "total": 166523, "found": 2, "start": 0, "length": 50, "sortBy": 21, "sortDir": "DESC", "records": [ { "DateTime": "2015-02-11 17:54:32", "UserID": 70046580, "ProdID": 649578, "ProdName": "adgjmptw", "UnitName": "たか子", "Title": "", "UserName": "カード", "Rank": 2, "Fan": 8353, "Leader": "[ドリームストーリー]本田未央+", "Level": 5, "Type": 3, "Live": 561, "Win": 557, "Album": 105, "FriendlyIdol": 96, "Comment": "よろしくおねがいします!", "WishIdol1": "", "WishIdol2": "", "WishIdol3": "", "AwardRank": 2, "Ranking": 60663, "Score": 386994 }, { "DateTime": "2015-02-11 17:57:35", "UserID": 81185095, "ProdID": 442318, "ProdName": "キラ☆キラ", "UnitName": "※いちシノ※'S", "Title": "", "UserName": "※いちシノ※", "Rank": 2, "Fan": 1496, "Leader": "[ドリームストーリー]本田未央+", "Level": 5, "Type": 3, "Live": 14, "Win": 12, "Album": 80, "FriendlyIdol": 24, "Comment": "よろしくおねがいします!", "WishIdol1": "", "WishIdol2": "", "WishIdol3": "", "AwardRank": 2, "Ranking": 101596, "Score": 108360 } ] } } ``` ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/user.json プロデューサーの詳細情報を出力します。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| |✔|id|取得対象のユーザID| ||dataType|取得対象のデータ
(0=指定なし, 1=PRAのみ, 2=イベントのみ)| ||[検索条件 : プロデューサー]|search.jsonの当該項目を参照| ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(object)| |┣id|ユーザID(int)| |┣total|データ全体の行数(int)| |┣found|抽出された行数(int)| |┣start|開始行インデックス(int)| |┣length|取得行数(int)| |┣sortBy|ソートされた列番号(int = 0)| |┣sortDir|ソートされた方向(str = 'DESC')| |┗records|[データ : プロデューサー] (array<object>)
search.jsonの当該項目を参照| ### 使用例 https://ppdb.momoka-sakurai.com/api/2/user.json?pretty=1&id=66152658&dataType=2 ``` { "result": true, "message": null, "data": { "id": 66152658, "total": 2, "found": 2, "start": 0, "length": 2, "sortBy": 0, "sortDir": "DESC", "records": [ { "DateTime": "2015-02-11 17:53:28", "UserID": 66152658, "ProdID": 210472, "ProdName": "Out Of Service", "UnitName": "おく'S", "Title": "", "UserName": "おく", "Rank": 1, "Fan": 53, "Leader": "[アニバーサリーフォーユー]島村卯月", "Level": 2, "Type": 1, "Live": 1, "Win": 1, "Album": 59, "FriendlyIdol": 43, "Comment": "よろしくおねがいします!", "WishIdol1": "", "WishIdol2": "", "WishIdol3": "", "AwardRank": 1, "Ranking": 135511, "Score": 15707, "DataName": "福は内DEドリームLIVEフェスティバル", "DataID": 120000711 }, { "DateTime": "2015-01-31 12:32:28", "UserID": 66152658, "ProdID": 210472, "ProdName": "Out Of Service", "UnitName": "おく'S", "Title": "", "UserName": "おく", "Rank": 1, "Fan": 53, "Leader": "[アニバーサリーフォーユー]島村卯月", "Level": 2, "Type": 1, "Live": 1, "Win": 1, "Album": 48, "FriendlyIdol": 6, "Comment": "よろしくおねがいします!", "WishIdol1": "", "WishIdol2": "", "WishIdol3": "", "AwardRank": 1, "Ranking": 118944, "Score": 3715, "DataName": "第8回プロダクション対抗トークバトルショー", "DataID": 120001108 } ] } } ``` ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/career.json プロデューサーが過去に所属していたプロダクションの詳細情報を出力します。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| |✔|id|取得対象のユーザID| ||dataType|取得対象のデータ
(0=指定なし, 1=PRAのみ, 2=イベントのみ)| ||[検索条件 : プロダクション]|search.jsonの当該項目を参照| ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(object)| |┣id|ユーザID(int)| |┣total|データ全体の行数(int)| |┣found|抽出された行数(int)| |┣start|開始行インデックス(int)| |┣length|取得行数(int)| |┣sortBy|ソートされた列番号(int = 0)| |┣sortDir|ソートされた方向(str = 'DESC')| |┗records|[データ : プロダクション] (array<object>)
search.jsonの当該項目を参照| ### 使用例 https://ppdb.momoka-sakurai.com/api/2/career.json?pretty=1&id=66152658&dataType=1 ``` { "result": true, "message": null, "data": { "id": 66152658, "total": 2, "found": 2, "start": 0, "length": 2, "sortBy": 0, "sortDir": "DESC", "records": [ { "DateTime": "2015-02-09 15:13:13", "ProdID": 210472, "ProdName": "Out Of Service", "Rank": 4, "Fan": 3904529, "Level": 34, "Development": 13971, "Money": 1319000, "PresidentID": 64525095, "PresidentName": "ゆう", "Member": 30, "Comment": "コメントが設定されていません", "EstheticRoom": 1, "CafeTerrace": 1, "SaunaRoom": 1, "AwardRank": 4, "Ranking": 6877, "Score": 613, "DataName": "PRA 2015\/02\/09", "DataID": 210150209 }, { "DateTime": "2015-02-02 15:25:27", "ProdID": 210472, "ProdName": "Out Of Service", "Rank": 4, "Fan": 3903920, "Level": 34, "Development": 13971, "Money": 1319000, "PresidentID": 64525095, "PresidentName": "ゆう", "Member": 30, "Comment": "コメントが設定されていません", "EstheticRoom": 1, "CafeTerrace": 1, "SaunaRoom": 1, "AwardRank": 4, "Ranking": 1453, "Score": 31575, "DataName": "PRA 2015\/02\/02", "DataID": 210150202 } ] } } ``` ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/prod.json プロダクションの詳細情報を出力します。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| |✔|id|取得対象のプロダクションID| ||dataType|取得対象のデータ
(0=指定なし, 1=PRAのみ, 2=イベントのみ)| ||[検索条件 : プロダクション]|search.jsonの当該項目を参照| ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(object)| |┣id|プロダクションID(int)| |┣total|データ全体の行数(int)| |┣found|抽出された行数(int)| |┣start|開始行インデックス(int)| |┣length|取得行数(int)| |┣sortBy|ソートされた列番号(int = 0)| |┣sortDir|ソートされた方向(str = 'DESC')| |┗records|[データ : プロダクション] (array<object>)
search.jsonの当該項目を参照| ### 使用例 https://ppdb.momoka-sakurai.com/api/2/prod.json?pretty=1&id=653502&dataType=0 ``` { "result": true, "message": null, "data": { "id": 653502, "total": 3, "found": 3, "start": 0, "length": 3, "sortBy": 0, "sortDir": "DESC", "records": [ { "DateTime": "2015-02-09 15:23:42", "ProdID": 653502, "ProdName": "紅き手袋", "Rank": 3, "Fan": 115909, "Level": 32, "Development": 11166, "Money": 2159000, "PresidentID": 13533554, "PresidentName": "美味醤油", "Member": 23, "Comment": "コメント未編集お断り。まったり楽しくできる方歓迎!是非にー", "EstheticRoom": 1, "CafeTerrace": 1, "SaunaRoom": 1, "AwardRank": 2, "Ranking": 143, "Score": 46109, "DataName": "PRA 2015\/02\/09", "DataID": 210150209 }, { "DateTime": "2015-02-02 15:36:46", "ProdID": 653502, "ProdName": "紅き手袋", "Rank": 2, "Fan": 69789, "Level": 31, "Development": 9130, "Money": 125000, "PresidentID": 13533554, "PresidentName": "美味醤油", "Member": 22, "Comment": "コメント未編集お断り。まったり楽しくできる方歓迎!是非にー", "EstheticRoom": 1, "CafeTerrace": 1, "SaunaRoom": 1, "AwardRank": 1, "Ranking": 10, "Score": 61597, "DataName": "PRA 2015\/02\/02", "DataID": 210150202 }, { "DateTime": "2015-01-31 12:40:59", "ProdID": 653502, "ProdName": "紅き手袋", "Rank": 1, "Fan": 49439, "Level": 26, "Development": 5615, "Money": 2610000, "PresidentID": 13533554, "PresidentName": "美味醤油", "Member": 20, "Comment": "コメント未編集お断り。まったり楽しくできる方歓迎!是非にー", "EstheticRoom": 0, "CafeTerrace": 1, "SaunaRoom": 0, "AwardRank": 1, "Ranking": 8342, "Score": 689178, "DataName": "第8回プロダクション対抗トークバトルショー", "DataID": 220001108 } ] } } ``` ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/member.json プロダクションに所属しているプロデューサーの詳細情報を出力します。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| |✔|id|取得対象のプロダクションID| ||dataId|取得対象のデータID| ||[検索条件 : プロデューサー]|search.jsonの当該項目を参照| ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(object)| |┣id|プロダクションID(int)| |┣total|データ全体の行数(int)| |┣found|抽出された行数(int)| |┣start|開始行インデックス(int)| |┣length|取得行数(int)| |┣sortBy|ソートされた列番号(int = 0)| |┣sortDir|ソートされた方向(str = 'DESC')| |┗records|[データ : プロデューサー] (array<object>)
search.jsonの当該項目を参照| ### 使用例 https://ppdb.momoka-sakurai.com/api/2/member.json?pretty=1&id=563171&dataId=120000711 ``` { "result": true, "message": null, "data": { "id": 563171, "total": 3, "found": 3, "start": 0, "length": 3, "sortBy": 0, "sortDir": "DESC", "records": [ { "DateTime": "2015-02-11 17:54:28", "UserID": 69822600, "ProdID": 563171, "ProdName": "かたすみプロ", "UnitName": "あいのや", "Title": "[ノーアイドル・ノーライフ]双葉杏", "UserName": "遠矢", "Rank": 4, "Fan": 184349, "Leader": "[サルファーブライト]土屋亜子+", "Level": 74, "Type": 2, "Live": 803, "Win": 740, "Album": 449, "FriendlyIdol": 433, "Comment": "ガチャで爆死って765レアは出たんだから違いますよ……(震え声)", "WishIdol1": "", "WishIdol2": "", "WishIdol3": "", "AwardRank": 4, "Ranking": 44388, "Score": 564536, "DataName": "福は内DEドリームLIVEフェスティバル", "DataID": 120000711 }, { "DateTime": "2015-02-11 17:52:34", "UserID": 62640361, "ProdID": 563171, "ProdName": "かたすみプロ", "UnitName": "生き残り隊", "Title": "", "UserName": "きのこる", "Rank": 4, "Fan": 175185, "Leader": "[ドリームストーリー]島村卯月+", "Level": 82, "Type": 2, "Live": 1055, "Win": 715, "Album": 337, "FriendlyIdol": 262, "Comment": "二人で特訓すれば楽だと思ったのに作業が面倒くさい", "WishIdol1": "", "WishIdol2": "", "WishIdol3": "", "AwardRank": 4, "Ranking": 117668, "Score": 49727, "DataName": "福は内DEドリームLIVEフェスティバル", "DataID": 120000711 }, { "DateTime": "2015-02-11 17:48:10", "UserID": 9530393, "ProdID": 563171, "ProdName": "かたすみプロ", "UnitName": "揺れる心揺れない胸", "Title": "", "UserName": "花菱草", "Rank": 5, "Fan": 411926, "Leader": "[ドリームストーリー]島村卯月+", "Level": 83, "Type": 2, "Live": 5919, "Win": 5546, "Album": 370, "FriendlyIdol": 234, "Comment": "ζ*'ヮ')ζ<わかるわ", "WishIdol1": "", "WishIdol2": "", "WishIdol3": "", "AwardRank": 5, "Ranking": 119592, "Score": 44870, "DataName": "福は内DEドリームLIVEフェスティバル", "DataID": 120000711 } ] } } ``` ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/idol.json アイドルの一覧・詳細を出力します。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| |※|id|絞り込むアイドルID| ||idMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| |※|name|絞り込むアイドル名(ひらがなOK)| ||nameMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ||full|1を指定するとアイドルのプロフィールを全て出力| ※ - どちらか必須(空文字列可) ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(array<object>)| |┣ID|アイドルID(str)| |┣Name|アイドル名(str)| |┣Rarity|レア度(int) [full=1 時のみ]| |┣Cost|コスト(int) [full=1 時のみ]| |┣Attribute|アイドルのタイプ(int) [full=1 時のみ]
(1=キュート, 2=クール, 3=パッション)| |┣SkillName|スキル名(str) [full=1 時のみ]| |┣SkillEffect|スキルの効果(str) [full=1 時のみ]| |┣Attack|初期攻撃力(int) [full=1 時のみ]| |┣Defence|初期防御力(int) [full=1 時のみ]| |┣Kana|ふりがな(str) [full=1 時のみ]| |┣Age|年齢(str) [full=1 時のみ]| |┣Height|身長(str) [full=1 時のみ]| |┣Weight|体重(str) [full=1 時のみ]| |┣Size|スリーサイズ(str) [full=1 時のみ]| |┣Birthday|誕生日(str) [full=1 時のみ]| |┣Constellation|星座(str) [full=1 時のみ]| |┣Blood|血液型(str) [full=1 時のみ]| |┣Arm|利き手(str) [full=1 時のみ]| |┣City|出身地(str) [full=1 時のみ]| |┗Hobby|趣味(str) [full=1 時のみ]| ### 使用例 https://ppdb.momoka-sakurai.com/api/2/idol.json?pretty=1&name=ゆめ&nameMode=1&full=1 ``` { "result": true, "message": null, "data": [ { "ID": "1b1ee82db7a9842317010a4dcf5878f2", "Name": "[エアリアルフェアリー]成宮由愛", "Rarity": 5, "Cost": 21, "Attribute": 2, "SkillName": "やさしい雫", "SkillEffect": "クールのフロントメンバー及びバックメンバー上位2~3人の攻 極大アップ", "Attack": 6140, "Defence": 4580, "Kana": "なるみやゆめ", "Age": "13", "Height": "150", "Weight": "40", "Size": "72\/51\/73", "Birthday": "11月3日", "Constellation": "蠍座", "Blood": "AB", "Arm": "両", "City": "滋賀", "Hobby": "写生・水彩画" }, { "ID": "216acd7a27e04ba268e35d2966e681af", "Name": "[魔女っ娘I.C]成宮由愛+", "Rarity": 4, "Cost": 12, "Attribute": 2, "SkillName": "チェンジ・リーフ", "SkillEffect": "クールタイプの守 中アップ", "Attack": 2440, "Defence": 2820, "Kana": "なるみやゆめ", "Age": "13", "Height": "150", "Weight": "40", "Size": "72\/51\/73", "Birthday": "11月3日", "Constellation": "蠍座", "Blood": "AB", "Arm": "両", "City": "滋賀", "Hobby": "写生・水彩画" }, { "ID": "220429110c5cf2fbaa7580fa256063c4", "Name": "[マーチングバンド]成宮由愛", "Rarity": 3, "Cost": 14, "Attribute": 2, "SkillName": "かなでるめろでぃ", "SkillEffect": "キュート・クールのフロントメンバー及びバックメンバー上位1人の攻 大アップ", "Attack": 3220, "Defence": 2180, "Kana": "なるみやゆめ", "Age": "13", "Height": "150", "Weight": "40", "Size": "72\/51\/73", "Birthday": "11月3日", "Constellation": "蠍座", "Blood": "AB", "Arm": "両", "City": "滋賀", "Hobby": "写生・水彩画" }, ... ] } ``` ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/title.json 肩書の一覧を出力します。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| |※|id|絞り込む肩書ID| ||idMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| |※|name|絞り込む肩書名| ||nameMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ※ - どちらか必須(空文字列可) ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(array<object>)| |┣ID|肩書ID(int)| |┗Name|肩書名(str)| ### 使用例 https://ppdb.momoka-sakurai.com/api/2/title.json?pretty=1&name=輝子&nameMode=1 ``` { "result": true, "message": null, "data": [ { "ID": 10003, "Name": "[あやしい少女]星輝子" }, { "ID": 100227, "Name": "[絶叫★ヴァンパイア]星輝子" }, { "ID": 100309, "Name": "[ブラックバレンタイン]星輝子" }, { "ID": 100368, "Name": "[CDデビュー]星輝子" }, { "ID": 100403, "Name": "[ラブ☆キノコ]星輝子" } ] } ``` ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/trend.json アイドル人気の一覧・推移を出力します。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| |✔|group|データIDまたはアイドル名
データIDを指定: その時点での全てのアイドルの人気を出力
アイドル名を指定: そのアイドルの人気の推移を出力| ||sortBy|ソートする要素名(DateTime, Title, Leader, Wish, Total)| ||sortDir|ソートする方向(ASC, DESC)| ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(array<object>)| |┣DateTime|統計をとった日時(str)| |┣DataID|統計をとったデータID(int)| |┣Name|アイドル名(str)| |┣Title|肩書に設定されている数(int)| |┣Leader|リーダーに設定されている数(int)| |┗Wish|ホシイモノリストに設定されている数(int)| ### 使用例 https://ppdb.momoka-sakurai.com/api/2/trend.json?pretty=1&group=[南国オニむすめ]ナターリア&&sortBy=DateTime&sortDir=ASC ``` { "result": true, "message": null, "data": [ { "DateTime": "2015-02-02 15:20:41", "DataID": 110150202, "Name": "[南国オニむすめ]ナターリア", "Title": 0, "Leader": 0, "Wish": 3 }, { "DateTime": "2015-02-09 15:26:05", "DataID": 110150209, "Name": "[南国オニむすめ]ナターリア", "Title": 487, "Leader": 500, "Wish": 146 }, { "DateTime": "2015-02-11 18:02:34", "DataID": 120000711, "Name": "[南国オニむすめ]ナターリア", "Title": 573, "Leader": 324, "Wish": 225 } ] } ``` ## _GET/POST_ https://ppdb.momoka-sakurai.com/api/2/stat.json 統計データ(イベントボーダーとアクティブユーザー数)を出力します。 ### パラメータ |必須|パラメータ|説明| |---|---|---| ||pretty|1を指定するとJSONを整形して出力します| |✔|id|絞り込むデータID| ||idMode|検索方法(1=部分, 2=前方, 3=後方, 4=完全)| ### レスポンス |レスポンス|説明| |---|---| |result|リクエストの成否(bool)| |message|失敗時の詳細(str)| |data|データ(array<object>)| |┣DataID|統計をとったデータID(int)| |┣StatID|統計ID(int)| |┗Value|統計データ(int)| 統計IDが...(0 = アクティブユーザー数, それ以外 = イベントボーダースコア) ### 使用例 https://ppdb.momoka-sakurai.com/api/2/stat.json?pretty=1&id=120000810&idMode=4 ``` { "result": true, "message": null, "data": [ { "DataID": 120000810, "StatID": 0, "Value": 143704 }, { "DataID": 120000810, "StatID": 10, "Value": 16819667 }, { "DataID": 120000810, "StatID": 100, "Value": 12044872 }, { "DataID": 120000810, "StatID": 200, "Value": 10905393 }, { "DataID": 120000810, "StatID": 1000, "Value": 3761068 }, { "DataID": 120000810, "StatID": 1500, "Value": 3444556 }, { "DataID": 120000810, "StatID": 2000, "Value": 3225815 }, { "DataID": 120000810, "StatID": 3000, "Value": 1912241 }, { "DataID": 120000810, "StatID": 4000, "Value": 1578882 }, { "DataID": 120000810, "StatID": 7000, "Value": 1107590 }, { "DataID": 120000810, "StatID": 10000, "Value": 875231 }, { "DataID": 120000810, "StatID": 15000, "Value": 681259 }, { "DataID": 120000810, "StatID": 20000, "Value": 559558 }, { "DataID": 120000810, "StatID": 30000, "Value": 397377 }, { "DataID": 120000810, "StatID": 50000, "Value": 212640 }, { "DataID": 120000810, "StatID": 100000, "Value": 30643 }, { "DataID": 120000810, "StatID": 200000, "Value": 0 } ] } ```