개발자용 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
}
]