InsightSocial

Substack scraper API

The InsightSocial Substack API has 26 endpoints, from 10 credits a call. A posts call costs from 10 credits, about $0.01 on Pro, and your first 10 calls up to 100 credits each are free.

The Substack API for posts with full text, publications and their recommendations, comment trees, Notes, reader profiles, category leaderboards and search, as JSON.

26 endpoints · from 10 credits a call · 10 free calls up to 100 credits each · no credit card

curl "https://api.insightsocial.app/v1/substack/posts?url=https%3A%2F%2Fexample.substack.com%2Fp%2Fexample-post" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "substack",
"endpoint": "/v1/substack/posts",
"schema_version": "2",
"data": {
"items": [
{
"post": {
"id": "150000001",
"url": "https://example.substack.com/p/example-post",
"kind": "article",
"content": {
"text": "Most pricing pages fail for the same reason: they answer questions nobody asked...",
"media_urls": [
"https://cdn.example.com/substack/example-post.jpg"
],
"thumbnail_url": null,
"duration_seconds": null
},
"author": {
"id": null,
"username": "examplewriter",
"display_name": "Example Writer",
"avatar_url": "https://cdn.example.com/avatars/examplewriter.jpg",
"verified": null
},
"engagement": {
"views": null,
"likes": 412,
"comments": 58,
"shares": 23,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false,
"likes_hidden": null,
"comments_hidden": null,
"shares_hidden": null,
"views_hidden": null,
"saves_hidden": null
},
"published_at": "2026-09-24T13:00:00.000Z",
"language": "en",
"ext": {
"title": "Why pricing pages fail",
"subtitle": "And the three questions they should answer",
"slug": "example-post",
"post_type": "newsletter",
"paid": false,
"word_count": 2140,
"publication_name": "Example Notes",
"publication_url": "https://example.substack.com"
}
}
}
],
"total": null,
"truncated": null
},
"unavailable": [],
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

What Substack data can you get?

Public Substack data only, returned in the same JSON envelope as every other platform.

Posts in full

A publication's recent posts with full text and Markdown, filtered by date, type, comments, reactions or word count, or one post with its whole comment tree, reactors and restackers.

Publications

A publication's plans, audience bands and sections, its feed, every post URL in its sitemap, its free post bodies, a search inside it, and the publications it recommends.

Notes and reader profiles

A Note with its replies and restacks, the explore feed, and a reader's public profile, posts, Notes and subscriptions.

Search, categories and leaderboards

Posts, Notes, profiles, publications and podcasts by keyword, Substack's categories, and a category's leaderboard.

What people build with the Substack API

  • Newsletter research

    Read a publication's recent archive with min_reactions or min_comments to see which topics and formats its readers respond to.

  • Content and AI pipelines

    Pull posts as Markdown with word counts and dates to index, summarize or search a set of newsletters, without parsing HTML.

  • Sponsorship and creator scouting

    Read a category leaderboard, then each publication's audience band, posting rhythm and engagement per post before you reach out to a writer.

  • Reader and recommendation graphs

    Map which publications recommend each other, and which newsletters a reader subscribes to publicly, to find adjacent audiences.

Substack API endpoints

All 26 Substack endpoints and their price in credits. 1 are metered: they show a range and charge what the call actually read.

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

Parameters, response fields and examples for each endpoint are in the Substack API reference.

InsightSocial vs the official Substack API

Substack publishes an RSS feed for each publication, and its Developer API returns public creator and publication profile information, not post content.

InsightSocial APIOfficial Substack API
Post textFull text and Markdown in JSONRSS feed per publication
EngagementReactions, comment trees, reactors and restacksNot part of the Developer API data
Notes and searchNotes, explore feed and search across SubstackNot offered
Cost per callfrom 10 creditsNo per-call price; RSS for posts, the Developer API for profile data

The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.

How much does the Substack API cost?

Substack calls start at 10 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 1,000 single posts at 10 credits each.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Repeats and retries

    A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.

  • One balance

    API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.

Not writing code?

Connect InsightSocial to Claude or ChatGPT and ask for Substack data in plain English. Same account, same credits.

Use it from Claude or ChatGPT

Substack API: frequently asked questions

Substack gives every publication an RSS feed, and its Developer API returns public creator and publication information such as names, profile links and subscriber counts. Neither returns posts as structured JSON with engagement, Notes or search; /v1/substack/posts, /v1/substack/note and /v1/substack/search do.