← 홈으로 돌아가기
Developer API Docs - 개발자 및 AI 에이전트 연동용 API 가이드

개발자용 API 명세서

연구소에서 제공하는 공개 API의 연동 명세서입니다. 연구 목정, 봇 연동, 애플리케이션 개발에 무료로 사용하실 수 있습니다 (초당 1회 이하의 호출을 권장합니다).

🔑 API 이용 요금제 (데이터 판매)

게임 미디어, 크리에이터, 디스코드 봇 및 스팀 관련 서비스 운영자를 위한 상업용 고대역폭 API 플랜을 제공합니다.

Tier 1 (Free)

무료

개인 개발 및 테스트용

📈 일 50회 호출

Tier 2 (Pro)

$9 / 월

중소규모 봇 및 웹 미디어/유튜버용

📈 일 5,000회 호출

Tier 3 (Enterprise)

$49 / 월

상용 서비스 및 대규모 데이터 분석용

📈 일 50,000회 호출

공개 엔드포인트 목록

GET/api/v1/game/[appId]

지정된 스팀 게임의 상세 분석 데이터(AI 평가 랭크, 신뢰성 지수, 6대 품질 점수, 언어권별 평가 격차, 요금 메타데이터, 6개월 시계열 트렌드 그래프)를 가져옵니다.

요청 매개변수

appIdstring필수 (경로)스팀 애플리케이션 식별값 (예: 730)

응답 예시 (JSON)

{
  "appId": "730",
  "gameName": "Counter-Strike 2",
  "status": "completed",
  "analyzedAt": "2026-06-03T00:00:00.000Z",
  "summary": "AI forensic analysis suggests CS2 holds an exceptional active review profile...",
  "metrics": {
    "aiRating": "S",
    "reliabilityScore": 88,
    "reliabilityLevel": "High",
    "sakuraRatio": 12,
    "scoreGap": 1,
    "isOmakuni": false,
    "isCultJp": false
  },
  "scoreBreakdown": {
    "graphics": 90,
    "gameplay": 95,
    "story": 70,
    "value": 85,
    "volume": 90,
    "stability": 92
  },
  "gameInfo": {
    "releaseDate": "2012-08-21",
    "developers": ["Valve"],
    "publishers": ["Valve"],
    "genres": ["Action", "Free to Play"],
    "hasJapanese": true,
    "price": {
      "currency": "JPY",
      "initial": 0,
      "final": 0,
      "discountPercent": 0
    }
  },
  "trends": {
    "reliabilityScore": [85, 87, 86, 88, 87, 88],
    "reviewBombIndex": [5, 10, 5, 8, 12, 5],
    "sakuraRatio": [15, 13, 14, 12, 13, 12],
    "reviewVelocity": [120, 130, 125, 140, 135, 142],
    "evaluationGap": [2, 1, 1, 2, 1, 1]
  }
}
GET/api/check/[appId]

지정된 스팀 게임의 기본 조작도(Fraud Score) 및 AI 평가 결과를 조회합니다. 캐시 데이터가 존재하면 즉시 반환되며, 그렇지 않으면 새로 분석 큐에 삽입됩니다.

요청 매개변수

appIdstring필수 (경로)스팀 애플리케이션 식별값 (예: 730)

응답 예시 (JSON)

{
  "appId": "730",
  "gameName": "Counter-Strike 2",
  "status": "completed",
  "rating": "S",
  "fraudScore": 12,
  "expiresAt": "2026-06-03T12:00:00.000Z"
}
GET/api/dataset/download

최근 분석된 500개 게임 요약 데이터를 CSV 형식으로 내려받습니다.

응답 형식

CSV 텍스트 스트림 (Content-Disposition: attachment)
GET/api/dataset/download-json

최근 분석된 500개 게임 요약 데이터를 JSON 배열 형식으로 일괄 조회합니다.

응답 예시 (JSON 배열)

[
  {
    "appId": "730",
    "gameName": "Counter-Strike 2",
    "scoreJp": 88,
    "scoreEn": 89,
    "scoreGap": 1,
    "aiRating": "S",
    "fraudScore": 12
  }
]