> ## 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

> 面向 Enterprise 的 Windsurf 使用数据查询 Analytics API，包括 Autocomplete、Chat、Command 和 Cascade 等相关指标。

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