Creator intelligence and data analytics for Substack, Bluesky, Medium, podcasts and Snapchat
Subalytics Logo Request Access

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>"
}