# Subscribers historical API endpoint

Source: https://subalytics.com/docs/subscribers-historical/

> GET /api/v1/subscribers-historical/: weekly subscriber statistics by Subalytics ID, platform and date. Parameters and example.

`GET /api/v1/subscribers-historical/` (Offset pagination). Base URL `https://subalytics.com/api/v1/`, API key in the `X-API-key` header; authentication, pagination, dates and errors: https://subalytics.com/docs/

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=50
```