跳转到主要内容

使用 Analytics API 访问参与度和采用数据

更新于今天

Analytics API 为企业计划的主要所有者提供对其组织的参与度和采用数据的编程访问权限。使用它来构建内部仪表板、跟踪采用趋势,以及将 Claude 参与度数据导入您现有的报告工具。

Analytics API 在企业计划中可用。主要所有者可以生成 API 密钥来开始使用。

这与分析仪表板和合规 API 有什么不同?

这三个选项为您提供了对组织数据的不同视图:

分析仪表板(通过 Analytics 访问)在产品中显示可视化的使用数据。当您不需要将数据集成到其他地方时,这是日常监控的合适工具。

Analytics API 以编程方式返回相同的聚合使用和参与度指标,因此您可以将它们拉入 BI 工具、将其映射到组织结构图,或自动化报告工作流。数据按组织、按天聚合。

合规 API 用于治理和审计用例。它为您提供对单个用户操作、原始活动事件和对话内容的访问权限。如果您需要用于仪表板的聚合参与度指标,而不是用于审计的原始事件,请使用 Analytics API。


开始使用

要访问 Analytics API,您需要对企业组织拥有主要所有者访问权限。

按照以下步骤操作:

  1. Analytics API 下找到 Access 切换开关并将其打开。

  2. 点击"+ Create key"生成新的 API 密钥。保持此密钥私密——将其视为密码。

  3. 在您的请求中使用带有 x-api-key 标头的密钥。

有关完整的身份验证详情、端点参考和代码示例,请参阅我们的 Claude Enterprise Analytics API 参考指南


有哪些数据可用?

Analytics API 包括五个端点。所有数据按组织、按天聚合,可用于过去 90 天内的数据(不早于 2026 年 1 月 1 日)。

  • 用户活动:每个用户的参与度指标,包括对话计数、发送的消息、创建的项目、上传的文件、创建的工件、使用的技能、使用的连接器,以及 Claude Code 指标,如提交、拉取请求和代码行数。

  • 活动摘要:组织范围内的每日、每周和每月活跃用户计数,以及座位利用率和待处理邀请计数。支持每个请求最多 31 天的日期范围。

  • 聊天项目使用情况:按项目分解的对话和用户计数,适用于 Claude 项目。

  • 技能使用情况:有多少用户在使用每项技能,并分别针对 Claude 和 Claude Code 会话进行细分。

  • 连接器使用情况:您的组织正在使用哪些连接器,以及有多少唯一用户使用过每个连接器。


数据限制

所有端点都返回单个日期或日期范围的数据。数据仅在 2026 年 1 月 1 日之后以及三天前的日期之后可用。

API 的默认速率限制为每分钟 60 个请求。如果这不符合您组织的需求,请联系您的 Anthropic 联系人或我们的 销售团队

这是否解答了您的问题?