# GET /v1/stats/subid

Obtener estadísticas por subid

Pops, ingresos y eCPM agrupados por sub1, sub2 y sub3, para un máximo de 90 días; JSON o CSV. Los ingresos por subid son una asignación, en proporción a los pops, de los ingresos informados por /v1/stats para cada zona y país, no una medición independiente (`revenue_allocated` es siempre true); los totales coinciden con los de /v1/stats para el mismo rango y los mismos filtros. Las filas se ordenan por ingresos; las filas que superan `limit` se fusionan en una sola fila cuyo subid es `~other`. Un subid null significa que no se envió ningún subid. Requiere el scope publisher:read (clave de API o sesión web). Nivel de límite de uso: stats.

- Scope requerido: `publisher:read`
- Límite de uso: `stats` — 30 solicitudes por ventana de 60 s por clave de API o sesión web

## Parámetros

| Nombre | En | Tipo | Requerido |
|---|---|---|---|
| `from` | query | string | sí |
| `to` | query | string | sí |
| `group_by` | query | ("sub1" \| "sub2" \| "sub3")[] | no |
| `site_id` | query | integer | no |
| `zone_id` | query | integer | no |
| `sub1` | query | string | no |
| `sub2` | query | string | no |
| `sub3` | query | string | no |
| `limit` | query | integer | no |
| `format` | query | "json" \| "csv" | no |

## Respuesta

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

## Errores

Las rutas con límite de uso devuelven `RateLimit-Limit`, `RateLimit-Remaining` y `RateLimit-Reset` (segundos hasta que termina la ventana); un 429 incluye además `Retry-After`. Los encabezados pueden faltar mientras el limitador no esté disponible temporalmente (en ese caso las solicitudes se dejan pasar).

| Estado | Significado |
|---|---|
| 401 | Clave de API ausente, no válida o revocada. |
| 403 | La clave no tiene el scope requerido, o la operación no está permitida para este actor. |
| 429 | Límite de uso superado; espera los segundos indicados en `Retry-After`. |
| 400 | Default Response |
| 404 | Default Response |
| 503 | Default Response |

Documentación HTML: https://agimone.com/es/developers/api/#get-subid-stats
API 2026-10
