Skip to content
PleumRouter

Public Stats

익명·집계된 공개 이용 통계를 조회합니다. 인증 없이 호출할 수 있습니다.

아래 엔드포인트들은 모두 공개 엔드포인트로 인증이 필요 없으며, 익명·집계된 수치만 반환합니다 — 개인 식별 정보나 개별 요청 내용은 포함되지 않습니다. 앱별 토큰 리더보드(GET /v1/stats/apps)는 App Attribution 페이지에서 다룹니다.

모델별 호출 통계#

GET/v1/stats/models

기간 내 호출 수 기준 상위 20개 모델과 전체 호출 수를 반환합니다. 기본 기간은 daily입니다.

파라미터타입필수설명
periodstring선택daily | weekly | monthly.
200 OK
{
  "period": "daily",
  "generated_at": "2026-07-03T09:00:00+00:00",
  "total_calls": 4210,
  "top_models": [
    {"model": "gpt-4o-mini", "calls": 1840},
    {"model": "claude-sonnet-4-6", "calls": 920}
  ]
}

리더보드 · 마켓셰어#

GET/v1/stats/rankings

OpenRouter의 rankings에 대응하는 엔드포인트입니다. 토큰 사용량 기준 상위 20개 모델 리더보드(leaderboard)와 상위 12개 프로바이더 마켓셰어 (market_share)를 반환합니다. 실패한 호출(상태 코드 400 이상)은 집계에서 제외됩니다. 기본 기간은 weekly입니다.

파라미터타입필수설명
periodstring선택daily | weekly | monthly.
200 OK
{
  "period": "weekly",
  "generated_at": "2026-07-03T09:00:00+00:00",
  "total_tokens": 48210000,
  "leaderboard": [
    {
      "rank": 1,
      "model": "claude-sonnet-4-6",
      "provider": "anthropic",
      "maker": "Anthropic",
      "tokens": 21400000,
      "calls": 8120,
      "trend_pct": 12.4
    }
  ],
  "market_share": [
    {"provider": "anthropic", "tokens": 21400000, "share_pct": 44.4},
    {"provider": "openai", "tokens": 15200000, "share_pct": 31.5}
  ]
}

maker는 모델 제조사(랩)이고 provider는 호스팅 프로바이더입니다. trend_pct는 직전 기간 대비 토큰 변화율(%) 이며, 이전 데이터가 없으면 null입니다. share_pct는 상위 12개 프로바이더 합계 대비 비중(%)입니다.

토큰 사용량 시계열#

GET/v1/stats/usage-timeseries

버킷별 × 상위 N개 모델 토큰 사용량 시계열입니다. 전체 기간 토큰 상위 N개 모델은 개별 시리즈로, 나머지는 "Others"로 합산됩니다. 토큰 과금(텍스트) 모달리티만 집계하며, 비용은 노출하지 않고 토큰 수만 반환합니다.

파라미터타입필수설명
rangestring선택30d | 12w | 24w. 기본값 30d.
granularitystring선택day | week. 기본값 day. week는 ISO 주(월요일 시작) 기준.
topinteger선택개별 시리즈로 노출할 상위 모델 수. 1 ~ 20, 기본값 8.
200 OK
{
  "range": "30d",
  "granularity": "day",
  "generated_at": "2026-07-03T09:00:00+00:00",
  "series": ["gpt-4o-mini", "claude-sonnet-4-6", "Others"],
  "points": [
    {
      "t": "2026-07-02",
      "tokens": {"gpt-4o-mini": 820000, "claude-sonnet-4-6": 610000, "Others": 90000},
      "total": 1520000
    }
  ],
  "total_tokens": 48210000
}
트래픽이 적은 초기에는 목록이 비어 있거나 trend_pct가 null일 수 있습니다.