# GET /v1/stats/subid

Lấy thống kê theo subid

Số lượt hiển thị, doanh thu và eCPM của nhà xuất bản, nhóm theo sub1, sub2 và sub3, tối đa 90 ngày; trả JSON hoặc CSV. Doanh thu theo subid là phần phân bổ từ doanh thu `/v1/stats` của từng vùng quảng cáo và quốc gia theo tỉ lệ số lượt hiển thị, không phải số đo riêng (`revenue_allocated` luôn là `true`); tổng của phản hồi bằng tổng `/v1/stats` cùng khoảng ngày và bộ lọc. Các dòng sắp theo doanh thu; phần vượt `limit` được gộp vào một dòng có subid là `~other`. Subid `null` nghĩa là lượt không mang subid. Mỗi dòng có `status` (`estimated` = ước tính, `reported` = đã báo cáo, `final` = đã chốt, `mixed` = kết hợp nhiều trạng thái). Cần quyền `publisher:read` (khoá API hoặc phiên web). Tầng giới hạn tốc độ: `stats`.

- Quyền cần có: `publisher:read`
- Giới hạn tốc độ: `stats` — 30 yêu cầu mỗi cửa sổ 60 giây cho mỗi API key hoặc phiên web

## Tham số

| Tên | Vị trí | Kiểu | Bắt buộc |
|---|---|---|---|
| `from` | query | string | có |
| `to` | query | string | có |
| `group_by` | query | ("sub1" \| "sub2" \| "sub3")[] | không |
| `site_id` | query | integer | không |
| `zone_id` | query | integer | không |
| `sub1` | query | string | không |
| `sub2` | query | string | không |
| `sub3` | query | string | không |
| `limit` | query | integer | không |
| `format` | query | "json" \| "csv" | không |

## Phản hồi

```
{ 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 }
```

## Lỗi

Các route có giới hạn tốc độ trả `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (số giây tới hết cửa sổ); phản hồi 429 có thêm `Retry-After`. Header có thể vắng khi bộ giới hạn tạm thời không sẵn sàng (khi đó yêu cầu vẫn được cho qua).

| Mã | Ý nghĩa |
|---|---|
| 401 | Thiếu, sai hoặc đã thu hồi API key. |
| 403 | Key thiếu quyền cần có, hoặc thao tác không được phép với tác nhân này. |
| 429 | Vượt giới hạn tốc độ; chờ `Retry-After` giây. |
| 400 | Default Response |
| 404 | Default Response |
| 503 | Default Response |

Tài liệu HTML: https://agimone.com/vi/developers/api/#get-subid-stats
API 2026-10
