Leer el crecimiento de las audiencias
Cuántos contactos se unieron a cada audiencia en un periodo que termina ahora, contados por día, hora o minuto: el gráfico de crecimiento de la página de audiencias. Una audiencia registra cuándo alguien se unió y nunca cuándo se fue, así que cada cifra cuenta a las personas que siguen hoy en la lista según la fecha en que se unieron, y una línea nunca baja.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
GET /audiences/growth
Cuántos contactos se unieron a cada audiencia en un periodo que termina ahora, contados por día, hora o minuto: el gráfico de crecimiento de la página de audiencias. Una audiencia registra cuándo alguien se unió y nunca cuándo se fue, así que cada cifra cuenta a las personas que siguen hoy en la lista según la fecha en que se unieron, y una línea nunca baja.
Ejemplo
Necesita audiences:read. Omite audienceIds para todas las audiencias, o indica hasta 50 separadas 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, para que los tramos diarios empiecen a su medianoche local.
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 son los miembros actuales, before los que de entre ellos se unieron antes de since, y added los que se unieron dentro del periodo, así que before más added es total. Un contacto que se unió y luego se fue no está en ninguno de ellos.
totals.contacts cuenta a cada persona una vez, esté en las listas que esté, mientras que totals.memberships suma las listas, así que una persona cuenta una vez por cada lista leída que la contiene, y la audiencia por defecto contiene a todo el mundo. totals.busiest es el tramo con más altas entre todas las listas, o null si nadie se unió.
Las claves de tramo son YYYY-MM-DD por día, YYYY-MM-DDTHH por hora y YYYY-MM-DDTHH:MM por minuto, en la hora local que indica offsetMinutes. Solo se listan los tramos con alguna alta, así que rellena los huecos con cero al dibujarlos. series se ordena por total, de mayor a menor, y luego por nombre, y builtin es true en la audiencia por defecto.
Un id de audienceIds que no es una audiencia de este espacio de trabajo es un 404 audience_not_found, y más de 50 ids es un 422 invalid_parameter. El periodo empieza al principio de su primer tramo, así que since puede caer un poco antes que exactamente days atrás.