API

오디언스 증가 읽기

지금 끝나는 기간 동안 각 오디언스에 몇 개의 연락처가 들어왔는지 일, 시간, 분 단위로 셉니다. 오디언스 페이지의 증가 차트와 같습니다. 오디언스는 누군가 들어온 시점만 기록하고 나간 시점은 기록하지 않으므로, 모든 수치는 오늘도 목록에 있는 사람을 들어온 날짜별로 센 것이며 선은 결코 내려가지 않습니다.

GETapi.openemail.uk/audiences/growth

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

GET /audiences/growth

예시

audiences:read가 필요합니다. 모든 오디언스라면 audienceIds를 생략하고, 좁히려면 쉼표로 구분해 최대 50개를 지정하세요. 기간은 days(1~1095) 또는 minutes(1~1576800, 둘 다 보내면 이쪽이 우선)이며 기본값은 30일입니다. grain은 day, hour, minute 중 하나로 기본값은 day이고, offsetMinutes(-840~840)는 보는 사람의 UTC 기준 시차로, 일 단위 구간이 현지 자정에 시작되게 합니다.

curl

curl "$OE/audiences/growth?days=30" -H "$AUTH"

응답

{  "object": "audience_growth",  "since": "2026-08-25T00:00:00.000Z",  "until": "2026-09-23T12:00:00.000Z",  "grain": "day",  "offsetMinutes": 0,  "totals": {    "contacts": 412,    "memberships": 415,    "added": 37,    "lists": 2,    "busiest": "2026-09-18"  },  "series": [    {      "id": "aud_9f2c4b7e1a0d63d84c5f2e7b",      "name": "All contacts",      "builtin": true,      "total": 412,      "before": 378,      "added": 34,      "buckets": [        { "bucket": "2026-09-14", "added": 9 },        { "bucket": "2026-09-18", "added": 25 }      ]    },    {      "id": "aud_4c1b8e2a7d9f05c36b4e8a71",      "name": "Product updates",      "builtin": false,      "total": 3,      "before": 0,      "added": 3,      "buckets": [{ "bucket": "2026-09-18", "added": 3 }]    }  ]}

total은 현재 멤버, before는 그중 since 이전에 들어온 사람, added는 기간 안에 들어온 사람이므로 before와 added를 더하면 total이 됩니다. 들어왔다가 나중에 나간 연락처는 어디에도 포함되지 않습니다.

totals.contacts는 몇 개의 목록에 있든 각 사람을 한 번만 세고, totals.memberships는 목록을 합산합니다. 그래서 한 사람은 읽은 목록 중 자신이 들어 있는 목록마다 한 번씩 세어지며, 기본 오디언스에는 모두가 들어 있습니다. totals.busiest는 모든 목록을 통틀어 참여가 가장 많았던 구간이며, 아무도 들어오지 않았으면 null입니다.

구간 키는 일 단위면 YYYY-MM-DD, 시간 단위면 YYYY-MM-DDTHH, 분 단위면 YYYY-MM-DDTHH:MM이며, offsetMinutes가 가리키는 현지 시각으로 표시됩니다. 참여가 있었던 구간만 나열되므로 그릴 때는 빈 곳을 0으로 채우세요. series는 total이 큰 순, 그다음 이름순으로 정렬되며, builtin은 기본 오디언스에서 true입니다.

audienceIds 중 이 워크스페이스의 오디언스가 아닌 ID는 404 audience_not_found가 되고, ID가 50개를 넘으면 422 invalid_parameter가 됩니다. 기간은 첫 구간의 시작에서 시작하므로 since는 정확히 days일 전보다 조금 이를 수 있습니다.