Чтение роста аудиторий
Сколько контактов вступило в каждую аудиторию за период, который заканчивается сейчас, с подсчётом по дням, часам или минутам: график роста на странице аудиторий. Аудитория записывает, когда человек вступил, и никогда не записывает, когда он вышел, так что каждое число считает людей, которые и сегодня в списке, по дате вступления, и линия никогда не идёт вниз.
Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.
GET /audiences/growth
Сколько контактов вступило в каждую аудиторию за период, который заканчивается сейчас, с подсчётом по дням, часам или минутам: график роста на странице аудиторий. Аудитория записывает, когда человек вступил, и никогда не записывает, когда он вышел, так что каждое число считает людей, которые и сегодня в списке, по дате вступления, и линия никогда не идёт вниз.
Пример
Требует audiences:read. Не указывайте audienceIds, чтобы получить все аудитории, или перечислите до 50 через запятую. Период задаётся days (от 1 до 1095) или minutes (от 1 до 1576800, имеет приоритет, если переданы оба), по умолчанию 30 дней. grain — это day, hour или minute, по умолчанию day, а offsetMinutes (от -840 до 840) — смещение смотрящего относительно UTC, чтобы дневные интервалы начинались в его местную полночь.
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. Перечисляются только интервалы, в которых кто-то вступил, поэтому при построении графика заполняйте пропуски нулями. series отсортирован по total, от большего к меньшему, затем по имени, а builtin равен true у аудитории по умолчанию.
Идентификатор в audienceIds, не являющийся аудиторией этого рабочего пространства, даёт 404 audience_not_found, а больше 50 идентификаторов дают 422 invalid_parameter. Период начинается с начала первого интервала, поэтому since может оказаться немного раньше, чем ровно days назад.