Subalytics API v1 Documentation

Build powerful tools and reports with our influencer and content APIs
Create free account Get full access

Base URL

https://subalytics.com/

Authentication

X-API-key: <your-api-key>

Influencers (Snapshot)

Endpoint: /api/v1/influencers/

Retrieve a weekly snapshot of influencer data.

Parameter Type Description
sub_id string Subalytics ID (UID)
social string Filter by social platform (substack, medium, or bluesky)
free_subscribers int Number of free subscribers
paid_subscribers int Number of paid subscribers
limit int Max 500
cursor str Pagination token

Example: https://subalytics.com/api/v1/influencers?social=bluesky&free_subscribers=5000

Creators (Historical)

Endpoint: /api/v1/creators-historical/

Get creator records by sub_id, social, week/year or date range.

Parameter Type Description
sub_id string Filter by Subalytics ID (UID)
social string Social platform
week_number int ISO week number (1–53)
year int Year (e.g. 2025)
from string (optional) Start date (YYYY-MM-DD)
to string (optional) End date (YYYY-MM-DD)
limit int Max 500
offset int Pagination offset

Example: https://subalytics.com/api/v1/creators-historical?sub_id=714165582b&year=2025&limit=20

Subscribers (Historical)

Endpoint: /api/v1/subscribers-historical/

Get historical subscriber stats by sub_id and date.

Parameter Type Description
sub_id string Subalytics ID (UID)
social string Social platform
week_number int Week number
year int Year
free_subscribers int Number of free subscribers
paid_subscribers int Number of paid subscribers
from string Start date (YYYY-MM-DD)
to string End date (YYYY-MM-DD)
limit int Max 100
cursor string Pagination token

Example: https://subalytics.com/api/v1/subscribers-historical?sub_id=f2ac9f1545&from=2025-03-01&to=2025-05-01&limit=50

Substack Posts

Endpoint: /api/v1/substack-posts/

Search content posts by metadata like sub_id, wordcount, or audience.

Parameter Type Description
sub_id string Subalytics ID (UID)
audience string Audience (e.g. only_paid, everyone)
wordcount int Word count
comment_count int Number of comments
reaction_count int Number of reactions
limit int Max 500
cursor string Pagination token

Example: https://subalytics.com/api/v1/substack-posts?sub_id=803b198749&audience=only_paid

Common Success Response

{
  "success": true,
  "results": [ ... ],
  "returned_results": 10,
  "next_cursor": None,
  "limit": 10
}

Common Error Responses

Invalid Parameters:

{
  "success": false,
  "error_code": 400,
  "msg": "Unknown parameters: bad_param"
}

Pagination Violation:

{
  "success": false,
  "error_code": 400,
  "msg": "Limit cannot be larger than 500."
}

Internal Server Error:

{
  "success": false,
  "error_code": 500,
  "msg": "Internal server error: <message>"
}