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"
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.
| Endpoint | Credits | What it returns |
|---|---|---|
| /categories | 20 | List Substack categories with their subcategories and the recommended view. |
| /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. |
| /category/publications | 20 | List one page of a Substack category leaderboard. |
| /directory | 20 | List Substack publication subdomains, one directory file at a time, cursor paged. |
| /note | 20 | Get a Substack note by id. |
| /note/replies | 20 | List the reply branches and comments of a Substack note. |
| /note/restacks | 20 | List the notes that restacked a Substack note. |
| /notes/explore | 20 | List the public Substack explore feed of notes and posts. |
| /post | 20 | Get a Substack post by id or URL, with the full free body or paid preview. |
| /post/comments | 20 | Get the whole nested comment tree of a Substack post. |
| /post/reactors | 20 | List the people who reacted to a Substack post. |
| /post/restackers | 20 | List the people who restacked a Substack post. |
| /profile | 20 | Get a Substack reader's public profile and subscriptions. |
| /profile/notes | 20 | List a Substack reader's public Notes and replies. |
| /profile/posts | 20 | List the posts a Substack reader published. |
| /profile/subscriptions | 20 | List the publications a Substack reader shows publicly. |
| /publication | 20 | Get Substack publication metadata, plans, audience bands and sections. |
| /publication/feed | 20 | Get a Substack publication's feed with its newest items. |
| /publication/posts/bodies | 20 | List Substack posts with their full free bodies. |
| /publication/posts/index | 20 | List every post URL in a Substack publication sitemap. |
| /publication/posts/search | 20 | Search the posts inside a Substack publication. |
| /publication/recommendations | 20 | List the publications a Substack publication recommends. |
| /search | 20 | Search Substack posts, notes and profiles, cursor paged. |
| /search/podcasts | 20 | Search Substack podcast shows. |
| /search/profiles | 20 | Search Substack profiles by text. |
| /search/publications | 20 | Search 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 API | Official Substack API | |
|---|---|---|
| Post text | Full text and Markdown in JSON | RSS feed per publication |
| Engagement | Reactions, comment trees, reactors and restacks | Not part of the Developer API data |
| Notes and search | Notes, explore feed and search across Substack | Not offered |
| Cost per call | from 10 credits | No 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.
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.
Per post returned. One post by its URL is 10 credits, a 25-post archive read is about 30, and the maximum of 100 posts is 120. The call quotes its range first and charges what it actually returned. Calls that fail or find nothing are free.
Yes. /v1/substack/posts takes start_date and end_date, content_type (newsletter, podcast or thread), only_free, and minimum comments, reactions and word count. Date filters apply to the most recent posts you ask for with limit, so raise limit to reach further back.
Yes. Pass the publication's substack.com address or its custom domain, or a single post URL ending in /p/ and the post slug.
Yes. /v1/substack/note returns a Note, /v1/substack/note/replies its replies and /v1/substack/notes/explore the public explore feed. /v1/substack/post/comments returns the whole nested comment tree of a post.
Every Substack endpoint except posts returns Substack's own record shapes under our naming rules (snake_case keys, string ids, ISO times) rather than the shared post entity, so fields may change. Those are 20 credits a call; posts is billed per post returned as above. Calls that fail or find nothing are free.
No. There is no Substack app, OAuth flow or review. One API key in the x-api-key header works for Substack and the other 60 platforms.
Yes. Your first 10 calls priced at 100 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.
60 requests a minute and 10 requests in flight at once, per API key. Going over either returns a 429 with a Retry-After header, and a rejected request costs nothing. There is no daily quota: past those two limits, your credit balance is what bounds volume.
List endpoints return rows in data.items and a pagination object with next_cursor and has_more. Send next_cursor back unchanged as the cursor parameter for the next page, and stop when has_more is false. A handful of endpoints page with their own parameter instead; their reference pages name it.
No. A call that errors or finds nothing costs 0 credits. A live fetch costs the endpoint's price, or for a metered endpoint what it actually read. 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.
A call fetches live unless a recent copy is in the shared cache, and every response says which with the cached field; a cached answer costs 2 credits. Add fresh=1 or send Cache-Control: no-cache to skip the cache; that call is charged at the normal price.
Collecting publicly available data is generally treated differently from accessing private data, but the answer depends on your jurisdiction, Substack's terms and what you do with personal data afterwards. The API reads public data only. Talk to a lawyer for anything commercial.
Substack API guides
The same key works for 60 more platforms
- TikTok scraper API
- LinkedIn scraper API
- Twitter/X scraper API
- YouTube scraper API
- Reddit scraper API
- Pinterest scraper API
- Bluesky scraper API
- Truth Social scraper API
- Snapchat scraper API
- Telegram scraper API
- Twitch scraper API
- Kick scraper API
- Rumble scraper API
- Kwai scraper API
- Douyin scraper API
- Xiaohongshu (RedNote) scraper API
- Quora scraper API
- TikTok Shop scraper API
- Weibo scraper API
- Zhihu scraper API
- Nextdoor scraper API
- Amazon scraper API
- App Store scraper API
- Apple Music scraper API
- Behance scraper API
- Dailymotion scraper API
- Deezer scraper API
- DEV Community scraper API
- Discord scraper API
- Dribbble scraper API
- Fandom scraper API
- Flickr scraper API
- GitHub scraper API
- Google Ads Transparency scraper API
- Google News scraper API
- Google Trends scraper API
- Gumroad scraper API
- Hacker News scraper API
- Hugging Face scraper API
- Ko-fi scraper API
- Lemmy scraper API
- Letterboxd scraper API
- Linktree scraper API
- Lnk.Bio scraper API
- Mastodon scraper API
- Medium scraper API
- MyAnimeList scraper API
- npm scraper API
- Polymarket scraper API
- Product Hunt scraper API
- Shopify scraper API
- SoundCloud scraper API
- Spotify scraper API
- Stack Overflow scraper API
- Stan Store scraper API
- Steam scraper API
- Vimeo scraper API
- Wikipedia scraper API
- Yahoo Finance scraper API
- Yelp scraper API