> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics API

> 用于查询 Windsurf 使用数据（包括 Autocomplete、Chat、Command 和 Cascade 等指标）的 Enterprise 版 Analytics API

<div id="overview">
  ## 概览
</div>

Windsurf Analytics API 使 Enterprise 客户能够以编程方式访问其团队的详细使用分析数据。通过灵活的筛选、分组和聚合选项，可查询来自 Autocomplete、Chat、Command 功能及 Cascade 的数据。

<Info>API 数据每 3 小时更新一次</Info>

<div id="common-parameters">
  ## 通用参数
</div>

大多数 Analytics API 端点支持以下通用参数：

| 参数                | 类型     | 是否必填  | 说明                                           |
| ----------------- | ------ | ----- | -------------------------------------------- |
| `service_key`     | string | 是     | 用于身份验证的服务密钥                                  |
| `group_name`      | string | 否     | 将结果限定为指定的群组                                  |
| `start_timestamp` | string | 视情况而定 | RFC 3339 格式的开始时间 (例如：`2023-01-01T00:00:00Z`) |
| `end_timestamp`   | string | 视情况而定 | RFC 3339 格式的结束时间 (例如：`2023-12-31T23:59:59Z`) |

<div id="available-endpoints">
  ## 可用端点
</div>

Analytics API 提供三个主要端点：

1. **[User Page Analytics](/zh/windsurf/accounts/api-reference/user-page-analytics)** - 从 Teams 页面获取用户活动数据
2. **[Cascade Analytics](/zh/windsurf/accounts/api-reference/cascade-analytics)** - 查询 Cascade 相关的使用指标
3. **[Custom Analytics](/zh/windsurf/accounts/api-reference/custom-analytics)** - 使用自定义 selections、过滤条件和 aggregations 进行灵活查询