# GET /v1/stats/subid

Lihat statistik menurut subid

Pop, pendapatan, dan eCPM dikelompokkan menurut sub1, sub2, dan sub3, maksimal 90 hari; JSON atau CSV. Pendapatan per subid adalah alokasi dari pendapatan yang dilaporkan /v1/stats untuk setiap zona dan negara sebanding dengan pop, bukan pengukuran terpisah (`revenue_allocated` selalu true); totalnya sama dengan total /v1/stats untuk rentang dan filter yang sama. Baris diurutkan menurut pendapatan; baris di luar `limit` digabung menjadi satu baris dengan subid `~other`. Subid null berarti tidak ada subid yang dikirim. Memerlukan scope publisher:read (kunci API atau sesi web). Tingkat batas laju: stats.

- Scope wajib: `publisher:read`
- Batas laju: `stats` — 30 permintaan per jendela 60 detik per kunci API atau sesi web

## Parameter

| Nama | Di | Tipe | Wajib |
|---|---|---|---|
| `from` | query | string | ya |
| `to` | query | string | ya |
| `group_by` | query | ("sub1" \| "sub2" \| "sub3")[] | tidak |
| `site_id` | query | integer | tidak |
| `zone_id` | query | integer | tidak |
| `sub1` | query | string | tidak |
| `sub2` | query | string | tidak |
| `sub3` | query | string | tidak |
| `limit` | query | integer | tidak |
| `format` | query | "json" \| "csv" | tidak |

## Respons

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

## Error

Rute yang dibatasi lajunya mengembalikan `RateLimit-Limit`, `RateLimit-Remaining`, dan `RateLimit-Reset` (detik hingga jendela berakhir); respons 429 juga menyertakan `Retry-After`. Header ini bisa tidak ada saat pembatas laju sementara tidak tersedia (permintaan lalu diteruskan).

| Status | Arti |
|---|---|
| 401 | Kunci API tidak ada, tidak valid, atau sudah dicabut. |
| 403 | Kunci tidak memiliki scope yang diperlukan, atau operasi tidak diizinkan untuk aktor ini. |
| 429 | Batas laju terlampaui; tunggu `Retry-After` detik. |
| 400 | Default Response |
| 404 | Default Response |
| 503 | Default Response |

Dokumentasi HTML: https://agimone.com/id/developers/api/#get-subid-stats
API 2026-10
