Resumen
GET /api/v1/overview — KPIs, ingresos, ROAS, visitantes
GET /api/v1/overviewDevuelve KPIs para el periodo actual y un periodo anterior calculado automaticamente de igual duracion para comparacion.
Permiso: analytics:read
Parametros
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
date_from | string | Si | Fecha de inicio (YYYY-MM-DD) |
date_to | string | Si | Fecha de fin (YYYY-MM-DD) |
model | string | No | Modelo de atribucion (predeterminado: last_touch) |
filter[dimension] | string | No | Filtrar por dimension, ej., filter[channel]=is:Paid Social |
Modelos de atribucion
last_touch · first_touch · split_50_50 · linear · position_based · time_decay · last_non_direct · custom_weighted
Solicitud
curl -H "Authorization: Bearer atb_live_YOUR_KEY" \
"https://www.atribu.app/api/v1/overview?date_from=2026-03-01&date_to=2026-03-25&model=last_touch"const response = await fetch(
"https://www.atribu.app/api/v1/overview?date_from=2026-03-01&date_to=2026-03-25&model=last_touch",
{
headers: {
Authorization: "Bearer atb_live_YOUR_KEY",
},
}
);
const data = await response.json();import requests
resp = requests.get(
"https://www.atribu.app/api/v1/overview",
headers={"Authorization": "Bearer atb_live_YOUR_KEY"},
params={
"date_from": "2026-03-01",
"date_to": "2026-03-25",
"model": "last_touch",
},
)
data = resp.json()Respuesta
{
"data": {
"current": {
"spend": 4250.00,
"revenue": 12800.00,
"roas": 3.01,
"outcomes": 145,
"attributed_outcomes": 132,
"coverage_percent": 91.03,
"visitors": 8420,
"pageviews": 24100,
"bounce_rate": 42.5,
"avg_engaged_seconds": 185,
"cash_revenue": 12800.00,
"cash_payments": 48
},
"previous": {
"spend": 3900.00,
"revenue": 10200.00,
"roas": 2.62,
"outcomes": 128,
"attributed_outcomes": 115,
"coverage_percent": 89.84,
"visitors": 7200,
"pageviews": 20500,
"bounce_rate": 45.2,
"avg_engaged_seconds": 165,
"cash_revenue": 10200.00,
"cash_payments": 38
}
},
"meta": {
"date_from": "2026-03-01",
"date_to": "2026-03-25",
"profile_id": "uuid"
}
}Campos de respuesta
| Campo | Tipo | Descripcion |
|---|---|---|
spend | number | Gasto total en anuncios en la moneda de reporte |
revenue | number | Ingresos en efectivo atribuidos (numerador del ROAS) |
roas | number | Retorno sobre el gasto en anuncios (revenue / spend) |
outcomes | number | Conversiones totales |
attributed_outcomes | number | Conversiones con al menos un punto de contacto atribuido |
coverage_percent | number | Cobertura de atribucion (atribuidos / total x 100) |
visitors | number | Visitantes unicos (anonymous_id distintos) |
pageviews | number | Vistas de pagina totales |
bounce_rate | number | Porcentaje de sesiones de una sola pagina |
avg_engaged_seconds | number | Tiempo promedio de engagement por sesion |
cash_revenue | number | Pagos totales en efectivo (Stripe + MercadoPago) |
cash_payments | number | Cantidad de eventos de pago en efectivo |
Periodo anterior
El periodo anterior se calcula automaticamente para tener la misma duracion que el periodo actual, terminando el dia antes de date_from. Por ejemplo, si consultas del 1 al 25 de marzo (25 dias), el periodo anterior sera del 4 al 28 de febrero.