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。週は 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 になることがあります。