開発者向け API 仕様書
現在実装され、外部からGETできる分析APIとデータセットだけを掲載しています。応答項目は保存済みデータの有無により省略される場合があります。
提供状況
掲載中のエンドポイントはAPIキー不要です。専用の有料プラン、帯域保証、履歴トレンドAPIは現在提供していません。過度な連続取得は避け、404・503・欠損項目を処理してください。データセットは最新100件、CC BY-NC 4.0です。
指標の注意事項
unusualReviewSignal（データセットの互換フィールド名 fraudScore）は0〜100の不自然な投稿傾向シグナルです。レビュー中の不正投稿割合ではなく、不正や評価操作の証明でもありません。reliabilityScoreは保存済みの別の複合レビュー指標で、100 − unusualReviewSignalではありません。
公開エンドポイント
以下の値はレスポンス形状を示す説明用例です。未取得の任意項目は返りません。
GET
/api/v1/game/[appId]保存済み分析のランク、取得できた指標、6軸評価、ゲーム情報を返します。履歴系列は未提供で、historyStatus は unavailable です。分析がなければ404です。
リクエストパラメータ
appIdstring必須（パス）数字だけのSteam App IDレスポンス例（JSON）
{
"appId": "730",
"gameName": "Counter-Strike 2",
"status": "completed",
"analyzedAt": "2026-06-03T00:00:00.000Z",
"summary": "Retrieved-review sample analysis...",
"metrics": {
"aiRating": "S",
"reliabilityLevel": "High",
"reliabilityScore": 88,
"unusualReviewSignal": 12,
"scoreGap": 1
},
"scoreBreakdown": {
"graphics": 90,
"gameplay": 95,
"story": 70,
"value": 85,
"volume": 90,
"stability": 92
},
"gameInfo": {
"developers": ["Valve"],
"publishers": ["Valve"],
"genres": ["Action", "Free to Play"],
"hasJapanese": true
},
"historyStatus": "unavailable"
}GET
/api/check/[appId]保存済み分析の簡易表示用データを返します。このGETは新規分析を開始しません。分析がなければ404です。
リクエストパラメータ
appIdstring必須（パス）数字だけのSteam App IDレスポンス例（JSON）
{
"title": "Counter-Strike 2",
"score": "S",
"unusualReviewSignal": 12,
"hasHighUnusualReviewSignal": false,
"summary": "Retrieved-review sample analysis...",
"historyStatus": "unavailable",
"headerImageUrl": "https://shared.akamai.steamstatic.com/..."
}GET
/api/dataset/download最新100件の公開用要約データをCSVで返します。レスポンスヘッダーにライセンスを含みます。
レスポンス形式
CSV text (CC BY-NC 4.0)GET
/api/dataset/download-json最新100件の公開用要約データをJSON配列で返します。欠損指標は null です。
レスポンス例（JSON）
[
{
"appId": "730",
"gameName": "Counter-Strike 2",
"platform": "STEAM",
"analyzedAt": "2026-06-03T00:00:00.000Z",
"scoreJp": 88,
"scoreEn": 89,
"scoreGap": 1,
"aiRating": "S",
"fraudScore": 12
}
]