Analytics API

读取团队及用户维度指标，控制日期窗口、分页、认证和缓存。

This page has not been translated into English yet. The original Chinese version is shown below.

Analytics API 仅 Enterprise，采用 Basic auth。多数端点要求 admin:；Bugbot review analytics 接受 read:。不要因普通 dashboard 在 Teams 可用就假定其 API 也可用。

聚合与用户维度

团队入口位于 /analytics/team/，如 agent-edits、tabs、dau、models；对应用户维度位于 /analytics/by-user/，例如 agent-edits、tabs、models。还有 client versions、file extensions、MCP、commands、plans、skills、Ask mode 等指标，具体 route 使用来源列出的名称。

curl -u YOUR_API_KEY: \
  'https://api.cursor.com/analytics/team/agent-edits?startDate=7d&endDate=today'

team 返回整体聚合或 users 子集；by-user 按用户组织数据并分页。page 默认 1，pageSize 默认 100、最大 500。users 可混合逗号分隔邮箱和 user_… ID，过滤后分页人数也只含这些用户。

日期与缓存

startDate/endDate 默认最近 7 天到今天；接受 YYYY-MM-DD、ISO 8601，以及 now/today/yesterday/Nd。全部按 UTC 日解析，时分秒被忽略；使用简单日期可避免相同数据因不同时间字符串导致 cache miss。

单次最多 30 天。官方 best practices 另写 1–3 months，但与硬限制冲突，按 30 天分段。Team endpoint 每团队每分钟 100 次，by-user 为 50 次，超限返回 429。

两类接口支持 ETag，可用 If-None-Match 减少传输。泛用示例可能省略认证，实际请求仍需 key。

指标解释

Tab suggestions/accepts 是次数；行指标应使用明确的 lines 字段。Leaderboard users 筛选保留实际全团队排名，不把筛出用户重新从第一名编号。

Bugbot PR 统计 /analytics/team/bugbot 默认 prState=merged，也可 all；分页默认 100、最大 250。逐 review 成本和 findings 用 /analytics/team/bugbot-reviews，包括 dry-run；cost_cents 可能 null，不强转为零。具体审查触发与响应见Bugbot API。