Subscribers in a period: growth, where they came from, why they left
Read live from consent history (D212): people subscribed to email now and at the start of the period (a person’s latest change wins, as on their profile), who subscribed and unsubscribed per bucket and in all (each person once), by source and origin, and per person’s locale. `locale` narrows to people in those locales.
Read live from consent history (D212): people subscribed to email now and at the start of the period (a person’s latest change wins, as on their profile), who subscribed and unsubscribed per bucket and in all (each person once), by source and origin, and per person’s locale. locale narrows to people in those locales.
apiKey readAuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: read
from?stringFrom (inclusive)
date-timeto?stringUntil (exclusive)
date-timelocale?stringComma-separated locales (nl-NL), any of them
OK
application/json- response
from*|date-timeto*stringdate-timebucket*string"day""week""month"timeZone*stringsubscribedNow*integersubscribedAtStart*integer|nullsubscribed*integerunsubscribed*integerprevious*|nullseries*array<>sources*array<>reasons*array<>locales*array<>curl -X GET 'https://api.postforge.dev/v1/analytics/audience'{ "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z", "bucket": "day", "timeZone": "string", "subscribedNow": 0, "subscribedAtStart": 0, "subscribed": 0, "unsubscribed": 0, "previous": { "subscribed": 0, "unsubscribed": 0 }, "series": [ { "at": "2019-08-24T14:15:22Z", "total": 0, "subscribed": 0, "unsubscribed": 0 } ], "sources": [ { "kind": "store", "origin": "customer", "people": 0 } ], "reasons": [ { "kind": "store", "origin": "customer", "people": 0 } ], "locales": [ { "locale": "string", "subscribedNow": 0, "subscribed": 0, "unsubscribed": 0 } ]}How email was delivered in a period GET
Read live (D213): every real email sent in the period (campaigns and automations) with deliveries, bounces (hard and soft) and spam complaints against the period before; per bucket by when they went out; bounces by reason; per mailbox provider (from each address’s domain) and per domain sent from; emails not sent by why; addresses suppressed in the period by why. `locale` narrows to emails in those locales.
Lists and segments: people in them, who joined and left in a period GET
Each list (people now) and segment (people as of its last check; unpublished ones have none) with the people who joined and left in the period, from *List Joined*, *List Left*, *Segment Entered* and *Segment Exited*. A segment counts joins from when it was published: publishing builds it without events (D164). `locale` narrows to people in those locales.