c5ddcd5c7e72
Get subscriber events over time for a creator
Returns cursor-paginated subscriber event data for the specified creator over a specified time period.
This endpoint is an analytics time series, not a real-time audience snapshot:
- newSubscribersCount = number of new subscription starts in the period bucket
- cancelledSubscribersCount = number of subscription chain ends in the period bucket
- total = cumulative net change from the beginning of the requested range (new - cancelled)
If you need a current audience count/list (for messaging or contact list UX), use Smart Lists endpoints (/{creatorUserUuid}/chats/lists/smart and /{creatorUserUuid}/chats/lists/smart/{uuid}) instead of this endpoint.
Data is aggregated daily with timezone-aware boundaries. When dates include timezone offsets, results are normalized to midnight in that timezone (expressed as UTC).
Path parameters
Query parameters
Start date as ISO 8601 datetime string with optional timezone offset (e.g., 2024-10-20T00:00:00+01:00 or 2024-10-20T00:00:00Z). Data is aggregated daily with timezone-aware boundaries. Time component is ignored for daily aggregation.
Start date as ISO 8601 datetime string with optional timezone offset (e.g., 2024-10-20T00:00:00+01:00 or 2024-10-20T00:00:00Z). Data is aggregated daily with timezone-aware boundaries. Time component is ignored for daily aggregation.
End date as ISO 8601 datetime string with optional timezone offset (e.g., 2024-10-25T00:00:00+01:00 or 2024-10-25T00:00:00Z). Non-inclusive - data before this date is included. Data is aggregated daily with timezone-aware boundaries. Time component is ignored for daily aggregation.
End date as ISO 8601 datetime string with optional timezone offset (e.g., 2024-10-25T00:00:00+01:00 or 2024-10-25T00:00:00Z). Non-inclusive - data before this date is included. Data is aggregated daily with timezone-aware boundaries. Time component is ignored for daily aggregation.
Cursor for pagination - If given, pass nextCursor to get the next page.
Cursor for pagination - If given, pass nextCursor to get the next page.
Number of items to return per page (1-50, default: 20). When omitted on a cursor request, the size from the previous page (carried in the cursor) is reused.
Number of items to return per page (1-50, default: 20). When omitted on a cursor request, the size from the previous page (carried in the cursor) is reused.
Headers
API version to use for the request
Response
Creator subscribers data with cursor pagination