Cursor – AI Code Tracking API

Akses analitik kode berbasis AI untuk repositori tim kamu. Termasuk penggunaan AI per commit serta perubahan AI yang diterima secara mendetail.

API ini adalah rilis pertama. Kami akan menambah kapabilitas berdasarkan masukan — kasih tahu kami endpoint apa yang kamu butuhin!

Availability: Hanya untuk tim enterprise
Status: Alpha (bentuk respons dan field bisa berubah)

Autentikasi

Semua permintaan API harus diautentikasi menggunakan kunci API. API ini menggunakan skema autentikasi Admin API yang sama seperti endpoint lainnya. Untuk petunjuk autentikasi yang lebih lengkap, lihat Autentikasi Admin API.

URL Dasar

Semua endpoint API memakai:

https://api.cursor.com

Batasan Rate

5 permintaan per menit per tim, per endpoint

Parameter Kueri

Semua endpoint di bawah menerima parameter kueri yang sama lewat query string:

Parameter	Tipe	Wajib	Deskripsi
`startDate`	string	date	Tidak	String tanggal ISO, literal “now”, atau hari relatif seperti “7d” (artinya sekarang - 7 hari). Default: sekarang - 7 hari
`endDate`	string	date	Tidak	String tanggal ISO, literal “now”, atau hari relatif seperti “0d”. Default: sekarang
`page`	number	Tidak	Nomor halaman (1-based). Default: 1
`pageSize`	number	Tidak	Jumlah hasil per halaman. Default: 100, Maks: 1000
`user`	string	Tidak	Filter opsional untuk satu pengguna. Menerima email (mis., developer@company.com), ID terenkode (mis., user_abc123…), atau ID numerik (mis., 42)

Respons mengembalikan userId sebagai external ID terenkripsi dengan prefiks user_. Nilai ini stabil untuk konsumsi API.

Semantik dan Cara Perhitungan Metrik

Sumber: “TAB” merepresentasikan penyelesaian inline yang diterima; “COMPOSER” merepresentasikan diff yang diterima dari Composer
Metrik baris: tabLinesAdded/Deleted dan composerLinesAdded/Deleted dihitung terpisah; nonAiLinesAdded/Deleted diturunkan sebagai max(0, totalLines - AI lines)
Mode privasi: Jika diaktifkan di klien, sebagian metadata (seperti fileName) mungkin dihilangkan
Info branch: isPrimaryBranch bernilai true ketika branch saat ini sama dengan default branch repo; bisa undefined jika info repo tidak tersedia

Kamu bisa memindai file itu untuk memahami bagaimana commit dan perubahan dideteksi dan dilaporkan.

Endpoint

Dapatkan Metrik Commit AI (JSON, dipaginasi)

Ambil metrik per commit yang teragregasi dan mengatribusikan baris ke TAB, COMPOSER, dan non-AI.

GET /analytics/ai-code/commits

Respons

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

Field AiCommitMetric

Field	Type	Description
`commitHash`	string	Hash commit Git
`userId`	string	ID pengguna yang terenkode (mis., user_abc123)
`userEmail`	string	Alamat email pengguna
`repoName`	string	null	Nama repositori
`branchName`	string	null	Nama branch
`isPrimaryBranch`	boolean	null	Apakah ini branch utama
`totalLinesAdded`	number	Total baris yang ditambahkan dalam commit
`totalLinesDeleted`	number	Total baris yang dihapus dalam commit
`tabLinesAdded`	number	Baris yang ditambahkan melalui penyelesaian TAB
`tabLinesDeleted`	number	Baris yang dihapus melalui penyelesaian TAB
`composerLinesAdded`	number	Baris yang ditambahkan melalui Composer
`composerLinesDeleted`	number	Baris yang dihapus melalui Composer
`nonAiLinesAdded`	number	null	Baris non-AI yang ditambahkan
`nonAiLinesDeleted`	number	null	Baris non-AI yang dihapus
`message`	string	null	Pesan commit
`commitTs`	string	null	Timestamp commit (format ISO)
`createdAt`	string	Timestamp ingestion (format ISO)

Contoh Respons

{
  "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
}

Contoh Permintaan

Permintaan dasar:

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

Filter berdasarkan pengguna (email):

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:

Unduh Metrik Commit AI (CSV, streaming)

Unduh data metrik commit dalam format CSV untuk ekstraksi data skala besar.

GET /analytics/ai-code/commits.csv

Respons

Header:

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

Kolom CSV

Kolom	Tipe	Deskripsi
`commit_hash`	string	Hash commit Git
`user_id`	string	ID pengguna yang terenkode
`user_email`	string	Alamat email pengguna
`repo_name`	string	Nama repositori
`branch_name`	string	Nama branch
`is_primary_branch`	boolean	Apakah ini branch utama
`total_lines_added`	number	Total baris yang ditambahkan pada commit
`total_lines_deleted`	number	Total baris yang dihapus pada commit
`tab_lines_added`	number	Baris yang ditambahkan lewat penyelesaian TAB
`tab_lines_deleted`	number	Baris yang dihapus lewat penyelesaian TAB
`composer_lines_added`	number	Baris yang ditambahkan lewat Composer
`composer_lines_deleted`	number	Baris yang dihapus lewat Composer
`non_ai_lines_added`	number	Baris non-AI yang ditambahkan
`non_ai_lines_deleted`	number	Baris non-AI yang dihapus
`message`	string	Pesan commit
`commit_ts`	string	Stempel waktu commit (format ISO)
`created_at`	string	Stempel waktu ingest (format ISO)

Contoh Output 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

Contoh Permintaan

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

Dapatkan Metrik Perubahan Kode AI (JSON, terpaginasikan)

Ambil perubahan AI yang diterima secara terperinci, dikelompokkan berdasarkan changeId deterministik. Berguna untuk menganalisis event AI yang diterima terlepas dari commit.

GET /analytics/ai-code/changes

Respons

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

Field AiCodeChangeMetric

Field	Tipe	Deskripsi
`changeId`	string	ID deterministik untuk perubahan
`userId`	string	ID pengguna yang terenkode (mis., user_abc123)
`userEmail`	string	Alamat email pengguna
`source`	”TAB"	"COMPOSER”	Sumber perubahan AI
`model`	string	null	Model AI yang digunakan
`totalLinesAdded`	number	Total baris yang ditambahkan
`totalLinesDeleted`	number	Total baris yang dihapus
`createdAt`	string	Stempel waktu ingest (format ISO)
`metadata`	Array	Metadata file (fileName dapat dihilangkan dalam mode privasi)

Contoh Respons

{
  "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
}

Contoh Permintaan

Permintaan dasar:

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

Filter berdasarkan pengguna (ID terenkode):

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

Filter berdasarkan pengguna (email):

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

Unduh Metrik Perubahan Kode AI (CSV, streaming)

Unduh data metrik perubahan dalam format CSV untuk ekstraksi data skala besar.

GET /analytics/ai-code/changes.csv

Respons

Headers:

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

Kolom CSV

Column	Type	Description
`change_id`	string	ID deterministik untuk perubahan
`user_id`	string	ID pengguna terenkode
`user_email`	string	Alamat email pengguna
`source`	string	Sumber perubahan AI (TAB atau COMPOSER)
`model`	string	Model AI yang digunakan
`total_lines_added`	number	Total baris yang ditambahkan
`total_lines_deleted`	number	Total baris yang dihapus
`created_at`	string	Timestamp ingestion (format ISO)
`metadata_json`	string	Array entri metadata yang diserialisasi ke string JSON

Catatan

metadata_json adalah array entri metadata yang diserialisasi ke string JSON (mungkin menghilangkan fileName dalam mode privasi)
Saat memproses CSV, pastikan untuk mengurai field yang diapit tanda kutip

Contoh Output 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}]"

Contoh Permintaan

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

Tips

Pakai parameter user buat cepat nyaring satu user di semua endpoint
Buat ekstraksi data besar, prioritaskan endpoint CSV—mereka nge-stream per halaman 10.000 record di sisi server
isPrimaryBranch bisa undefined kalau client nggak bisa nge-resolve default branch
commitTs adalah timestamp commit; createdAt adalah waktu ingest di server kami
Beberapa field bisa aja nggak ada kalau privacy mode diaktifin di client

Changelog

Rilis alpha: Endpoint awal untuk commit dan perubahan. Struktur respons bisa berubah berdasarkan masukan

Mulai

Inti

Konteks

Integrasi

Model

Konfigurasi

Keamanan

Akun

Pemecahan Masalah

AI Code Tracking API

Autentikasi

URL Dasar

Batasan Rate

Parameter Kueri

Semantik dan Cara Perhitungan Metrik

Endpoint

Dapatkan Metrik Commit AI (JSON, dipaginasi)

Respons

Field AiCommitMetric

Contoh Respons

Contoh Permintaan

Unduh Metrik Commit AI (CSV, streaming)

Respons

Kolom CSV

Contoh Output CSV

Contoh Permintaan

Dapatkan Metrik Perubahan Kode AI (JSON, terpaginasikan)

Respons

Field AiCodeChangeMetric

Contoh Respons

Contoh Permintaan

Unduh Metrik Perubahan Kode AI (CSV, streaming)

Respons

Kolom CSV

Catatan

Contoh Output CSV

Contoh Permintaan

Tips

Changelog

Mulai

Inti

Konteks

Integrasi

Model

Konfigurasi

Keamanan

Akun

Pemecahan Masalah

​Autentikasi

​URL Dasar

​Batasan Rate

​Parameter Kueri

​Semantik dan Cara Perhitungan Metrik

​Endpoint

​Dapatkan Metrik Commit AI (JSON, dipaginasi)

​Respons

​Field AiCommitMetric

​Contoh Respons

​Contoh Permintaan

​Unduh Metrik Commit AI (CSV, streaming)

​Respons

​Kolom CSV

​Contoh Output CSV

​Contoh Permintaan

​Dapatkan Metrik Perubahan Kode AI (JSON, terpaginasikan)

​Respons

​Field AiCodeChangeMetric

​Contoh Respons

​Contoh Permintaan

​Unduh Metrik Perubahan Kode AI (CSV, streaming)

​Respons

​Kolom CSV

​Catatan

​Contoh Output CSV

​Contoh Permintaan

​Tips

​Changelog

Autentikasi

URL Dasar

Batasan Rate

Parameter Kueri

Semantik dan Cara Perhitungan Metrik

Endpoint

Dapatkan Metrik Commit AI (JSON, dipaginasi)

Respons

Field AiCommitMetric

Contoh Respons

Contoh Permintaan

Unduh Metrik Commit AI (CSV, streaming)

Respons

Kolom CSV

Contoh Output CSV

Contoh Permintaan

Dapatkan Metrik Perubahan Kode AI (JSON, terpaginasikan)

Respons

Field AiCodeChangeMetric

Contoh Respons

Contoh Permintaan

Unduh Metrik Perubahan Kode AI (CSV, streaming)

Respons

Kolom CSV

Catatan

Contoh Output CSV

Contoh Permintaan

Tips

Changelog