# Creators historical API endpoint

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

> GET /api/v1/creators-historical/: weekly creator records by Subalytics ID, platform, week, year or date range. Parameters and example.

`GET /api/v1/creators-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 creator records by Subalytics ID, platform, week/year or date range.

| 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 |
| `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/creators-historical/?sub_id=714165582b&year=2025&limit=20
```