Analytics API предоставляет основным владельцам Enterprise плана программный доступ к данным об активности, внедрении, использовании и затратах организации. Используйте его для создания внутренних панелей управления, отслеживания тенденций внедрения, сверки расходов с ежемесячным счетом и интеграции данных Claude в существующие инструменты отчетности.
Analytics API доступен в Enterprise планах. Основные владельцы могут генерировать ключи API для начала работы.
Чем это отличается от панели аналитики и Compliance API?
Все три варианта предоставляют разные представления данных вашей организации:
Панель аналитики (доступна через 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.
Решения партнеров
Ведущие платформы наблюдаемости предлагают готовые интеграции для мониторинга использования и затрат Claude API без написания пользовательского кода. Эти интеграции предоставляют панели управления, оповещения и аналитику для эффективного управления использованием 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 дней в прошлом.
Примечание: Конечные точки затрат и использования Analytics API включают как цену со скидкой, так и прейскурантную цену.
Ограничения данных
Конечные точки активности и внедрения возвращают данные за одну дату или диапазон дат. Данные доступны только после 1 января 2026 г. и для дат более трех дней назад.
Конечные точки использования и затрат позволяют запрашивать окно до 31 дня, возвращаясь на 365 дней от сегодня. Для итогов, пригодных для выставления счетов, запрашивайте даты как минимум за 30 дней в прошлом, чтобы поздние события имели время для согласования.
API имеет ограничение частоты по умолчанию 60 запросов в минуту. Если это не соответствует потребностям вашей организации, обратитесь к вашему контакту Anthropic или нашей команде продаж.
Важно: Если вы используете Claude Code через Amazon Bedrock, Analytics API не будет возвращать данные, связанные с Claude Code.