API аналитики предоставляет основным владельцам плана Enterprise программный доступ к данным об активности, внедрении, использовании и затратах организации. Используйте его для создания внутренних панелей управления, отслеживания тенденций внедрения, сверки расходов с ежемесячным счетом и передачи данных Claude в существующие инструменты отчетности.
API аналитики доступен в планах Enterprise. Основные владельцы могут генерировать ключи API для начала работы.
Чем это отличается от панели аналитики и API соответствия?
Все три варианта предоставляют различные представления данных вашей организации:
Панель аналитики (доступна по адресу Analytics) отображает визуализированные данные об использовании в продукте. Это правильный инструмент для ежедневного мониторинга, когда вам не нужно интегрировать данные в другие места.
API аналитики возвращает те же агрегированные метрики, но программным способом — так что вы можете загружать их в инструменты BI, сопоставлять с организационными диаграммами, автоматизировать рабочие процессы отчетности и сверять данные о затратах с внутренними записями. Данные об активности и внедрении агрегируются по организации в день. Данные об использовании и затратах доступны с более детальными разбивками по пользователям и временным интервалам.
API соответствия предназначен для случаев использования управления и аудита. Он предоставляет доступ к отдельным действиям пользователей, необработанным событиям активности и содержимому беседы. Если вам нужны агрегированные метрики активности для панелей управления, а не необработанные события для аудита, используйте API аналитики.
Начало работы
Для доступа к API аналитики вам необходимо иметь доступ основного владельца к вашей организации Enterprise.
Выполните следующие действия:
Перейдите в раздел Analytics > API keys.
Найдите переключатель Access в разделе Analytics API и включите его.
Нажмите "+ Create key" для создания нового ключа API. Держите этот ключ в секрете — обращайтесь с ним как с паролем.
Используйте ключ с заголовком
x-api-keyв ваших запросах.
Для получения полной информации об аутентификации, справочной информации по конечным точкам и примеров кода обратитесь к нашему руководству по справочнику API аналитики Claude Enterprise.
Какие данные доступны?
API аналитики включает девять конечных точек в двух категориях.
Активность и внедрение
Эти конечные точки возвращают агрегированные метрики активности по организации в день. Данные доступны за последние 90 дней (не ранее 1 января 2026 г.).
Активность пользователя: Метрики активности пользователя по всем поверхностям Claude. Включает количество разговоров, отправленные сообщения, созданные проекты, загруженные файлы, созданные артефакты, использованные навыки, использованные соединители, метрики Claude Code, такие как коммиты, запросы на извлечение и строки кода, а также метрики Cowork, такие как начатые сеансы, действия инструментов, ходы отправки и вызовы навыков и соединителей.
Сводка активности: Ежедневное, еженедельное и ежемесячное количество активных пользователей организации в Claude, Claude Code и Cowork, а также использование мест и количество ожидающих приглашений. Поддерживает диапазоны дат до 31 дня за запрос.
Использование проекта чата: Количество разговоров и пользователей, разбитое по проектам для проектов Claude.
Использование навыков: Сколько пользователей используют каждый навык, с разбивкой для сеансов Claude, Claude Code и Cowork отдельно.
Использование соединителей: Какие соединители использует ваша организация и сколько уникальных пользователей использовали каждый из них, с разбивкой для сеансов Claude, Claude Code и Cowork отдельно.
Использование и затраты
Примечание: Конечные точки затрат и использования применяются к планам Enterprise на основе использования. Для планов Enterprise на основе мест эти конечные точки будут отражать только кредиты использования.
Эти конечные точки (доступны сейчас в бета-версии) возвращают данные об использовании токенов и стоимости в USD по всем поверхностям Claude. Используйте их для отслеживания использования между ежемесячными счетами, сверки выставления счетов Anthropic с внутренними центрами затрат и информирования об ограничениях расходов на основе фактического поведения пользователей.
Использование токенов на пользователя: Пользователи, ранжированные по использованию токенов в диапазоне дат, с дополнительными разбивками по продукту, модели, размеру контекста, области вывода или скорости.
Стоимость на пользователя: Пользователи, ранжированные по расходам в USD в диапазоне дат, с дополнительными разбивками по продукту, модели, типу затрат (токены, веб-поиск, выполнение кода) или типу токена.
Использование токенов во времени: Использование токенов, разбитое по минутам, часам или дням, дополнительно разбитое по продукту, модели, размеру контекста, области вывода или скорости.
Стоимость во времени: Стоимость в USD, разбитая по минутам, часам или дням, с теми же параметрами группировки плюс тип затрат и тип токена.
Данные обновляются каждые четыре часа и могут занять до 24 часов. Значения могут быть пересмотрены в течение 30 дней по мере согласования поздних событий, поэтому для итогов, пригодных для выставления счетов, запрашивайте даты как минимум на 30 дней в прошлом.
Ограничения данных
Конечные точки активности и внедрения возвращают данные за одну дату или диапазон дат. Данные доступны только после 1 января 2026 г. и для дат более трех дней назад.
Конечные точки использования и затрат позволяют запрашивать окно до 31 дня, возвращаясь на 365 дней от сегодняшнего дня. Для итогов, пригодных для выставления счетов, запрашивайте даты как минимум на 30 дней в прошлом, чтобы у поздних событий было время на согласование.
API имеет ограничение скорости по умолчанию 60 запросов в минуту. Если это не соответствует потребностям вашей организации, обратитесь к своему контакту Anthropic или нашей команде продаж.
Важно: Если вы используете Claude Code через Amazon Bedrock, API аналитики не будет возвращать данные, связанные с Claude Code.