Zum Hauptinhalt springen
Greife auf KI-generierte Code-Analysen für die Repositories deines Teams zu. Dazu zählen die KI-Nutzung pro Commit sowie detaillierte, akzeptierte KI-Änderungen.
Die API befindet sich in der ersten Version. Wir erweitern die Funktionen basierend auf Feedback – sag uns, welche Endpunkte du brauchst!
  • Verfügbarkeit: Nur für Enterprise-Teams
  • Status: Alpha (Response-Formate und Felder können sich ändern)

Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mit einem API-Schlüssel. Diese API verwendet dieselbe Admin-API-Authentifizierung wie andere Endpunkte. Ausführliche Hinweise zur Authentifizierung findest du unter Admin-API-Authentifizierung.

Basis-URL

Alle API-Endpunkte verwenden:
https://api.cursor.com

Ratenlimits

  • 5 Anfragen pro Minute pro Team, pro Endpoint

Abfrageparameter

Alle folgenden Endpunkte akzeptieren dieselben Abfrageparameter über den Query-String:
ParameterTypErforderlichBeschreibung
startDatestringdateNeinISO-Datums-String, das Literal “now” oder relative Tage wie “7d” (entspricht now - 7 days). Standard: now - 7 days
endDatestringdateNeinISO-Datums-String, das Literal “now” oder relative Tage wie “0d”. Standard: now
pagenumberNeinSeitennummer (1-basiert). Standard: 1
pageSizenumberNeinErgebnisse pro Seite. Standard: 100, max.: 1000
userstringNeinOptionaler Filter auf einen einzelnen User. Akzeptiert E-Mail (z. B. developer@company.com), kodierte ID (z. B. user_abc123…) oder numerische ID (z. B. 42)
Responses geben userId als kodierte externe ID mit dem Präfix user_ zurück. Das ist für die API-Nutzung stabil.

Semantik und Berechnung der Metriken

  • Quellen: „TAB“ steht für akzeptierte Inline-Completions; „COMPOSER“ steht für akzeptierte Diffs aus Composer
  • Zeilenmetriken: tabLinesAdded/Deleted und composerLinesAdded/Deleted werden separat gezählt; nonAiLinesAdded/Deleted werden als max(0, totalLines - AI lines) abgeleitet
  • Privacy-Mode: Wenn im Client aktiviert, können einige Metadaten (wie fileName) ausgelassen werden
  • Branch-Info: isPrimaryBranch ist true, wenn der aktuelle Branch dem Standard-Branch des Repos entspricht; kann undefined sein, wenn Repo-Infos nicht verfügbar sind
Du kannst diese Datei scannen, um nachzuvollziehen, wie Commits und Änderungen erkannt und gemeldet werden.

Endpunkte

AI-Commit-Metriken abrufen (JSON, paginiert)

Abrufe aggregierter Metriken pro Commit, die Zeilen TAB, COMPOSER und Nicht-AI zuordnen.
GET /analytics/ai-code/commits

Antwort

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

AiCommitMetric-Felder

FeldTypBeschreibung
commitHashstringGit-Commit-Hash
userIdstringKodierte Benutzer-ID (z. B. user_abc123)
userEmailstringE-Mail-Adresse des Users
repoNamestringnullRepositoryname
branchNamestringnullBranchname
isPrimaryBranchbooleannullOb dies der primäre Branch ist
totalLinesAddednumberInsgesamt hinzugefügte Zeilen im Commit
totalLinesDeletednumberInsgesamt gelöschte Zeilen im Commit
tabLinesAddednumberÜber Tab-Completions hinzugefügte Zeilen
tabLinesDeletednumberÜber Tab-Completions gelöschte Zeilen
composerLinesAddednumberÜber Composer hinzugefügte Zeilen
composerLinesDeletednumberÜber Composer gelöschte Zeilen
nonAiLinesAddednumbernullNicht-AI-Zeilen hinzugefügt
nonAiLinesDeletednumbernullNicht-AI-Zeilen gelöscht
messagestringnullCommit-Nachricht
commitTsstringnullCommit-Zeitstempel (ISO-Format)
createdAtstringIngestionszeitstempel (ISO-Format)

Beispielantwort

{
  "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: Analytics-Client extrahiert"
      "commitTs": "2025-07-30T14:12:03.000Z",
      "createdAt": "2025-07-30T14:12:30.000Z"
    }
  ],
  "totalCount": 42,
  "page": 1,
  "pageSize": 100
}

Beispielanfragen

Einfache Anfrage:
curl -X GET "https://api.cursor.com/analytics/ai-code/commits?startDate=7d&endDate=now&page=1&pageSize=100" \
  -u DEIN_API_KEY:
Nach Benutzer filtern (E-Mail):
curl -X GET "https://api.cursor.com/analytics/ai-code/commits?startDate=2025-06-01T00:00:00Z&endDate=now&user=developer@company.com" \
  -u DEIN_API_SCHLÜSSEL:

AI-Commit-Metriken herunterladen (CSV, Streaming)

Commit-Metriken als CSV für große Datenauszüge herunterladen.
GET /analytics/ai-code/commits.csv

Antwort

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

CSV-Spalten

SpalteTypBeschreibung
commit_hashstringGit-Commit-Hash
user_idstringKodierte Nutzer-ID
user_emailstringE-Mail-Adresse des Nutzers
repo_namestringRepository-Name
branch_namestringBranch-Name
is_primary_branchbooleanOb dies der primäre Branch ist
total_lines_addednumberInsgesamt im Commit hinzugefügte Zeilen
total_lines_deletednumberInsgesamt im Commit gelöschte Zeilen
tab_lines_addednumberÜber Tab-Vervollständigungen hinzugefügte Zeilen
tab_lines_deletednumberÜber Tab-Vervollständigungen gelöschte Zeilen
composer_lines_addednumberÜber Composer hinzugefügte Zeilen
composer_lines_deletednumberÜber Composer gelöschte Zeilen
non_ai_lines_addednumberNicht-AI-Zeilen hinzugefügt
non_ai_lines_deletednumberNicht-AI-Zeilen gelöscht
messagestringCommit-Nachricht
commit_tsstringCommit-Zeitstempel (ISO-Format)
created_atstringErfassungszeitpunkt (ISO-Format)

Beispielausgabe (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: Analytics-Client ausgelagert",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,"Fehlerbehandlung hinzugefügt",2025-07-30T13:45:21.000Z,2025-07-30T13:45:45.000Z

Beispielanfrage

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

AI-Code-Change-Metriken abrufen (JSON, paginiert)

Ruf detaillierte, akzeptierte AI-Änderungen ab, gruppiert nach deterministischer changeId. Nützlich, um akzeptierte AI-Events unabhängig von Commits zu analysieren.
GET /analytics/ai-code/changes

Antwort

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

AiCodeChangeMetric-Felder

FeldTypBeschreibung
changeIdstringDeterministische ID der Änderung
userIdstringKodierte User-ID (z. B. user_abc123)
userEmailstringE-Mail-Adresse des Users
source”TAB""COMPOSER”Quelle der KI-Änderung
modelstringnullVerwendetes KI-Modell
totalLinesAddednumberGesamtzahl hinzugefügter Zeilen
totalLinesDeletednumberGesamtzahl gelöschter Zeilen
createdAtstringIngestions-Timestamp (ISO-Format)
metadataArrayDateimetadaten (fileName kann im Privacy-Modus weggelassen werden)

Beispiel-Response

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

Beispielanfragen

Einfache Anfrage:
curl -X GET "https://api.cursor.com/analytics/ai-code/changes?startDate=14d&endDate=now&page=1&pageSize=200" \
  -u DEIN_API_KEY:
Nach User filtern (kodierte ID):
curl -X GET "https://api.cursor.com/analytics/ai-code/changes?user=user_3k9x8q..." \
  -u DEIN_API_KEY:
Nach Benutzer filtern (E-Mail):
curl -X GET "https://api.cursor.com/analytics/ai-code/changes?user=developer@company.com" \
  -u DEIN_API_KEY:

AI-Code-Änderungsmetriken herunterladen (CSV, Streaming)

Lad Änderungsmetriken als CSV für umfangreiche Datenextraktionen herunter.
GET /analytics/ai-code/changes.csv

Antwort

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

CSV-Spalten

SpalteTypBeschreibung
change_idstringDeterministische ID der Änderung
user_idstringKodierte Benutzer-ID
user_emailstringE‑Mail-Adresse des Users
sourcestringQuelle der KI-Änderung (TAB oder COMPOSER)
modelstringVerwendetes KI-Modell
total_lines_addednumberGesamtzahl hinzugefügter Zeilen
total_lines_deletednumberGesamtzahl gelöschter Zeilen
created_atstringIngestions-Timestamp (ISO-Format)
metadata_jsonstringJSON-serialisiertes Array von Metadaten-Einträgen

Hinweise

  • metadata_json ist ein JSON-serialisiertes Array von Metadaten-Einträgen (im Datenschutzmodus kann fileName entfallen)
  • Beim Verarbeiten von CSV unbedingt gequotete Felder korrekt parsen

Beispielausgabe (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}]"

Beispielanfrage

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

Tipps

  • Verwende den Parameter user, um schnell einen einzelnen User über alle Endpunkte zu filtern
  • Für große Datenextraktionen nutze lieber die CSV-Endpunkte — sie streamen serverseitig in Seiten mit 10.000 Einträgen
  • isPrimaryBranch kann undefined sein, wenn der Client den Default-Branch nicht auflösen konnte
  • commitTs ist der Commit-Zeitstempel; createdAt ist die Zeit, zu der die Daten auf unseren Servern ingestiert wurden
  • Einige Felder können fehlen, wenn der Privacy-Mode im Client aktiviert ist

Changelog

  • Alpha-Release: Erste Endpunkte für Commits und Änderungen. Response-Formate können sich anhand von Feedback weiterentwickeln
I