Guía de estadísticas de engagement
El endpoint de estadísticas de engagement devuelve métricas diarias o mensuales precalculadas para dashboards y reporting sin ejecutar agregaciones pesadas en tiempo real. Estos valores salen de la misma fuente materializada de engagement que usa UGC.
Endpoint
| Método | Ruta | Uso |
|---|---|---|
GET | /api/2026-04/stats/engagement | Obtener métricas de emails, clicks y reviews. |
Petición
bash
curl "https://api.revi.io/api/2026-04/stats/engagement?from_date=2026-05-01&to_date=2026-05-31&granularity=day" \
-H "Accept: application/json" \
-H "X-API-KEY: revi_test_xxxxxxxxx"Filtros soportados:
| Filtro | Descripción |
|---|---|
from_date | Fecha inicial en formato YYYY-MM-DD. Por defecto son 29 días antes de to_date. |
to_date | Fecha final en formato YYYY-MM-DD. Por defecto es hoy. |
id_store | ID de tienda, o una lista de IDs numéricos separados por coma. Las API keys limitadas a tienda se restringen automáticamente a su tienda. |
granularity | day o month. Por defecto es day. |
Métricas
| Métrica | Fuente |
|---|---|
emails_sent | Conteo de filas en businesses_invitations. |
emails_opened | Suma del flag mantenido open. |
clicks | Visitas a la página de opinión desde enlaces de invitación. Nombre público de la métrica interna review_page_visits, basada en el flag mantenido viewpage. |
reviews_generated | Conteo de reviews por date_review. |
La respuesta incluye un objeto summary para todo el rango y un array series para cada periodo. Los rangos sin datos devuelven periodos con ceros.