Substack
Substack API reference: 26 endpoints for posts, publications, comments, Notes and search. Per-endpoint credit prices and cURL examples.
Posts with full text and engagement, publications and their recommendations, comments, Notes, reader profiles, categories and search.
Base path: /v1/substack/...
Quickstart
curl "https://api.insightsocial.app/v1/substack/posts?url=https%3A%2F%2Fwww.astralcodexten.com" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
1 of these is metered: the price depends on how much the call reads. See Credits.
25 are beta: they return the platform's own structure under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp) rather than a schema-2 entity, and their fields may change. See Beta endpoints.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/categories | 20 | List Substack categories with their subcategories and the recommended view. Beta. | — |
/posts | 10–120 | Returns a publication’s recent posts, or one post: title, full text and Markdown, author, reactions, comments, restacks, word count and whether it is paid. | url |
/category/publications | 20 | List one page of a Substack category leaderboard. Beta. | category_id |
/directory | 20 | List Substack publication subdomains, one directory file at a time, cursor paged. Beta. | — |
/note | 20 | Get a Substack note by id. Beta. | note_id |
/note/replies | 20 | List the reply branches and comments of a Substack note. Beta. | note_id |
/note/restacks | 20 | List the notes that restacked a Substack note. Beta. | note_id |
/notes/explore | 20 | List the public Substack explore feed of notes and posts. Beta. | — |
/post | 20 | Get a Substack post by id or URL, with the full free body or paid preview. Beta. | post |
/post/comments | 20 | Get the whole nested comment tree of a Substack post. Beta. | post |
/post/reactors | 20 | List the people who reacted to a Substack post. Beta. | post |
/post/restackers | 20 | List the people who restacked a Substack post. Beta. | post |
/profile | 20 | Get a Substack reader's public profile and subscriptions. Beta. | handle |
/profile/notes | 20 | List a Substack reader's public Notes and replies. Beta. | handle |
/profile/posts | 20 | List the posts a Substack reader published. Beta. | handle |
/profile/subscriptions | 20 | List the publications a Substack reader shows publicly. Beta. | handle |
/publication | 20 | Get Substack publication metadata, plans, audience bands and sections. Beta. | publication |
/publication/feed | 20 | Get a Substack publication's feed with its newest items. Beta. | publication |
/publication/posts/bodies | 20 | List Substack posts with their full free bodies. Beta. | publication |
/publication/posts/index | 20 | List every post URL in a Substack publication sitemap. Beta. | publication |
/publication/posts/search | 20 | Search the posts inside a Substack publication. Beta. | publication, query |
/publication/recommendations | 20 | List the publications a Substack publication recommends. Beta. | publication |
/search | 20 | Search Substack posts, notes and profiles, cursor paged. Beta. | query |
/search/podcasts | 20 | Search Substack podcast shows. Beta. | query |
/search/profiles | 20 | Search Substack profiles by text. Beta. | query |
/search/publications | 20 | Search Substack publications and their metadata. Beta. | query |