# GET /v1/stats/subid

Obtenir les statistiques par subid

Pops, revenus et eCPM regroupés par sub1, sub2 et sub3, sur 90 jours maximum ; JSON ou CSV. Le revenu par subid est une allocation du revenu rapporté par /v1/stats pour chaque zone et chaque pays au prorata des pops, et non une mesure distincte (`revenue_allocated` vaut toujours true) ; les totaux sont égaux à ceux de /v1/stats pour la même période et les mêmes filtres. Les lignes sont triées par revenu ; les lignes au-delà de `limit` sont fusionnées en une seule ligne dont le subid est `~other`. Un subid null signifie qu'aucun subid n'a été envoyé. Nécessite la portée publisher:read (clé API ou session web). Niveau de limite de débit : stats.

- Portée requise: `publisher:read`
- Limite débit: `stats` — 30 requêtes par fenêtre de 60 s par clé API ou session web

## Paramètres

| Nom | Dans | Type | Requis |
|---|---|---|---|
| `from` | query | string | oui |
| `to` | query | string | oui |
| `group_by` | query | ("sub1" \| "sub2" \| "sub3")[] | non |
| `site_id` | query | integer | non |
| `zone_id` | query | integer | non |
| `sub1` | query | string | non |
| `sub2` | query | string | non |
| `sub3` | query | string | non |
| `limit` | query | integer | non |
| `format` | query | "json" \| "csv" | non |

## Réponse

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

## Erreurs

Les routes soumises à une limite de débit renvoient `RateLimit-Limit`, `RateLimit-Remaining` et `RateLimit-Reset` (secondes avant la fin de la fenêtre) ; une réponse 429 contient aussi `Retry-After`. Ces en-têtes peuvent être absents lorsque le limiteur est temporairement indisponible (les requêtes sont alors acceptées).

| Statut | Sens |
|---|---|
| 401 | Clé API absente, invalide ou révoquée. |
| 403 | La clé n'a pas la portée requise, ou l'opération n'est pas autorisée pour cet acteur. |
| 429 | Limite de débit dépassée ; attendez `Retry-After` secondes. |
| 400 | Default Response |
| 404 | Default Response |
| 503 | Default Response |

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