Skip to main content
GET
消費量分析を取得する
これはv2 エンドポイントで、リクエストボディでサービスキーを使用する v1 Analytics API とは異なり、Bearerトークン認証とクエリパラメータを使用します。詳細は以下のAuthenticationを参照してください。
このエンドポイントはリアルタイムの使用量監視向けではありません。データは1時間単位で集計され、 レート制限も低く設定されています (チームごとに1時間あたり10リクエスト) 。定期レポートや一括エクスポートに利用してください。

認証

このエンドポイントでは、Bearer トークンによる認証を利用します。Authorization ヘッダーにトークンを含めてください。
Use Local Analytics API 権限を持つ Devin サービスユーザー APIキー、または Analytics Read 権限を持つ Windsurf サービスキーを使用します。各キーの作成方法については、 Authentication を参照してください。

請求方式

レスポンスの形式は、チームの請求方式によって異なります。 message_count フィールドと user_message_count フィールド (consumption 内) は、 請求方式に関係なく返されます。user_message_count は、ユーザーがエージェントに送信したメッセージのみをカウントします。送信元のクライアント (Devin Desktop、JetBrains プラグイン、CLI) は問いません。この値は、分析 UI の「送信メッセージ数」と同じです。 message_count は、各ターン内で後続して発生するモデルやツールへのリクエストも含め、すべての請求イベントをカウントします。ユーザーメッセージの帰属情報がない行 (2026-04-11 より前の使用量) では、 user_message_count は null になります。

グループ化と粒度

granularity と group_by を利用して、返されるデータの形式を制御できます。
  • 粒度やグループ化の指定なし — 日付範囲全体を集計した単一の行を返します
  • granularity=daily — 各行に YYYY-MM-DD 形式の timestamp が含まれます
  • granularity=monthly — 各行に YYYY-MM 形式の timestamp が含まれます
  • group_by=user — 各行に user_id と user_email が含まれます
  • group_by=user,model_uid — 各行に user_id、user_email、model_uid が含まれます
  • group_by=ide — 各行に ide が含まれます
  • group_by=ide,ide_version — 各行に ide と ide_version が含まれます (ide_version でグループ化するには、ide も含める必要があります)
  • group_by=os — 各行に darwin (macOS)、windows、linux などの os が含まれます
エージェントが消費した量ではなく、生成した量を測定するには Get Output (metric=loc_inserted,loc_deleted) を利用してください。同じフィルターとグループ化ディメンションを使って、 採用されたコード行数を取得できます。

ページネーション

結果は、デフォルトで 1,000 行 (最大 10,000 行) ごとにページ分割されます。さらに結果がある場合、レスポンスの pagination オブジェクトには next_page_cursor が含まれます。次のページを取得するには、これを page_cursor クエリ パラメータとして渡します。 ページカーソルは 24 時間で失効します。後続のページリクエストは、レート制限に対する新たなクエリとしてはカウントされません。

レート制限

このエンドポイントには、チームごとに1時間あたり10リクエストのレート制限があります。この 制限を超えると、サーバーは Retry-After ヘッダーとともに 429 Too Many Requests を返します。 前にクエリした結果のページネーション (next_page_cursor に従うこと) は、この制限にはカウントされません— カウントされるのは、各レポートに対して初回にクエリする場合のみです。制限値が低く設定されているのは、このエンドポイントが 定期的なレポート用であり、リアルタイムの使用量監視を目的としたものではないためです。

承認

Authorization
string
header
必須

Authorization ヘッダーで Bearer トークンとして渡す、Analytics Read 権限を持つサービスキー。

サービスキーは、チーム設定 の「Service Keys」セクションで作成します。

クエリパラメータ

start_date
string<date>
必須

日付範囲の開始日(この日を含む)。形式は YYYY-MM-DD です。

end_date
string<date>
必須

日付範囲の終了日(この日を含む)。形式は YYYY-MM-DD です。範囲は 90 日を超えてはいけません。

product
enum<string>
必須

消費量をクエリする対象の product。

利用可能なオプション:
agent
granularity
enum<string>

結果をグループ化する時間粒度。指定した場合、各行に timestamp フィールドが含まれます。 省略した場合、結果は日付範囲全体で集計されます。

利用可能なオプション:
daily,
monthly
group_by
string

結果のグループ化に利用するディメンションのカンマ区切りリスト。対応しているディメンション:

  • user — 各行に user_id と user_email が含まれます
  • model_uid — 各行に model_uid が含まれます
  • ide — 各行に ide が含まれます
  • ide_version — 各行に ide_version が含まれます。これを含めるには、ide も含める必要があります
  • os — 各行に os が含まれます
models
string

結果の絞り込み対象とする model UID のカンマ区切りリスト。

group_id
string

結果を特定の group に属する user に絞り込みます。サービスキーにはこの group へのアクセス権が必要です。

user_id
string

結果を特定の user(auth UID)に絞り込みます。

page_size
integer
デフォルト:1000

1 ページあたりに返す最大行数。

必須範囲: 1 <= x <= 10000
page_cursor
string

次のページを取得するための、以前のレスポンスの pagination.next_page_cursor に含まれる不透明なカーソル。

レスポンス

消費量データが正常に返されました。

data
object[]
必須

消費量データ行の配列。

pagination
object
必須
metadata
object
必須