Обзор
Claude Enterprise Analytics API предоставляет вашей организации программный доступ к данным об использовании Claude и Claude Code в рамках вашей Enterprise организации. Независимо от того, создаёте ли вы внутренние панели мониторинга активности пользователей или отслеживаете внедрение проектов, этот API предоставляет необходимые вам агрегированные метрики.
Агрегация данных
Все данные агрегируются по организации, в день. Каждая конечная точка возвращает снимок для одной указанной даты. Данные за день (N-1) обрабатываются в 10:00:00 UTC в день N и доступны для запроса через три дня после агрегации для обеспечения точности данных.
Если данные недоступны в указанный выше период, это обычно указывает на сбой конвейера данных, который нашей команде потребуется исследовать внутри. Мы обычно осведомлены о таких проблемах, но пожалуйста, обратитесь к своему CSM, если вы хотите проверить или подозреваете что-то ещё.
Включение доступа
Чтобы создать новые ключи API аналитики, вы должны быть основным владельцем (Primary Owner) в вашей Enterprise организации. Вы можете сделать это, перейдя на claude.ai/analytics/api-keys.
Вот несколько дополнительных деталей, которые могут быть полезны:
Вы можете включать/отключать доступ к публичному API в любое время. Если вы отключите доступ, переключив переключатель, все запросы будут отклонены.
Вам потребуется ключ с областью
read:analyticsдля доступа к API. Вы можете создать несколько ключей для вашей организации, но ограничения скорости применяются на уровне организации, а не на уровне ключа. См. раздел "Ограничение скорости" ниже.Как всегда, мы настоятельно рекомендуем безопасно обращаться с ключами API: никогда не делитесь этими ключами публично - они являются секретными и должны быть переданы безопасно.
Базовый URL
Все запросы отправляются на:
https://api.anthropic.com/v1/organizations/analytics/
Аутентификация
Каждый запрос требует ключ API, переданный в заголовке x-api-key. Ваш ключ API должен иметь область read:analytics. Вы можете создавать и управлять ключами API из параметров администратора claude.ai в разделе "Ключи API".
Пример заголовков запроса:
x-api-key: $YOUR_API_KEY
Постраничная навигация
Несколько конечных точек возвращают результаты с постраничной навигацией. Постраничная навигация использует подход на основе курсора, где ответ включает токен next_page, который вы передаёте обратно в следующем запросе для получения следующей страницы результатов.
Два необязательных параметра управляют постраничной навигацией:
limit (целое число): Количество записей на странице. По умолчанию 20 для конечной точки /users и 100 для всех остальных конечных точек. Максимум 1000.
page (строка): Непрозрачный токен курсора из поля next_page предыдущего ответа. Опустите это в вашем первом запросе.
Когда больше нет результатов, next_page будет null в ответе.
Ответы об ошибках
Все конечные точки возвращают стандартные коды ошибок HTTP:
Код | Значение |
400 | Параметр запроса недействителен. Распространённые причины включают недействительную дату, дату до 1/1/26 (первая доступность) или дату, которая является сегодняшней или будущей. Доступность данных задерживается на три дня. |
404 | Ключ API отсутствует, недействителен или не имеет области |
429 | Превышен лимит скорости. Слишком много запросов. |
503 | Временный сбой, пожалуйста, повторите попытку. |
Ограничение скорости
У нас есть ограничения скорости по умолчанию. Если этого недостаточно для вашего случая использования, мы хотели бы понять почему. При необходимости мы можем отрегулировать ограничения скорости для вашей организации — пожалуйста, обратитесь к своему CSM.
Конечные точки
1. Список активности пользователей
GET /v1/organizations/analytics/users
Возвращает метрики взаимодействия для каждого пользователя за один день. Каждый элемент в ответе представляет одного пользователя и включает количество его действий в Claude (чат) и Claude Code.
Параметры запроса
Поле | Тип | Обязательно | Описание |
| строка | Да | Дата для получения метрик в формате YYYY-MM-DD. |
| целое число | Нет | Количество записей на странице (по умолчанию: 20, макс: 1000). |
| строка | Нет | Токен курсора из поля |
Поля ответа (для каждого пользователя)
Поле | Описание |
| Уникальный идентификатор пользователя. |
| Адрес электронной почты пользователя. |
| Количество отдельных разговоров, в частности в Claude.ai. |
| Общее количество отправленных сообщений, в частности в Claude.ai. |
| Количество созданных проектов, в частности в Claude.ai. |
| Количество отдельных использованных проектов, в частности в Claude.ai. |
| Количество загруженных файлов, в частности в Claude.ai. |
| Количество созданных артефактов, в частности в Claude.ai. |
| Количество сообщений с расширенным мышлением, в частности в Claude.ai. |
| Количество отдельных использованных навыков, в частности в Claude.ai. |
| Общее количество вызванных коннекторов, в частности в Claude.ai. |
| Количество коммитов git, сделанных через Claude Code. |
| Количество запросов на слияние, созданных через Claude Code. |
| Общее количество добавленных строк кода. |
| Общее количество удалённых строк кода. |
| Количество отдельных сеансов Claude Code. |
| Количество принятых и отклонённых действий для инструмента Edit. |
| Количество принятых и отклонённых действий для инструмента Multi-Edit. |
| Количество принятых и отклонённых действий для инструмента Write. |
| Количество принятых и отклонённых действий для инструмента Notebook Edit. |
| Общее количество вызовов инструмента веб-поиска. Это применяется как к claude.ai, так и к использованию claude code в вашей организации. |
Пример запроса
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/users?date=2025-01-01&limit=3"
--header "x-api-key: $YOUR_API_KEY"
2. Сводка активности
GET /v1/organizations/analytics/summaries
Возвращает высокоуровневую сводку взаимодействия и использования мест в день для вашей организации за заданный диапазон дат. Ответ представляет собой список дней с агрегированными подсчётами в диапазоне дат. Обратите внимание, что максимальная разница между ending_date и starting_date должна быть 31 день, и существует трёхдневная задержка в доступности данных. Это полезно для отслеживания ежедневно активных пользователей, еженедельных и ежемесячных тенденций, а также распределения мест с первого взгляда.
Мы определяем "активного" пользователя если верно одно из следующего:
Пользователь отправил хотя бы одно сообщение в чате на Claude (чат).
Пользователь имел хотя бы один сеанс Claude Code (локальный или удалённый), связанный с организацией C4E, с использованием инструментов/активностью git
Параметры запроса
Поле | Тип | Обязательно | Описание |
| строка | Да | Начальная дата для получения данных в формате YYYY-MM-DD. Существует трёхдневная задержка в доступности данных, поэтому самые свежие данные, к которым вы можете получить доступ, относятся к трём дням назад. |
| строка | Нет | Необязательная конечная дата для получения данных в формате YYYY-MM-DD. Это исключающая дата. |
Поля ответа
Поле | Описание |
| Первый день, для которого агрегируются метрики, интерпретируется как дата UTC. Существует трёхдневная задержка в доступности данных, поэтому самые свежие данные, к которым вы можете получить доступ, относятся к трём дням назад. |
| Последний день (исключающий) для которого агрегируются метрики, интерпретируется как дата UTC |
| Количество активных пользователей в указанную дату (на основе потребления токенов). |
| Количество активных пользователей в течение 7-дневного скользящего окна, заканчивающегося в указанную дату. |
| Количество активных пользователей в течение 30-дневного скользящего окна, заканчивающегося в указанную дату. |
| Общее количество мест, в настоящее время назначенных в вашей организации. |
| Количество ожидающих приглашений, которые ещё не были приняты. |
Примечание: Скользящие окна для еженедельных и ежемесячных подсчётов смотрят назад от указанной даты (включительно). Если данные неполные для некоторых дней в окне (например, если дата менее 30 дней в прошлом), ежемесячный подсчёт может недоучитывать активность.
Пример запроса
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/summaries?starting_date=2025-01-01"
--header "x-api-key: $YOUR_API_KEY"
3. Использование проектов чата
GET /v1/organizations/analytics/apps/chat/projects
Возвращает данные об использовании, разбитые по проектам чата за заданную дату. Проекты специфичны для Claude (чат), поэтому эта конечная точка сосредоточена на этой поверхности. Каждый элемент показывает имя проекта, количество уникальных пользователей, которые с ним взаимодействовали, и общее количество разговоров, проведённых в этом проекте.
Параметры запроса
Поле | Тип | Обязательно | Описание |
| строка | Да | Дата для получения метрик в формате YYYY-MM-DD. Существует трёхдневная задержка в доступности данных, поэтому самые свежие данные, к которым вы можете получить доступ, относятся к трём дням назад. |
| целое число | Нет | Количество записей на странице (по умолчанию: 100, макс: 1000). |
| строка | Нет | Токен курсора из поля |
Поля ответа (для каждого проекта)
Поле | Описание |
| Имя проекта. |
| Помеченный идентификатор проекта, т.е. "claude_proj_{ID}" |
| Количество уникальных пользователей, которые использовали этот проект в указанную дату. |
| Количество разговоров в этом проекте в указанную дату. |
| Общее количество сообщений, отправленных в этом проекте в указанную дату. |
Пример запроса
curl -X GET "https://api.anthropic.com/v1/organizations/analytics/apps/chat/projects?date=2025-01-01&limit=50"
--header "x-api-key: $YOUR_API_KEY"
4. Использование навыков
GET /v1/organizations/analytics/skills
Возвращает данные об использовании навыков в Claude (чат) и Claude Code в вашей организации за заданную дату. Каждый элемент представляет навык и показывает, сколько уникальных пользователей его использовали.
Параметры запроса
Поле | Тип | Обязательно |