API

브로드캐스트 통계

브로드캐스트의 성과입니다. 발송, 전달, 반송, 스팸 신고, 실패한 사본 수와 열람, 클릭, 수신 거부한 사람 수를 합계와 `grain` 단위로 나눈 시계열로 보여 줍니다.

GETapi.openemail.uk/broadcasts/{id}/stats

본인 키로 워크스페이스에 실제 호출을 실행합니다.

GET /broadcasts/{id}/stats

브로드캐스트의 성과입니다. 발송, 전달, 반송, 스팸 신고, 실패한 사본 수와 열람, 클릭, 수신 거부한 사람 수를 합계와 grain 단위로 나눈 시계열로 보여 줍니다.

매개변수

idstring필수: 경로에 넣습니다. `POST /broadcasts` 또는 `GET /broadcasts`에서 받은 `brd_` ID입니다.
grainstring: 시계열의 버킷 폭: `minute`, `hour` 또는 `day`. 기본값은 `hour`입니다.
offsetMinutesinteger: 버킷을 나눌 기준인 UTC 동쪽으로의 분 단위 오프셋으로, -840에서 840까지입니다. 기본값은 0입니다. 로컬 시간대에는 `-new Date().getTimezoneOffset()`를 넘기세요.

예시

emails:read가 필요합니다.

curl

curl "$OE/broadcasts/brd_5a8c1e3f7b2d94a06c8e1f3b/stats?grain=day" -H "$AUTH"

응답

{  "object": "broadcast_stats",  "broadcastId": "brd_5a8c1e3f7b2d94a06c8e1f3b",  "grain": "day",  "totals": {    "recipients": 412,    "pending": 0,    "sent": 410,    "delivered": 404,    "bounced": 4,    "complained": 1,    "failed": 2,    "opened": 187,    "clicked": 52,    "unsubscribed": 3,    "opens": 296,    "clicks": 71  },  "series": [    { "bucket": "2026-09-23", "delivered": 404, "opened": 161, "clicked": 45, "unsubscribed": 3 },    { "bucket": "2026-09-24", "delivered": 0, "opened": 26, "clicked": 7, "unsubscribed": 0 }  ]}

opened, clicked, unsubscribed는 사람 수를 세고, opens와 clicks는 이벤트 수를 셉니다. pending은 아직 대기열에 있거나 예약되었거나 발송 중인 사본을, failed는 실패했거나 취소된 사본을 셉니다.

series는 희소하며 오래된 순입니다. 무언가 일어난 grain마다 버킷이 하나씩 있습니다. 각 사람은 그 일이 처음 일어난 시점에 한 번만 세어지므로, 합하면 합계와 같습니다.

bucket은 요청한 오프셋 기준의 YYYY-MM-DD, YYYY-MM-DDTHH 또는 YYYY-MM-DDTHH:MM입니다.

거절

상태	코드	발생 조건
400	`invalid_cursor`	받는 사람 목록에서, 그 목록이 내준 적 없는 `cursor`.
403	`insufficient_scope`	키에 `emails:read`가 없습니다.
404	`broadcast_not_found`	id가 이 워크스페이스의 어떤 브로드캐스트도 가리키지 않거나, 키가 특정 주소나 도메인으로 제한되어 있고 브로드캐스트가 키가 가지지 않은 곳에서 보내졌습니다.
404	`recipient_not_found`	`GET /broadcasts/{id}/recipients/{emailId}`에서, 이 브로드캐스트의 사본이 아닌 `emailId`.