Substack Subscriptions API
The publications a reader shows publicly, one cursor page at a time.
GET /v1/substack/profiles/{handle}/subscriptions1 credit Failed requests are free
About this endpoint
GET /v1/substack/profiles/{handle}/subscriptions lists the publications a reader shows publicly. cursor comes from the previous page's page.nextCursor.
data.subscriptions[] carries id, visibility, membershipState, type, isFounding and a publication summary. data.total is the count when Substack reports one and null otherwise. data.profileId names the reader and data.page reports hasMore and nextCursor. lookupStatus is found or not_found.
Substack Subscriptions API FAQ
Are all of a person's subscriptions returned?
Only the ones the person shows publicly. Private subscriptions are not exposed, and the route does not claim to list them.
Why is total null?
Substack does not always report a count. total is null in that case; use the paging fields to know when the list ends.
How many subscriptions per page?
The route follows Substack's page size and reports page.hasMore and page.nextCursor. Keep requesting while hasMore is true.
How many credits does a subscriptions page cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Substack endpoints
- PublicationGET /v1/substack/publications/{publication}
- PostsGET /v1/substack/publications/{publication}/posts
- Post bodiesGET /v1/substack/publications/{publication}/posts/bodies
- Post indexGET /v1/substack/publications/{publication}/posts/index
- Search postsGET /v1/substack/publications/{publication}/posts/search
- RecommendationsGET /v1/substack/publications/{publication}/recommendations
- Publication feedGET /v1/substack/publications/{publication}/feed
- PostGET /v1/substack/posts/{post}