# GET /v1/stats/subid

按subid获取统计

按sub1、sub2和sub3分组的弹出数、收益和eCPM，最长90天；支持JSON或CSV。各subid的收益是按弹出数比例，对/v1/stats中每个广告位和国家所报告收益的分摊，并非单独测量（`revenue_allocated`始终为true）；合计与相同范围和筛选条件下/v1/stats的合计一致。各行按收益排序；超出`limit`的行合并为一行，其subid为`~other`。subid为null表示未发送subid。需要权限范围publisher:read（API密钥或网页会话）。速率限制等级：stats。

- 所需权限范围: `publisher:read`
- 速率限制: `stats` — 30 次请求/60秒窗口 每个API密钥或网页会话

## 参数

| 名称 | 位置 | 类型 | 必填 |
|---|---|---|---|
| `from` | query | string | 是 |
| `to` | query | string | 是 |
| `group_by` | query | ("sub1" \| "sub2" \| "sub3")[] | 否 |
| `site_id` | query | integer | 否 |
| `zone_id` | query | integer | 否 |
| `sub1` | query | string | 否 |
| `sub2` | query | string | 否 |
| `sub3` | query | string | 否 |
| `limit` | query | integer | 否 |
| `format` | query | "json" \| "csv" | 否 |

## 响应

```
{ count_basis?: "valid" | "legacy" | "mixed"; currency: "USD"; estimated_from: string | null; forecast_basis_version?: "forecast-basis-v1"; forecast_generation?: string; forecast_updated_at?: string | null; measurement_definition?: { complete: boolean; includes_direct: boolean; includes_legacy: boolean; tag_valid_after_ms: integer[] }; measurement_generation?: string; measurement_status?: "ok" | "stale" | "updating"; measurement_updated_at?: string | null; money_basis_version?: string; money_generation?: string; revenue_allocated: true; rows: { ecpm: string | null; pops: integer; revenue: string; status?: "estimated" | "reported" | "final" | "mixed"; sub1?: string | null; sub2?: string | null; sub3?: string | null }[]; totals: { ecpm: string | null; pops: integer; revenue: string; status?: "estimated" | "reported" | "final" | "mixed" }; truncated?: boolean; updated_at?: string | null }
```

## 错误

有速率限制的路由会返回`RateLimit-Limit`、`RateLimit-Remaining`和`RateLimit-Reset`（距窗口结束的秒数）；429响应还会带有`Retry-After`。限流器暂时不可用时，这些响应头可能缺失（此时请求会被放行）。

| 状态码 | 含义 |
|---|---|
| 401 | API密钥缺失、无效或已被撤销。 |
| 403 | 该密钥缺少所需的权限范围，或该主体无权执行此操作。 |
| 429 | 已超出速率限制；请等待`Retry-After`秒后重试。 |
| 400 | Default Response |
| 404 | Default Response |
| 503 | Default Response |

HTML文档: https://agimone.com/zh/developers/api/#get-subid-stats
API 2026-10
