#### Try it: 20 posts from Lenny's Newsletter, with comments
```json
{
"startUrls": [
"https://www.lennysnewsletter.com"
],
"maxItemsPerSource": 20,
"includeComments": true,
"maxCommentsPerPost": 10
}
```
[Open the actor input](https://console.apify.com/actors/xLv7VvQUFabP4Eku9/input) and paste this in JSON mode. You get the 20 newest posts with full text, up to 10 comments and replies on each (comments are billed per comment), and one row with the publication's subscriber count, plans and analytics. Remove `maxItemsPerSource` to export the whole archive, or set a date window for recent posts only.
| Clearpath Content Research • Posts, articles and threads with full text |
 Substack Posts➤ You are here  Medium ArticlesWhole tag and author archives  Reddit SearchPosts by keyword  Reddit CommentsFull threads and replies |
Welcome to our very first Substack Fun Fact. Let’s make it a series, shall we?!
I had no idea I’d be creating a whole series with my second post ever but this one was too good not to share. Mostly because it’s at my own",
"bodyText": "Welcome to our very first Substack Fun Fact. Let’s make it a series, shall we?!\nI had no idea I’d be creating a whole series with my second post ever but this one was too good not to share. Mostly because it’s at my own expense.\nDID YOU KNOW…?\nYou cannot have",
"bodyMarkdown": "Welcome to our very first **Substack Fun Fact**. Let’s make it a series, shall we?!\n\nI had no idea I’d be creating a whole series with my second post ever but this one was too good not to share. Mostly because it’s at my own expense.\n\n# DID YOU KNOW…?\n\nYou",
"editorV2": false,
"videoUploadId": null,
"podcastUploadId": null,
"shouldSendFreePreview": false,
"freeUnlockRequired": false,
"defaultCommentSort": null,
"topExclusions": [],
"pins": [],
"isSectionPinned": false,
"videoUpload": null,
"podcastPreviewUploadId": null,
"podcastUpload": null,
"podcastPreviewUpload": null,
"voiceoverUploadId": null,
"voiceoverUpload": null,
"bodyJson": null,
"hasDynamicContent": false,
"postPreviewLimit": null,
"teaserPostEligible": true,
"postCountryBlocks": [],
"headlineTest": null,
"coverImagePalette": {
"Vibrant": {
"rgb": [
252,
148,
76
],
"population": 3073
},
"DarkVibrant": {
"rgb": [
130.4142857142857,
54.64285714285715,
2.1857142857142837
],
"population": 0
},
"LightVibrant": {
"rgb": [
252,
172,
116
],
"population": 6
},
"Muted": {
"rgb": [
150.47802197802199,
63.049450549450555,
2.521978021978013
],
"population": 0
},
"DarkMuted": {
"rgb": [
150.47802197802199,
63.049450549450555,
2.521978021978013
],
"population": 0
},
"LightMuted": {
"rgb": [
212,
180,
164
],
"population": 1
}
},
"isGeoblocked": false,
"isEditorPreview": false,
"hasCashtag": false,
"audienceBeforeArchived": null,
"exemptFromArchivePaywall": false,
"podcastArtUrl": null,
"showGuestBios": true,
"meterType": "none",
"liveStreamId": null,
"isPublished": true,
"sectionPins": [],
"hasShareableClips": false,
"unlockedWithCampaign": false,
"source": {
"type": "publication",
"value": "https://unstackit.substack.com",
"title": "Unstack Substack",
"url": "https://unstackit.substack.com"
},
"scrapedAt": "2026-10-11T10:18:18.890Z"
}
```
**Paid posts** come with the preview every visitor sees: `isPaid: true`, `bodyAvailable: false`, and the preview in the body fields. Comments on paid-only threads are not public, so they are not returned.
#### Comments and replies
One row per comment or reply, in thread order. `parentId` and `depth` rebuild the thread; `isAuthor` marks the post's authors. Replies under a Note carry `noteId` instead of `postId`.
```json
{
"type": "comment",
"id": 351972979,
"url": "https://unstackit.substack.com/p/substack-callout-blocks/comment/351972979",
"kind": "reply",
"postId": 199369343,
"postTitle": "How to Make Readers Stick Around For Longer Than One Post",
"postUrl": "https://unstackit.substack.com/p/substack-callout-blocks",
"postPublishedAt": "2026-10-03T12:02:13.784Z",
"noteId": null,
"publicationId": 2328962,
"publicationName": "Unstack Substack",
"publicationUrl": "https://unstackit.substack.com",
"parentId": 351890799,
"rootId": 351890799,
"depth": 1,
"body": "Aww Tamsin, I super appreciate that you upgraded ☺️ Don’t ever feel bad though...some of them are free but some are not. I try to offer a good balance for everyone. Thank you so much and I'm so glad you're finding them helpful!",
"bodyJson": {
"type": "doc",
"attrs": {
"schemaVersion": "v1",
"title": null
},
"content": [
{
"type": "paragraph",
"content": [
{
"type": "text",
"text": "Aww Tamsin, I super appreciate that you upgraded ☺️ Don’t ever feel bad though...some of them are free but some are not. I try to offer a good balance for everyone. Thank you so much and I'm so glad you're finding them helpful!"
}
]
}
]
},
"title": "Aww Tamsin, I super appreciate that you upgraded ☺️ Don’t ever feel bad though...some of them are free but some are n...",
"publishedAt": "2026-10-03T15:00:10.125Z",
"editedAt": null,
"authorId": 165322060,
"authorName": "Kristi Keller 🇨🇦",
"authorHandle": "kristikeller",
"authorPhotoUrl": "https://substackcdn.com/image/fetch/$s_!TdHE!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0bee1713-6b2a-45fa-bbb6-e9437756af86_316x326.png",
"authorProfileUrl": "https://substack.com/@kristikeller",
"authorBestsellerTier": 100,
"authorBestsellerLabel": "Bestseller: hundreds of paid subscribers",
"isAuthor": true,
"isPinned": false,
"pinnedByUserId": null,
"reactionCount": 1,
"reactions": {
"❤": 1
},
"restackCount": 0,
"replyCount": 0,
"attachments": [],
"deleted": false,
"status": "published",
"ancestorPath": "351890799",
"reactorNames": [],
"bans": [],
"suppressed": false,
"userBanned": false,
"userBannedForComment": false,
"userSlug": "kristikeller",
"metadata": {
"isAuthor": true,
"membershipState": "subscribed",
"eligibleForGift": false,
"authorOnOtherPub": {
"name": "Unstack Substack",
"id": 2328962,
"baseUrl": "https://unstackit.substack.com"
}
},
"canDm": false,
"userStatus": {
"bestsellerTier": 100,
"subscriberTier": 1,
"leaderboard": null,
"vip": false,
"badge": {
"type": "bestseller",
"tier": 100
},
"subscriber": null
},
"score": 10,
"restacked": false,
"source": {
"type": "url",
"value": "https://unstackit.substack.com/p/substack-callout-blocks",
"title": "How to Make Readers Stick Around For Longer Than One Post",
"url": "https://unstackit.substack.com/p/substack-callout-blocks"
},
"scrapedAt": "2026-10-11T10:18:28.856Z"
}
```
#### Notes
One row per feed item: `kind` is `note` (a Note), `restack` (a restacked post or Note, with `restackedPost` or `restackedNote`) or `post` (a post shared in the feed). Attachments carry their own `url`, collected in `attachmentUrls`.
```json
{
"type": "note",
"id": 46113288,
"entityKey": "c-46113288",
"kind": "note",
"url": "https://substack.com/@kristikeller/note/c-46113288",
"body": "Question of the day:",
"bodyJson": {
"type": "doc",
"attrs": {
"schemaVersion": "v1"
},
"content": [
{
"type": "paragraph",
"content": [
{
"type": "text",
"text": "Question of the day:"
}
]
}
]
},
"title": "Question of the day:",
"publishedAt": "2023-12-27T17:26:16.475Z",
"authorId": 165322060,
"authorName": "Kristi Keller 🇨🇦",
"authorHandle": "kristikeller",
"authorPhotoUrl": "https://substackcdn.com/image/fetch/$s_!TdHE!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0bee1713-6b2a-45fa-bbb6-e9437756af86_316x326.png",
"authorBio": "Builder of highly engaged communities, helping others create fabulous and FUNCTIONAL Substack publications, all while wearing sweatpants and basking in the comfort of my living room.",
"authorProfileUrl": "https://substack.com/@kristikeller",
"authorBestsellerTier": 100,
"authorBestsellerLabel": "Bestseller: hundreds of paid subscribers",
"reactionCount": 7,
"reactions": {
"❤": 7
},
"restackCount": 1,
"replyCount": 7,
"attachments": [
{
"id": "7120d278-e449-4b12-a83a-acf0be72d854",
"type": "image",
"imageUrl": "https://substack-post-media.s3.amazonaws.com/public/images/c4cc07f8-f3b2-4f14-8601-3372cce50aa1_1080x1080.png",
"imageWidth": 1080,
"imageHeight": 1080,
"explicit": false,
"url": "https://substack-post-media.s3.amazonaws.com/public/images/c4cc07f8-f3b2-4f14-8601-3372cce50aa1_1080x1080.png"
}
],
"attachmentUrls": [
"https://substack-post-media.s3.amazonaws.com/public/images/c4cc07f8-f3b2-4f14-8601-3372cce50aa1_1080x1080.png"
],
"language": null,
"editedAt": null,
"parentId": null,
"canReply": true,
"isMuted": false,
"context": {
"type": "note",
"timestamp": "2023-12-27T17:26:16.475Z",
"fallbackReason": "//TODO: create fallback reasons",
"fallbackUrl": null,
"isFresh": false,
"source": "db-note",
"page": null,
"pageRank": 2
},
"publicationId": 2328962,
"publicationName": "Unstack Substack",
"publicationUrl": "https://unstackit.substack.com",
"publication": {
"id": 2328962,
"subdomain": "unstackit",
"customDomainOptional": false,
"name": "Unstack Substack",
"logoUrl": "https://substack-post-media.s3.amazonaws.com/public/images/9ec83ce1-c3b2-4b6f-87d9-41902e60a69f_500x500.png",
"authorId": 165322060,
"userId": 165322060,
"handlesEnabled": false,
"explicit": false,
"isPersonalMode": false,
"paymentsState": "enabled",
"pledgesEnabled": false,
"iosAppPaymentsEnabled": true,
"hasReplyRules": true
},
"author": {
"id": 165322060,
"name": "Kristi Keller 🇨🇦",
"handle": "kristikeller",
"photoUrl": "https://substackcdn.com/image/fetch/$s_!TdHE!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0bee1713-6b2a-45fa-bbb6-e9437756af86_316x326.png",
"bio": "Builder of highly engaged communities, helping others create fabulous and FUNCTIONAL Substack publications, all while wearing sweatpants and basking in the comfort of my living room.",
"profileSetUpAt": "2023-08-25T22:34:50.885Z",
"readerInstalledAt": "2023-08-26T04:00:31.390Z",
"bestsellerTier": 100,
"status": {
"bestsellerTier": 100,
"subscriberTier": 1,
"leaderboard": null,
"vip": false,
"badge": {
"type": "bestseller",
"tier": 100
},
"subscriber": null
},
"primaryPublication": {
"id": 2328962,
"subdomain": "unstackit",
"customDomainOptional": false,
"name": "Unstack Substack",
"logoUrl": "https://substack-post-media.s3.amazonaws.com/public/images/9ec83ce1-c3b2-4b6f-87d9-41902e60a69f_500x500.png",
"authorId": 165322060,
"userId": 165322060,
"handlesEnabled": false,
"explicit": false,
"isPersonalMode": false,
"paymentsState": "enabled",
"pledgesEnabled": false,
"iosAppPaymentsEnabled": true,
"hasReplyRules": true
}
},
"postId": null,
"replyMinimumRole": "everyone",
"mediaClipId": null,
"restacked": false,
"userStatus": {
"bestsellerTier": 100,
"subscriberTier": 1,
"leaderboard": null,
"vip": false,
"badge": {
"type": "bestseller",
"tier": 100
},
"subscriber": null
},
"autotranslateTo": null,
"isAiDetectionDisabled": false,
"canShowFollowUpsell": false,
"canShowCommentReveal": false,
"source": {
"type": "profile",
"value": "https://substack.com/@kristikeller",
"title": "Kristi Keller 🇨🇦",
"url": "https://substack.com/@kristikeller"
},
"scrapedAt": "2026-10-11T10:20:45.763Z",
"rank": 1878
}
```
#### Profiles
Excerpt (lists shortened to one entry):
```json
{
"type": "profile",
"id": 165322060,
"handle": "kristikeller",
"name": "Kristi Keller 🇨🇦",
"bio": "Builder of highly engaged communities, helping others create fabulous and FUNCTIONAL Substack publications, all while wearing sweatpants and basking in the comfort of my living room.",
"photoUrl": "https://substackcdn.com/image/fetch/$s_!TdHE!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0bee1713-6b2a-45fa-bbb6-e9437756af86_316x326.png",
"url": "https://substack.com/@kristikeller",
"joinedAt": "2023-08-25T22:34:50.885Z",
"twitterScreenName": null,
"twitterUrl": null,
"links": [
{
"id": 3868807,
"value": "www.unstacksubstack.com",
"url": "https://www.unstacksubstack.com",
"type": null,
"label": "Website"
}
],
"publications": [
{
"id": 2328962,
"handle": "unstackit",
"name": "Unstack Substack",
"role": "admin",
"url": "https://unstackit.substack.com",
"isPrimary": true,
"logoUrl": "https://substack-post-media.s3.amazonaws.com/public/images/9ec83ce1-c3b2-4b6f-87d9-41902e60a69f_500x500.png",
"heroText": "I help fellow Substackers make the most of their time by unstacking all the back-end chores that come along with writing on this platform.",
"paymentsState": "enabled"
}
],
"primaryPublicationId": 2328962,
"primaryPublicationName": "Unstack Substack",
"primaryPublicationUrl": "https://unstackit.substack.com",
"followerCount": 22342,
"subscriberCount": 8900,
"subscriberCountText": "8.9K+ subscribers",
"freeSubscribersBand": "Thousands",
"bestsellerTier": 100,
"bestsellerLabel": "Bestseller: hundreds of paid subscribers",
"contactInfo": {
"emails": [],
"phones": [],
"website": null,
"socials": {},
"paymentLinks": {},
"aggregator": null
},
"hasPosts": true,
"hasActivity": true,
"visibleSubscriptionsCount": 58,
"subscriptions": [
{
"userId": 165322060,
"id": 338851378,
"visibility": "public",
"membershipState": "subscribed",
"type": "comp",
"isFounding": false,
"publication": {
"id": 1143960,
"name": "Annie Scott's Wankery Watch",
"subdomain": "anniescott"
}
}
],
"source": {
"type": "profile",
"value": "https://substack.com/@kristikeller",
"title": "Kristi Keller 🇨🇦",
"url": "https://substack.com/@kristikeller"
},
"scrapedAt": "2026-10-11T10:20:16.338Z"
}
```
#### Publications
Subscriber count and band, paid subscriber band, plans with prices in every currency, founder and contributors, recommendations, contact links found in public bios, and analytics over the posts this run collected: averages, totals, top post, posts per week, share of paid posts, engagement rate (average reactions per subscriber) and virality (top post's reactions over the average). With `trackHistory` on, `history` adds the subscriber change since the last tracked run.
Excerpt (lists shortened; every other publication setting Substack makes public is in the full row):
```json
{
"type": "publication",
"id": 2328962,
"handle": "unstackit",
"name": "Unstack Substack",
"url": "https://unstackit.substack.com",
"customDomain": null,
"description": "I help fellow Substackers make the most of their time by unstacking all the back-end chores that come along with writing on this platform.",
"language": "en",
"logoUrl": "https://substackcdn.com/image/fetch/$s_!nr84!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F9ec83ce1-c3b2-4b6f-87d9-41902e60a69f_500x500.png",
"logoUrlWide": "https://substackcdn.com/image/fetch/$s_!4MuM!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fa5e413e0-e385-4443-bf6d-ea4b0fb57f81_1344x256.png",
"coverPhotoUrl": "https://substack-post-media.s3.amazonaws.com/public/images/d255e1f6-65ef-4009-98d3-65734976527b_1000x500.png",
"themeColor": "#ee7835",
"createdAt": "2024-02-06T18:05:06.583Z",
"firstPostAt": "2024-02-06T18:05:06.884Z",
"subscriberCount": 6000,
"subscriberCountText": "6,000",
"subscriberCountApprox": "6.5K+",
"subscriberCountVisibility": "public",
"subscribersSummary": "Thousands of subscribers",
"paidSubscribersText": "Hundreds of paid subscribers",
"paidSubscribersMagnitude": 100,
"paymentsEnabled": true,
"paymentsState": "enabled",
"paymentsStateLabel": "Paid subscriptions offered",
"plans": [
{
"id": "monthly9usd",
"name": "$9 a month",
"price": 9.0,
"currency": "USD",
"interval": "month",
"intervalCount": 1,
"active": true,
"trialDays": null,
"pricesByCurrency": {
"AUD": 13.0,
"BRL": 47.0,
"CAD": 13.0,
"CHF": 8.0
}
},
{
"id": "yearly75usd",
"name": "$75 a year",
"price": 75.0,
"currency": "USD",
"interval": "year",
"intervalCount": 1,
"active": true,
"trialDays": null,
"pricesByCurrency": {
"AUD": 110.0,
"BRL": 390.0,
"CAD": 110.0,
"CHF": 65.0
}
}
],
"foundingPlanName": "Level-Up Your Stack!",
"founderName": "Kristi Keller 🇨🇦",
"primaryAuthor": {
"id": 165322060,
"handle": "kristikeller",
"name": "Kristi Keller 🇨🇦",
"bio": "Builder of highly engaged communities, helping others create fabulous and FUNCTIONAL Substack publications, all while wearing sweatpants and basking in the comfort of my living room.",
"photoUrl": "https://substackcdn.com/image/fetch/$s_!TdHE!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F0bee1713-6b2a-45fa-bbb6-e9437756af86_316x326.png",
"twitterUrl": null
},
"contributors": [
{
"name": "Kristi Keller 🇨🇦",
"handle": "kristikeller",
"role": "admin",
"owner": true,
"userId": 165322060
}
],
"bestsellerTier": 100,
"bestsellerLabel": "Bestseller: hundreds of paid subscribers",
"supportEmail": null,
"emailFromName": "Unstack Substack",
"copyright": "Kristi Keller",
"communityEnabled": true,
"inviteOnly": false,
"explicit": false,
"homepageType": "magaziney",
"isPersonalMode": false,
"podcastEnabled": false,
"podcastTitle": null,
"podcastFeedUrl": null,
"recommendationCount": 18,
"recommendations": [
{
"id": 8000589,
"name": "Room to be Human",
"subdomain": "roomtobehuman",
"url": "https://roomtobehuman.substack.com",
"logoUrl": "https://substack-post-media.s3.amazonaws.com/public/images/a624b357-6b96-4b0d-95c9-1379fc74688a_256x256.png",
"heroText": "A quiet place to share life’s challenges and difficult emotions. Inspiration, tools, and conversations that honour the beautifully imperfect experience of being human.",
"blurb": "Sabine is a lovely human to work with and I would love to help give her Substack a boost by recommending her 😊",
"recommendedAt": "2026-04-11T16:21:00.692Z"
},
{
"id": 7200768,
"name": "HomeBody(ish) Magazine",
"subdomain": "homebodyish",
"url": "https://homebodyish.substack.com",
"logoUrl": "https://substack-post-media.s3.amazonaws.com/public/images/208233a0-120c-498b-a7ee-224c309220c6_600x600.png",
"heroText": "Definitely NOT another slow living crusade. This is the anti-hustle, pro-sweatpants magazine for people with mild social skills and loads of creativity & ambition. Step inside and shine!",
"blurb": "This is my other publication and I'd love more subscribers~!",
"recommendedAt": "2025-12-31T21:49:14.793Z"
}
],
"postsRequested": null,
"postsCollected": 147,
"archiveComplete": true,
"postsWithoutBody": 0,
"topPosts": [
{
"id": 179836383,
"slug": "no-thanks-i-dont-want-to-read-your",
"url": "https://unstackit.substack.com/p/no-thanks-i-dont-want-to-read-your",
"title": "No Thanks. I Don't Want To Read Your Substack",
"publishedAt": "2025-11-29T13:03:01.879Z",
"reactionCount": 905,
"commentCount": 214,
"restackCount": 94
},
{
"id": 143401415,
"slug": "480-substack-subscribers-in-one-month",
"url": "https://unstackit.substack.com/p/480-substack-subscribers-in-one-month",
"title": "The Simplest Thing That Brought Me 480 Subscribers In One Month",
"publishedAt": "2024-04-13T12:49:48.284Z",
"reactionCount": 715,
"commentCount": 204,
"restackCount": 72
}
],
"analytics": {
"sampleSize": 147,
"sampleDateRange": {
"from": "2024-02-06T18:05:06.884Z",
"to": "2026-10-10T12:03:24.184Z"
},
"avgReactionsPerPost": 100.1,
"avgCommentsPerPost": 44.0,
"avgRestacksPerPost": 11.0,
"avgWordCount": 434,
"totalReactions": 14722,
"totalComments": 6464,
"totalRestacks": 1619,
"topPostReactions": 905,
"topPost": {
"id": 179836383,
"slug": "no-thanks-i-dont-want-to-read-your",
"url": "https://unstackit.substack.com/p/no-thanks-i-dont-want-to-read-your",
"title": "No Thanks. I Don't Want To Read Your Substack",
"reactionCount": 905
},
"publishCadencePerWeek": 1.05,
"paidPostRatio": 0.34,
"engagementRate": 0.01669,
"viralityIndex": 9.04
},
"contactInfo": {
"emails": [],
"phones": [],
"website": null,
"socials": {},
"paymentLinks": {},
"aggregator": null
},
"history": null,
"source": {
"type": "publication",
"value": "https://unstackit.substack.com",
"title": "Unstack Substack",
"url": "https://unstackit.substack.com"
},
"scrapedAt": "2026-10-11T10:18:21.549Z"
}
```
### How much does it cost to scrape Substack?
You pay per result saved to your dataset:
| Event | Free plan | Bronze | Silver | Gold and above |
|---|---|---|---|---|
| Result: one post, Note, profile or publication | $1.99 / 1,000 | $1.79 / 1,000 | $1.69 / 1,000 | $1.39 / 1,000 |
| Comment: one comment or reply (only with comments on) | $0.59 / 1,000 | $0.55 / 1,000 | $0.49 / 1,000 | $0.39 / 1,000 |
| Actor start, once per run (per GB of run memory) | $0.005 | $0.005 | $0.005 | $0.005 |
Full text, authors, publication details and analytics are included in the result price. Examples on the Free plan:
- The quick test above, 20 posts with up to 10 comments each: 21 results, at most 200 comments: at most $0.17
- The whole archive of Lenny's Newsletter, 1,270 posts and the publication row: $2.53
- 1,000 posts from a keyword search: $2.00
Set a maximum cost per run in the run options: the run stops at that amount, keeps everything it saved and says so in the log. A run that finds nothing pays only the start. The [Pricing tab](https://apify.com/clearpath/substack-scraper/pricing) shows every charge. Free Apify plan users can run this actor; there are no extra limits beyond your plan's usage.
### FAQ
**Can I download or export all posts of a Substack newsletter?**
Yes. Enter the publication and leave `maxItemsPerSource` empty. Substack's archive list stops near 480 posts; this actor still returns every post, the oldest included, plus the standalone pages the archive hides.
**Can I export Substack posts to Markdown for AI or RAG?**
Yes. Every free post comes as `bodyMarkdown` with headings, links, lists, quotes, images and code kept, plus `bodyText` and `bodyHtml`. Subscribe boxes and share buttons are removed.
**Can I see a Substack's subscriber count and paid subscribers?**
When the publication shows it, `subscriberCount` (for example 6000) and `subscriberCountText` come on its publication row and on its posts. Substack shows paid subscribers only as a band, such as "Hundreds of paid subscribers", in `paidSubscribersText`. A publication can hide its count; its rows then say `subscriberCountVisibility: "hidden"`.
**Does it work with custom domains?**
Yes. Paste the publication's own domain, such as `https://www.lennysnewsletter.com`, or any post link on it.
**What about paid posts?**
Paid posts come with all their details (title, word count, reactions, comments count, authors) and the public preview, marked `bodyAvailable: false`. The actor does not log in and does not get past the paywall.
**Can I scrape Substack Notes and comments?**
Yes. Add a profile for its Notes feed, a Note link, or search Notes by keyword with `"searchType": "notes"`. Turn on `includeComments` for every comment and reply on each post and under each Note.
**Can I track a newsletter's growth?**
Turn on `trackHistory` and schedule the actor. Each run stores the subscriber count in your account and the publication row's `history` shows the change, growth per day and posts added since the last tracked run.
**Can I use it from Python, n8n, Make or an AI agent?**
Yes. Run it from Python or JavaScript with Apify's client libraries, connect it to Make, Zapier or n8n, or let an AI assistant run it through Apify's MCP server. The block above describes the inputs for agents.
**Why did my run return fewer results than I expected?**
Check the log. It names any publication, profile, post or link Substack did not recognize, links that are not Substack links, sources that could not be completed this time, and when the run stopped at your maximum cost. Date windows, post types, the free or paid filter and limits also narrow the results, and a result found by two inputs is saved once.
**How fresh is the data?**
Every run collects what Substack shows at that moment, including reactions and comments. Schedule the actor to keep a dataset current.
**Is it legal to scrape Substack?**
The actor collects what Substack shows to any logged-out visitor. How you use it is your responsibility: respect writers' copyright, Substack's terms and data protection law for personal details such as profiles and comments.
### Support
Questions, a missing field or a run that did not return what you expected: open an issue in the **Issues** tab or email **max@mapa.slmail.me**. Reports with the run ID get answered fastest. Substack is a trademark of Substack Inc. This actor is independent and is not affiliated with or endorsed by Substack.
# Actor input Schema
## `startUrls` (type: `array`):
Any Substack link: a publication (`https://name.substack.com` or its own domain such as `https://www.lennysnewsletter.com`), a section (`/s/...`) or tag page (`/t/...`), a post (`/p/...`), a profile (`https://substack.com/@handle`), a Note (`https://substack.com/@handle/note/c-123`) or a search page (`https://substack.com/search/...`). Up to 1,000 links, publications, profiles and keywords per run, all fields together.
## `publications` (type: `array`):
Publication handles (`unstackit`) or domains (`www.lennysnewsletter.com`). Collects the whole archive, newest first, including the standalone pages Substack's archive list leaves out.
## `profiles` (type: `array`):
Substack handles (`kristikeller` or `@kristikeller`). Returns the profile and, with Notes on, their Notes feed: Notes, restacks and shared posts.
## `searchQueries` (type: `array`):
Words to search Substack for, one search per line, e.g. `artificial intelligence`. Each keyword returns every match Substack's search reaches, best matches first; for posts that goes past the roughly 2,000 its own post search shows.
## `searchType` (type: `string`):
What the search keywords look for: posts (with full text), Notes, publications (with subscriber counts and plans) or people (profiles).
## `maxItemsPerSource` (type: `integer`):
Stop each source after this many posts, Notes, publications or people. Leave empty to collect everything each one has.
## `maxItems` (type: `integer`):
Stop the whole run after this many results of any kind. Leave empty for no total limit.
## `publishedAfter` (type: `string`):
Only posts and Notes published on or after this date (UTC). Leave empty for no lower bound.
## `publishedBefore` (type: `string`):
Only posts and Notes published before this date (UTC). Leave empty for no upper bound.
## `postTypes` (type: `array`):
Only these kinds of posts. Leave empty for all of them.
## `audience` (type: `string`):
Only free or only paid posts. Leave empty for both. Paid posts come with the preview every visitor sees.
## `searchDateRange` (type: `string`):
Keyword searches for posts and Notes: limit results to this recent period. Leave empty for all time.
## `searchLanguage` (type: `string`):
Keyword searches for posts and Notes: only results in this language. Leave empty for any language.
## `includeContent` (type: `boolean`):
Adds each post's text as HTML, plain text and Markdown, and its full details. Paid posts come with the preview every visitor sees, marked `bodyAvailable: false`. Turn off for faster runs with metadata only.
## `includeComments` (type: `boolean`):
Adds every comment and reply on each post (and replies under each Note) as its own row, linked by `postId` or `noteId` and `parentId`. Comments are billed per comment.
## `maxCommentsPerPost` (type: `integer`):
With comments on, keep at most this many per post or Note, replies included, in Substack's order (best first, each followed by its replies). Leave empty for all of them.
## `includeNotes` (type: `boolean`):
For each profile, adds their Notes feed: their Notes, restacks and shared posts, newest first.
## `includePublicationDetails` (type: `boolean`):
Adds one row per publication: subscriber count, paid subscriber band, plans and prices, founder, contributors, recommendations, contact links and analytics over the posts collected (averages, cadence, top posts).
## `trackHistory` (type: `boolean`):
Remembers each publication's subscriber count in your account and adds the change since the last run that tracked it (growth per day, posts added). Useful on a schedule.
## `feedback` (type: `string`):
For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns.
## Actor input object example
```json
{
"startUrls": [
"https://www.lennysnewsletter.com"
],
"searchType": "posts",
"maxItemsPerSource": 50,
"includeContent": true,
"includeComments": false,
"maxCommentsPerPost": 100,
"includeNotes": true,
"includePublicationDetails": true,
"trackHistory": false
}
```
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '