InsightSocial API

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
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.

EndpointCreditsWhat it returnsKey parameters
/categories20List Substack categories with their subcategories and the recommended view. Beta.—
/posts10–120Returns 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/publications20List one page of a Substack category leaderboard. Beta.category_id
/directory20List Substack publication subdomains, one directory file at a time, cursor paged. Beta.—
/note20Get a Substack note by id. Beta.note_id
/note/replies20List the reply branches and comments of a Substack note. Beta.note_id
/note/restacks20List the notes that restacked a Substack note. Beta.note_id
/notes/explore20List the public Substack explore feed of notes and posts. Beta.—
/post20Get a Substack post by id or URL, with the full free body or paid preview. Beta.post
/post/comments20Get the whole nested comment tree of a Substack post. Beta.post
/post/reactors20List the people who reacted to a Substack post. Beta.post
/post/restackers20List the people who restacked a Substack post. Beta.post
/profile20Get a Substack reader's public profile and subscriptions. Beta.handle
/profile/notes20List a Substack reader's public Notes and replies. Beta.handle
/profile/posts20List the posts a Substack reader published. Beta.handle
/profile/subscriptions20List the publications a Substack reader shows publicly. Beta.handle
/publication20Get Substack publication metadata, plans, audience bands and sections. Beta.publication
/publication/feed20Get a Substack publication's feed with its newest items. Beta.publication
/publication/posts/bodies20List Substack posts with their full free bodies. Beta.publication
/publication/posts/index20List every post URL in a Substack publication sitemap. Beta.publication
/publication/posts/search20Search the posts inside a Substack publication. Beta.publication, query
/publication/recommendations20List the publications a Substack publication recommends. Beta.publication
/search20Search Substack posts, notes and profiles, cursor paged. Beta.query
/search/podcasts20Search Substack podcast shows. Beta.query
/search/profiles20Search Substack profiles by text. Beta.query
/search/publications20Search Substack publications and their metadata. Beta.query

On this page