Analytics API предоставляет основным владельцам Enterprise плана программный доступ к данным об активности, внедрении, использовании и затратах организации. Используйте его для создания внутренних панелей управления, отслеживания тенденций внедрения, сверки расходов с ежемесячным счетом и интеграции данных Claude в существующие инструменты отчетности.
Analytics API доступен в Enterprise планах. Основные владельцы могут генерировать ключи API для начала работы.
Чем это отличается от панели аналитики и Compliance API?
Все три варианта предоставляют различные представления данных вашей организации:
Панель Analytics (доступна по адресу Analytics) отображает визуализированные данные об использовании в продукте. Это правильный инструмент для ежедневного мониторинга, когда вам не нужно интегрировать данные в другие места.
Analytics API возвращает те же агрегированные метрики, но программным способом — так что вы можете загружать их в инструменты BI, сопоставлять с организационными диаграммами, автоматизировать рабочие процессы отчетности и сверять данные о затратах с внутренними записями. Данные об активности и внедрении агрегируются по организации, в день. Данные об использовании и затратах доступны с более детальными разбивками по пользователям и временным интервалам.
Compliance API предназначен для случаев использования управления и аудита. Он предоставляет доступ к отдельным действиям пользователей, необработанным событиям активности и содержимому беседы. Если вам нужны агрегированные метрики активности для панелей управления, а не необработанные события для аудита, используйте Analytics API.
Начните работу
Для доступа к Analytics API вам требуется доступ основного владельца к вашей Enterprise организации.
Выполните следующие действия:
Перейдите в Analytics > API keys.
Найдите переключатель Access в разделе Analytics API и включите его.
Нажмите "+ Create key" для создания нового ключа API. Держите этот ключ в секрете — обращайтесь с ним как с паролем.
Используйте ключ с заголовком
x-api-keyв ваших запросах.
Для получения полной информации об аутентификации, справочной информации по конечным точкам и примеров кода обратитесь к нашему руководству по справочнику Claude Enterprise Analytics API.
Какие данные доступны?
Analytics 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, Analytics API не будет возвращать данные, связанные с Claude Code.