# GET /v1/stats/subid

Получить статистику по subid

Показы, доход и eCPM с группировкой по sub1, sub2 и sub3 не более чем за 90 дней; JSON или CSV. Доход по subid — распределение дохода, сообщаемого /v1/stats для каждой зоны и страны, пропорционально показам, а не отдельное измерение (`revenue_allocated` всегда true); итоги равны итогам /v1/stats для того же диапазона и фильтров. Строки отсортированы по доходу; строки сверх `limit` объединяются в одну, у которой subid равен `~other`. Null в subid означает, что 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/ru/developers/api/#get-subid-stats
API 2026-10
