Cursor – AI Code Tracking API

チームのリポジトリ向けAI生成コード分析にアクセスできるよ。コミット単位のAI使用状況や、受け入れられたAI変更の詳細な内訳が含まれる。

このAPIは最初のリリースだよ。フィードバックに基づいて機能を拡張中—必要なエンドポイントを教えてね！

提供状況: エンタープライズチーム限定
ステータス: Alpha（レスポンスの形やフィールドは変更される可能性がある）

認証

すべてのAPIリクエストにはAPIキーによる認証が必要だよ。このAPIは、他のエンドポイントと同じAdmin APIの認証方式を使ってる。詳しい認証手順はAdmin APIの認証を参照してね。

ベースURL

すべてのAPIエンドポイントは次を使用する：

https://api.cursor.com

レート制限

チームごと、エンドポイントごとに、1分あたり5リクエスト

クエリパラメータ

以下のすべてのエンドポイントは、クエリ文字列で同じクエリパラメータを受け付けるよ:

Parameter	Type	Required	Description
`startDate`	string	date	No	ISO 日付文字列、リテラルの “now”、または “7d”（now から 7 日前）のような相対指定。デフォルト: now - 7 days
`endDate`	string	date	No	ISO 日付文字列、リテラルの “now”、または “0d” のような相対指定。デフォルト: now
`page`	number	No	ページ番号（1 始まり）。デフォルト: 1
`pageSize`	number	No	1 ページあたりの件数。デフォルト: 100、最大: 1000
`user`	string	No	単一ユーザーによる任意のフィルタ。メール（例: developer@company.com）、エンコード済み ID（例: user_abc123…）、または数値 ID（例: 42）を受け付ける

レスポンスでは、接頭辞 user_ を持つエンコード済みの外部 ID として userId を返すよ。これは API で扱う上で安定してる。

セマンティクスとメトリクスの算出方法

Sources: “TAB” は受け入れられたインライン補完、“COMPOSER” は Composer で受け入れられた差分を表す
Lines metrics: tabLinesAdded/Deleted と composerLinesAdded/Deleted は別個にカウントされる。nonAiLinesAdded/Deleted は max(0, totalLines - AI lines) で算出される
Privacy mode: クライアントで有効な場合、fileName など一部のメタデータが省略されることがある
Branch info: 現在のブランチがリポジトリのデフォルトブランチと同一の場合、isPrimaryBranch は true。リポジトリ情報が取得できない場合は未定義のことがある

そのファイルを参照すれば、コミットと変更がどのように検出・報告されるかを理解できる。

エンドポイント

AI Commit Metrics の取得（JSON、ページング対応）

TAB、COMPOSER、非AI に行を帰属させたコミット単位の集計メトリクスを取得する。

GET /analytics/ai-code/commits

レスポンス

{
  items: AiCommitMetric[];
  totalCount: number;
  page: number;
  pageSize: number;
}

AiCommitMetric フィールド

フィールド	型	説明
`commitHash`	string	Git のコミットハッシュ
`userId`	string	エンコード済みユーザーID（例: user_abc123）
`userEmail`	string	ユーザーのメールアドレス
`repoName`	string	null	リポジトリ名
`branchName`	string	null	ブランチ名
`isPrimaryBranch`	boolean	null	プライマリブランチかどうか
`totalLinesAdded`	number	コミットで追加された行数の合計
`totalLinesDeleted`	number	コミットで削除された行数の合計
`tabLinesAdded`	number	TAB 補完で追加された行数
`tabLinesDeleted`	number	TAB 補完で削除された行数
`composerLinesAdded`	number	Composer で追加された行数
`composerLinesDeleted`	number	Composer で削除された行数
`nonAiLinesAdded`	number	null	非AIで追加された行数
`nonAiLinesDeleted`	number	null	非AIで削除された行数
`message`	string	null	コミットメッセージ
`commitTs`	string	null	コミットのタイムスタンプ（ISO 形式）
`createdAt`	string	取り込みタイムスタンプ（ISO 形式）

レスポンス例

{
  "items": [
    {
      "commitHash": "a1b2c3d4",
      "userId": "user_3k9x8q...",
      "userEmail": "developer@company.com",
      "repoName": "company/repo",
      "branchName": "main",
      "isPrimaryBranch": true,
      "totalLinesAdded": 120,
      "totalLinesDeleted": 30,
      "tabLinesAdded": 50,
      "tabLinesDeleted": 10,
      "composerLinesAdded": 40,
      "composerLinesDeleted": 5,
      "nonAiLinesAdded": 30,
      "nonAiLinesDeleted": 15,
      "message": "Refactor: extract analytics client",
      "commitTs": "2025-07-30T14:12:03.000Z",
      "createdAt": "2025-07-30T14:12:30.000Z"
    }
  ],
  "totalCount": 42,
  "page": 1,
  "pageSize": 100
}

リクエスト例

基本的なリクエスト:

curl -X GET "https://api.cursor.com/analytics/ai-code/commits?startDate=7d&endDate=now&page=1&pageSize=100" \
  -u YOUR_API_KEY:

ユーザー（メール）でフィルタ:

curl -X GET "https://api.cursor.com/analytics/ai-code/commits?startDate=2025-06-01T00:00:00Z&endDate=now&user=developer@company.com" \
  -u YOUR_API_KEY:

AI Commit Metrics のダウンロード（CSV、ストリーミング）

大量データ抽出向けに、コミットメトリクスを CSV 形式でダウンロードする。

GET /analytics/ai-code/commits.csv

レスポンス

ヘッダー:

Content-Type: text/csv; charset=utf-8

CSV カラム

Column	Type	Description
`commit_hash`	string	Git のコミットハッシュ
`user_id`	string	エンコード済みユーザー ID
`user_email`	string	ユーザーのメールアドレス
`repo_name`	string	リポジトリ名
`branch_name`	string	ブランチ名
`is_primary_branch`	boolean	プライマリブランチかどうか
`total_lines_added`	number	コミットで追加された行数の合計
`total_lines_deleted`	number	コミットで削除された行数の合計
`tab_lines_added`	number	TAB 補完で追加された行数
`tab_lines_deleted`	number	TAB 補完で削除された行数
`composer_lines_added`	number	Composer で追加された行数
`composer_lines_deleted`	number	Composer で削除された行数
`non_ai_lines_added`	number	非 AI の追加行数
`non_ai_lines_deleted`	number	非 AI の削除行数
`message`	string	コミットメッセージ
`commit_ts`	string	コミットのタイムスタンプ（ISO 形式）
`created_at`	string	取り込みタイムスタンプ（ISO 形式）

サンプル CSV 出力

commit_hash,user_id,user_email,repo_name,branch_name,is_primary_branch,total_lines_added,total_lines_deleted,tab_lines_added,tab_lines_deleted,composer_lines_added,composer_lines_deleted,non_ai_lines_added,non_ai_lines_deleted,message,commit_ts,created_at
a1b2c3d4,user_3k9x8q...,developer@company.com,company/repo,main,true,120,30,50,10,40,5,30,15,"Refactor: extract analytics client",2025-07-30T14:12:03.000Z,2025-07-30T14:12:30.000Z
e5f6g7h8,user_3k9x8q...,developer@company.com,company/repo,feature-branch,false,85,15,30,5,25,3,30,7,"Add error handling",2025-07-30T13:45:21.000Z,2025-07-30T13:45:45.000Z

リクエスト例

curl -L "https://api.cursor.com/analytics/ai-code/commits.csv?startDate=2025-07-01T00:00:00Z&endDate=now&user=user_3k9x8q..." \
  -u YOUR_API_KEY: \
  -o commits.csv

AI コード変更メトリクスを取得（JSON、ページネーション対応）

決定的な changeId ごとにグルーピングされた、粒度の細かい承認済み AI 変更を取得。コミットとは独立に承認された AI イベントを分析するのに便利。

GET /analytics/ai-code/changes

レスポンス

{
  items: AiCodeChangeMetric[];
  totalCount: number;
  page: number;
  pageSize: number;
}

AiCodeChangeMetric フィールド

Field	Type	Description
`changeId`	string	変更の決定的 ID
`userId`	string	エンコード済みユーザー ID（例: user_abc123）
`userEmail`	string	ユーザーのメールアドレス
`source`	”TAB"	"COMPOSER”	AI 変更のソース
`model`	string	null	使用した AI モデル
`totalLinesAdded`	number	追加された行数の合計
`totalLinesDeleted`	number	削除された行数の合計
`createdAt`	string	取り込みタイムスタンプ（ISO 形式）
`metadata`	Array	ファイルのメタデータ（プライバシーモードでは fileName が省略される場合がある）

レスポンス例

{
  "items": [
    {
      "changeId": "749356201",
      "userId": "user_3k9x8q...",
      "userEmail": "developer@company.com",
      "source": "COMPOSER",
      "model": null,
      "totalLinesAdded": 18,
      "totalLinesDeleted": 4,
      "createdAt": "2025-07-30T15:10:12.000Z",
      "metadata": [
        { "fileName": "src/analytics/report.ts", "fileExtension": "ts", "linesAdded": 12, "linesDeleted": 3 },
        { "fileName": "src/analytics/ui.tsx", "fileExtension": "tsx", "linesAdded": 6, "linesDeleted": 1 }
      ]
    }
  ],
  "totalCount": 128,
  "page": 1,
  "pageSize": 200
}

リクエスト例

基本リクエスト:

curl -X GET "https://api.cursor.com/analytics/ai-code/changes?startDate=14d&endDate=now&page=1&pageSize=200" \
  -u YOUR_API_KEY:

ユーザーでフィルタ（エンコード済み ID）:

curl -X GET "https://api.cursor.com/analytics/ai-code/changes?user=user_3k9x8q..." \
  -u YOUR_API_KEY:

ユーザーでフィルタ（メールアドレス）:

curl -X GET "https://api.cursor.com/analytics/ai-code/changes?user=developer@company.com" \
  -u YOUR_API_KEY:

AI Code Change のメトリクスをダウンロード（CSV・ストリーミング）

大規模なデータ抽出向けに、変更メトリクスを CSV 形式でダウンロード。

GET /analytics/ai-code/changes.csv

レスポンス

ヘッダー:

Content-Type: text/csv; charset=utf-8

CSV の列

Column	Type	Description
`change_id`	string	変更の一意な ID
`user_id`	string	エンコード済みユーザー ID
`user_email`	string	ユーザーのメールアドレス
`source`	string	AI 変更の発生元（TAB または COMPOSER）
`model`	string	使用した AI モデル
`total_lines_added`	number	追加行数の合計
`total_lines_deleted`	number	削除行数の合計
`created_at`	string	取り込み時刻（ISO 形式）
`metadata_json`	string	メタデータエントリ配列の JSON 文字列

注意

metadata_json はメタデータエントリ配列の JSON 文字列（プライバシーモードでは fileName を省略する場合あり）
CSV を扱う際は、引用符で囲まれたフィールドを正しくパースしてね

CSV 出力例

change_id,user_id,user_email,source,model,total_lines_added,total_lines_deleted,created_at,metadata_json
749356201,user_3k9x8q...,developer@company.com,COMPOSER,gpt-4o,18,4,2025-07-30T15:10:12.000Z,"[{""fileName"":""src/analytics/report.ts"",""fileExtension"":""ts"",""linesAdded"":12,""linesDeleted"":3},{""fileName"":""src/analytics/ui.tsx"",""fileExtension"":""tsx"",""linesAdded"":6,""linesDeleted"":1}]"
749356202,user_3k9x8q...,developer@company.com,TAB,,8,2,2025-07-30T15:08:45.000Z,"[{""fileName"":""src/utils/helpers.ts"",""fileExtension"":""ts"",""linesAdded"":8,""linesDeleted"":2}]"

リクエスト例

curl -L "https://api.cursor.com/analytics/ai-code/changes.csv?startDate=30d&endDate=now" \
  -u YOUR_API_KEY: \
  -o changes.csv

ヒント

すべてのエンドポイントで特定ユーザーを手早く絞り込むなら user パラメータを使おう
大量データを抽出するときは CSV エンドポイントがおすすめ—サーバー側で1万件単位のページとしてストリーミングされる
クライアントがデフォルトブランチを解決できない場合、isPrimaryBranch は未定義になることがある
commitTs はコミットのタイムスタンプ、createdAt はサーバー側での取り込み時刻
クライアントでプライバシーモードが有効だと、一部のフィールドが存在しない場合がある

変更履歴

アルファ版リリース: コミットと変更の初期エンドポイントを公開。フィードバックに応じてレスポンス形式は今後変わる可能性がある

はじめよう

コア

コンテキスト

連携

モデル

設定

セキュリティ

アカウント

トラブルシューティング

AI Code Tracking API

認証

ベースURL

レート制限

クエリパラメータ

セマンティクスとメトリクスの算出方法

エンドポイント

AI Commit Metrics の取得（JSON、ページング対応）

レスポンス

AiCommitMetric フィールド

レスポンス例

リクエスト例

AI Commit Metrics のダウンロード（CSV、ストリーミング）

レスポンス

CSV カラム

サンプル CSV 出力

リクエスト例

AI コード変更メトリクスを取得（JSON、ページネーション対応）

レスポンス

AiCodeChangeMetric フィールド

レスポンス例

リクエスト例

AI Code Change のメトリクスをダウンロード（CSV・ストリーミング）

レスポンス

CSV の列

注意

CSV 出力例

リクエスト例

ヒント

変更履歴

はじめよう

コア

コンテキスト

連携

モデル

設定

セキュリティ

アカウント

トラブルシューティング

​認証

​ベースURL

​レート制限

​クエリパラメータ

​セマンティクスとメトリクスの算出方法

​エンドポイント

​AI Commit Metrics の取得（JSON、ページング対応）

​レスポンス

​AiCommitMetric フィールド

​レスポンス例

​リクエスト例

​AI Commit Metrics のダウンロード（CSV、ストリーミング）

​レスポンス

​CSV カラム

​サンプル CSV 出力

​リクエスト例

​AI コード変更メトリクスを取得（JSON、ページネーション対応）

​レスポンス

​AiCodeChangeMetric フィールド

​レスポンス例

​リクエスト例

​AI Code Change のメトリクスをダウンロード（CSV・ストリーミング）

​レスポンス

​CSV の列

​注意

​CSV 出力例

​リクエスト例

​ヒント

​変更履歴

認証

ベースURL

レート制限

クエリパラメータ

セマンティクスとメトリクスの算出方法

エンドポイント

AI Commit Metrics の取得（JSON、ページング対応）

レスポンス

AiCommitMetric フィールド

レスポンス例

リクエスト例

AI Commit Metrics のダウンロード（CSV、ストリーミング）

レスポンス

CSV カラム

サンプル CSV 出力

リクエスト例

AI コード変更メトリクスを取得（JSON、ページネーション対応）

レスポンス

AiCodeChangeMetric フィールド

レスポンス例

リクエスト例

AI Code Change のメトリクスをダウンロード（CSV・ストリーミング）

レスポンス

CSV の列

注意

CSV 出力例

リクエスト例

ヒント

変更履歴