API documentation · Creator endpoints
Substack posts API endpoint
GET
/api/v1/substack-posts/
Cursor 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.
Search posts by creator, audience and engagement. By default returns post summaries: title, URL, date, description, a truncated body and engagement counts.
| Parameter | Type | Description |
|---|---|---|
sub_id | string | Subalytics ID of one creator |
audience | string | Audience, e.g. only_paid or everyone |
wordcount | int | Minimum word count |
comment_count | int | Minimum number of comments |
reaction_count | int | Minimum number of reactions |
full | string | true = return the complete post record |
limit | int | Results per page (default 25, max 100) |
cursor | string | next_cursor from the previous page |
Example
GET /api/v1/substack-posts/?sub_id=803b198749&audience=only_paidThis page as Markdown: /docs/substack-posts.md.
All docs in one file: /llms-full.txt.