Substack API

Substack Scraper API for Publications, Posts and Notes

Search publications, browse newsletter posts and writer activity, and retrieve articles, Notes and replies. Keep author details, media and reader responses together in your research.

Create a free account. No credit card needed.

WHAT YOU CAN BUILD / 10 ENDPOINTS

Put Substack data to work.

Find your use case, then explore the request and response.

Get a Substack publication

GET/v1/substack/publication

Build a newsletter directory from publication names, descriptions, images and author details, with a source link for each entry.

Get a Substack publication’s posts

GET/v1/substack/posts

Build a newsletter reading list from post titles, publication times and engagement. Choose newest or top posts and use the offset to retrieve another page.

Get a Substack post

GET/v1/substack/post

Build an article research record with the title, author, published text, engagement, audio and video metadata, playback identifiers and caption links.

Get a Substack post’s comments

GET/v1/substack/post/comments

Build a reader-feedback sheet from comment text, author details, reactions and replies with parent IDs. Select the number of comments and reply depth.

Get a Substack writer profile

GET/v1/substack/profile

Build a writer directory with public names, handles, bios, profile images, audience counts, profile links and publications.

Search Substack publications

GET/v1/substack/search

Build a newsletter discovery tool from publication names, descriptions, author details and images returned for a search phrase. Use the returned page number to continue.

Get a Substack writer’s activity feed

GET/v1/substack/profile/feed

Build a writer activity feed from posts and Notes with author details, article or Note content, media attachments and engagement. Continue with the returned cursor.

Get a Substack Note

GET/v1/substack/note

Build a Note research card with published text, author details, reactions, restacks, attachments and parent discussion context.

Get a Substack Note’s replies

GET/v1/substack/note/replies

Build a Note discussion view from the root Note and its replies, with author details, text, reactions and attachments. Continue with the returned cursor.

Get Substack publication categories

GET/v1/substack/categories

Build a publication topic picker from category IDs, names and slugs.

HOW IT WORKS

From API key to Substack data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 10 Substack endpoints and add its input, such as a public URL.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Substack data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

LIVE RESULTS

Try a sample request.

Try the Substack API right here. This sample uses the Get a Substack publication endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with https://on.substack.com/, or change the url field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Get a Substack publicationNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "https://on.substack.com/";
const url = new URL("/website/demo/substack",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/substack/publication

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 successful requests

Growth

Popular

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 successful requests

Save 6.3% compared with Starter

Scale

For high-volume data collection.

$249USD / one-time

200,000 credits

$1.25 per 1,000 successful requests

Save 34.5% compared with Starter

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Substack API

Frequently Asked Questions

Explore the API reference

Substack API and scraping

What public data can I retrieve with the Substack API?

Search publications, read newsletter archives and article details, retrieve writer profiles and activity feeds, and follow Notes and replies as structured JSON. Publication categories, author details, media and engagement help your application organize the writing and discussion.

Can I retrieve a Substack writer profile?

Yes. Pass the writer’s handle to Profile to retrieve public identity, bio, profile image, audience counts, links and publications. Use Profile Feed to collect their posts and Notes with engagement and media, then pass the returned cursor to request another page.

How do I scrape posts from a Substack publication?

Pass the publication URL to Posts to retrieve its archive. Choose new or top sorting, set a result limit and increase the offset for another page. Use a returned post URL with Post Details to add its published content to your reading list.

Substack: publication discovery, notes and discussions

Can I retrieve Substack Notes and their engagement?

Pass a numeric Note ID to Note Details to retrieve published text, author details, reactions, restacks, attachments and parent discussion context. Profile Feed brings a writer’s Notes and newsletter posts together; Post Details retrieves an article by its post URL.

Can I search for Substack publications and retrieve their categories?

Search returns publication names, descriptions, images and author details for a query. Continue with the returned page number to request another page. Categories returns topic IDs, names and slugs for organizing a newsletter discovery directory.

Can I retrieve Substack article comments and Note replies?

Yes. Pass a post URL to Post Comments and choose the result limit and reply depth. Parent IDs and depth link comment records into a discussion. Pass a numeric Note ID to Note Replies to read the root Note and replies with text, authors, reactions and attachments, continuing with the returned cursor.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

No credit card needed.Building with an AI agent?