Cursor – AI Code Tracking API

Доступ к аналитике кода на основе ИИ для репозиториев твоей команды. Включает пометку использования ИИ для каждого коммита и детальные сведения о принятых ИИ-изменениях.

Это первый релиз API. Мы расширяем возможности по фидбеку — дай знать, какие endpoints тебе нужны!

Availability: Только для enterprise-команд
Status: Альфа (структуры ответов и поля могут изменяться)

Аутентификация

Все запросы к API требуют аутентификации с использованием ключа API. Этот API использует ту же аутентификацию Admin API, что и другие эндпоинты. Подробные инструкции по аутентификации смотри в разделе Admin API authentication.

Базовый URL

Все эндпоинты API используют:

https://api.cursor.com

Лимиты запросов

5 запросов в минуту на команду на каждый эндпоинт

Параметры запроса

Все эндпоинты ниже принимают те же параметры через query string:

Параметр	Тип	Обязательный	Описание
`startDate`	string	date	Нет	Строка даты в формате ISO, литерал “now” или относительные дни, например “7d” (означает now − 7 дней). По умолчанию: now − 7 дней
`endDate`	string	date	Нет	Строка даты в формате ISO, литерал “now” или относительные дни, например “0d”. По умолчанию: now
`page`	number	Нет	Номер страницы (от 1). По умолчанию: 1
`pageSize`	number	Нет	Результатов на страницу. По умолчанию: 100, максимум: 1000
`user`	string	Нет	Необязательный фильтр по одному пользователю. Принимает email (например, developer@company.com), закодированный ID (например, user_abc123…) или числовой ID (например, 42)

В ответах userId возвращается как закодированный внешний ID с префиксом user_. Это стабильно для использования через API.

Семантика и как вычисляются метрики

Источники: “TAB” — принятые inline‑дополнения; “COMPOSER” — принятые диффы из Composer
Метрики по строкам: tabLinesAdded/Deleted и composerLinesAdded/Deleted считаются отдельно; nonAiLinesAdded/Deleted вычисляются как max(0, totalLines - AI lines)
Режим приватности: если включён на клиенте, некоторые метаданные (например, fileName) могут быть опущены
Информация о ветке: isPrimaryBranch равно true, когда текущая ветка совпадает с веткой по умолчанию репозитория; может быть undefined, если информация о репозитории недоступна

Ты можешь посмотреть этот файл, чтобы понять, как обнаруживаются и фиксируются коммиты и изменения.

Эндпоинты

Получить метрики AI-коммитов (JSON, с пагинацией)

Получить агрегированные метрики по каждому коммиту с распределением строк между TAB, COMPOSER и non-AI.

GET /analytics/ai-code/commits

Ответ

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

Поля AiCommitMetric

Field	Type	Description
`commitHash`	string	Хеш коммита в Git
`userId`	string	Закодированный ID пользователя (например, user_abc123)
`userEmail`	string	Email пользователя
`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:

Фильтр по пользователю (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:

Скачать метрики AI-коммитов (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	Строки, добавленные без участия ИИ
`non_ai_lines_deleted`	number	Строки, удалённые без участия ИИ
`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-события независимо от коммитов.

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”	Источник изменения от ИИ
`model`	string	null	Используемая модель ИИ
`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:

Фильтр по пользователю (email):

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

Скачать метрики изменений AI-кода (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	Email пользователя
`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-эндпоинты — они стримят по страницам по 10 000 записей на стороне сервера
isPrimaryBranch может быть неопределён, если клиент не смог определить ветку по умолчанию
commitTs — это отметка времени коммита; createdAt — время поступления данных на наши серверы
Некоторые поля могут отсутствовать, если на клиенте включён режим приватности

Журнал изменений

Альфа-релиз: Первичные эндпоинты для коммитов и изменений. Формат ответа может меняться на основе отзывов

Начни

Ядро

Контекст

Интеграции

Модели

Конфигурация

Безопасность

Аккаунт

Устранение неполадок

AI Code Tracking API

Аутентификация

Базовый URL

Лимиты запросов

Параметры запроса

Семантика и как вычисляются метрики

Эндпоинты

Получить метрики AI-коммитов (JSON, с пагинацией)

Ответ

Поля AiCommitMetric

Пример ответа

Примеры запросов

Скачать метрики AI-коммитов (CSV, потоковая передача)

Ответ

Колонки CSV

Пример CSV-вывода

Пример запроса

Получить метрики изменений AI-кода (JSON, постранично)

Ответ

Поля AiCodeChangeMetric

Пример ответа

Примеры запросов

Скачать метрики изменений AI-кода (CSV, потоковая передача)

Ответ

Столбцы CSV

Примечания

Пример вывода CSV

Пример запроса

Советы

Журнал изменений

Начни

Ядро

Контекст

Интеграции

Модели

Конфигурация

Безопасность

Аккаунт

Устранение неполадок

​Аутентификация

​Базовый URL

​Лимиты запросов

​Параметры запроса

​Семантика и как вычисляются метрики

​Эндпоинты

​Получить метрики AI-коммитов (JSON, с пагинацией)

​Ответ

​Поля AiCommitMetric

​Пример ответа

​Примеры запросов

​Скачать метрики AI-коммитов (CSV, потоковая передача)

​Ответ

​Колонки CSV

​Пример CSV-вывода

​Пример запроса

​Получить метрики изменений AI-кода (JSON, постранично)

​Ответ

​Поля AiCodeChangeMetric

​Пример ответа

​Примеры запросов

​Скачать метрики изменений AI-кода (CSV, потоковая передача)

​Ответ

​Столбцы CSV

​Примечания

​Пример вывода CSV

​Пример запроса

​Советы

​Журнал изменений

Аутентификация

Базовый URL

Лимиты запросов

Параметры запроса

Семантика и как вычисляются метрики

Эндпоинты

Получить метрики AI-коммитов (JSON, с пагинацией)

Ответ

Поля AiCommitMetric

Пример ответа

Примеры запросов

Скачать метрики AI-коммитов (CSV, потоковая передача)

Ответ

Колонки CSV

Пример CSV-вывода

Пример запроса

Получить метрики изменений AI-кода (JSON, постранично)

Ответ

Поля AiCodeChangeMetric

Пример ответа

Примеры запросов

Скачать метрики изменений AI-кода (CSV, потоковая передача)

Ответ

Столбцы CSV

Примечания

Пример вывода CSV

Пример запроса

Советы

Журнал изменений