API documentation · Creator endpoints
Subscribers historical API endpoint
GET
/api/v1/subscribers-historical/
Offset pagination
All requests go to https://subalytics.com/api/v1/ with your key in the
X-API-key header. Authentication,
pagination, date filters
and responses & errors apply to every endpoint.
Weekly subscriber statistics by Subalytics ID, platform and date.
| Parameter | Type | Description |
|---|---|---|
sub_id | string | Subalytics ID of one creator |
social | string | Platform: substack, medium or bluesky |
week_number | int | ISO week number (1–53) |
year | int | Year, e.g. 2025 |
free_subscribers | int | Minimum number of free subscribers |
paid_subscribers | int | Minimum number of paid subscribers |
from | string | Start date of the week, from (YYYY-MM-DD) |
to | string | Start date of the week, to (YYYY-MM-DD) |
limit | int | Results per page (default 25, max 100) |
offset | int | Records to skip (default 0) |
Example
GET /api/v1/subscribers-historical/?sub_id=f2ac9f1545&from=2025-03-01&to=2025-05-01&limit=50This page as Markdown: /docs/subscribers-historical.md.
All docs in one file: /llms-full.txt.