Analítica de envíos masivos
Cómo fueron los envíos masivos enviados en un periodo que termina ahora, sumados y contados por día, hora o minuto, con una fila por envío para compararlos: la pestaña Analítica de la página de envíos masivos.
Ejecuta la llamada real en tu espacio de trabajo.
GET /broadcasts/analytics
Cómo fueron los envíos masivos enviados en un periodo que termina ahora, sumados y contados por día, hora o minuto, con una fila por envío para compararlos: la pestaña Analítica de la página de envíos masivos.
Ejemplo
Necesita emails:read. Omite broadcastIds para todos los envíos masivos, o indica hasta 50 separados por comas. El periodo es days (de 1 a 1095) o minutes (de 1 a 1576800, que manda si se envían ambos), 30 días por defecto. grain es day, hour o minute, day por defecto, y offsetMinutes (de -840 a 840) es el desfase de quien mira respecto a UTC.
curl "$OE/broadcasts/analytics?days=30" -H "$AUTH"{ "object": "broadcast_analytics", "since": "2026-08-25T00:00:00.000Z", "until": "2026-09-23T12:00:00.000Z", "grain": "day", "offsetMinutes": 0, "broadcastIds": [], "totals": { "broadcasts": 2, "recipients": 530, "pending": 0, "sent": 527, "delivered": 519, "bounced": 6, "complained": 1, "failed": 3, "opened": 241, "clicked": 66, "unsubscribed": 4, "opens": 377, "clicks": 90 }, "series": [ { "bucket": "2026-09-09", "sent": 117, "delivered": 115, "opened": 54, "clicked": 14, "unsubscribed": 1 }, { "bucket": "2026-09-23", "sent": 410, "delivered": 404, "opened": 187, "clicked": 52, "unsubscribed": 3 } ], "broadcasts": [ { "id": "brd_5a8c1e3f7b2d94a06c8e1f3b", "subject": "The September release is out", "status": "sent", "sentAt": "2026-09-23T12:00:00.000Z", "recipients": 412, "sent": 410, "delivered": 404, "opened": 187, "clicked": 52, "unsubscribed": 3 }, { "id": "brd_2e7d9b4c1a8f60e35d2c7b91", "subject": "What changed in August", "status": "sent", "sentAt": "2026-09-09T09:30:00.000Z", "recipients": 118, "sent": 117, "delivered": 115, "opened": 54, "clicked": 14, "unsubscribed": 1 } ]}Una copia cuenta si se envió dentro del periodo, y todo lo que le pasó después cuenta con ella. Los envíos masivos en modo de prueba quedan fuera.
totals y series suman los envíos masivos de broadcastIds, o todos si está vacío. broadcasts lista siempre todos los envíos masivos del periodo, del más reciente al más antiguo, con los mismos recuentos que totals, aquí abreviados, para que puedas compararlos o elegir ids.
opened, clicked y unsubscribed cuentan personas, mientras que opens y clicks cuentan eventos. series es dispersa, de la más antigua a la más reciente, y cuenta a cada persona una vez, la primera vez que le ocurrió.
Más de 50 ids es un 422 invalid_parameter, y un id sin copias en el periodo no suma nada. Una clave limitada a ciertas direcciones o dominios solo lee los envíos masivos enviados desde una dirección o dominio que tiene.
