Zur Dokumentation springen
API

Broadcast-Analysen

Wie die Broadcasts abgeschnitten haben, die in einem Zeitraum bis jetzt gesendet wurden, zusammengezählt und nach Tag, Stunde oder Minute gezählt, mit einer Zeile pro Broadcast zum Vergleichen: der Tab „Analysen“ der Broadcasts-Seite.

GET/broadcasts/analytics

Führt den echten Aufruf in Ihrem Workspace aus.

GET /broadcasts/analytics

Wie die Broadcasts abgeschnitten haben, die in einem Zeitraum bis jetzt gesendet wurden, zusammengezählt und nach Tag, Stunde oder Minute gezählt, mit einer Zeile pro Broadcast zum Vergleichen: der Tab „Analysen“ der Broadcasts-Seite.

Beispiel

Erfordert emails:read. Lassen Sie broadcastIds für alle Broadcasts weg oder nennen Sie bis zu 50, durch Kommas getrennt. Der Zeitraum ist days (1 bis 1095) oder minutes (1 bis 1576800, hat Vorrang, wenn beide gesendet werden), standardmäßig 30 Tage. grain ist day, hour oder minute, standardmäßig day, und offsetMinutes (-840 bis 840) ist der Abstand des Betrachters zu UTC.

curl
curl "$OE/broadcasts/analytics?days=30" -H "$AUTH"
Antwort
{  "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    }  ]}

Eine Kopie zählt, wenn sie innerhalb des Zeitraums gesendet wurde, und alles, was ihr danach passiert ist, zählt mit. Broadcasts im Testmodus bleiben außen vor.

totals und series zählen die Broadcasts in broadcastIds zusammen, oder alle, wenn es leer ist. broadcasts listet immer jeden Broadcast im Zeitraum auf, den neuesten zuerst, mit denselben Zählern wie totals, hier gekürzt, damit Sie sie vergleichen oder IDs auswählen können.

opened, clicked und unsubscribed zählen Personen, während opens und clicks Ereignisse zählen. series ist lückenhaft, die ältesten zuerst, und zählt jede Person einmal, beim ersten Mal, als es ihr passiert ist.

Mehr als 50 IDs ergeben 422 invalid_parameter, und eine ID ohne Kopie im Zeitraum fügt nichts hinzu. Ein Schlüssel, der auf bestimmte Adressen oder Domains beschränkt ist, liest nur die Broadcasts, die von einer Adresse oder Domain gesendet wurden, die er hält.

Der Posteingang,
nach eigenen Regeln.

E-Mail-Infrastruktur für Unternehmen, KI, Agenten und persönliche E-Mail. Gebaut für Skalierung, Privatsphäre und Kontrolle. Alles, was E-Mail vom ersten Tag an hätte haben sollen.

© 2026 OpenEmail. Alle Rechte vorbehalten.