List Substack post comments
Get the whole nested comment tree of a Substack post.
Headers
Get your API keyAPI key (`sfk_...`)
A post: its numeric id (`223208969`) or its URL (`https://www.astralcodexten.com/p/...`). Post comments need the URL form.
min 1 chars · max 2000 chars
Comment order. The whole tree is returned either way.
one of: best, oldest, newest
Endpoint-specific response payload.
Whether the post was found.
one of: found, not_found, restricted
Why the post is restricted, when it is.
one of: invite_only, flagged, paid, null
Numeric post id.
Top-level comments, with replies nested under each one.
Numeric comment id.
Numeric post id.
Numeric publication id.
The comment's plain text.
The comment's rich text document, when there is one.
ISO 8601 timestamp, or null when Substack does not publish one.
ISO 8601 timestamp, or null when Substack does not publish one.
The comment's author.
Numeric user id.
The name shown for the author.
The author's handle.
The author's profile slug.
The author's short biography.
The author's profile photo URL.
The author's main badge, when there is one.
The kind of badge, such as `bestseller`.
The badge tier, when it has one.
The handle the badge belongs to.
The service the badge comes from.
A link for the badge, when it has one.
The author's reader status fields, when available.
The author's bestseller tier.
The author's primary publication, when there is one.
Numeric publication id.
The publication's name.
The publication's Substack subdomain.
The publication's custom domain, when it has one.
The publication's logo URL.
The number of reactions.
Emoji to reaction count.
The number of restacks.
The number of direct replies.
The comment's position in the tree.
Whether the comment was deleted.
Whether the comment is pinned.
Names of people who reacted, when listed.
Images, links, posts or polls attached to the comment.
The attachment's id.
`image`, `link`, `post`, `poll` or `missing`.
The image URL, for an image attachment.
The image width in pixels.
The image height in pixels.
Whether the attachment is explicit.
Preview metadata for a link attachment.
The link's URL.
The link's host.
The link's title.
The link's description.
The link's preview image URL.
The link's original image URL.
The attached post's id.
The attached publication's id.
Why a missing attachment was removed.
Nested replies, when the comment has any.
True when the post is paid and its comments are not public.
The number of comment nodes returned.
≥ 0
True when more than 5000 comment nodes were present and the list was cut.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/substack/posts/https%3A%2F%2Fwww.astralcodexten.com%2Fp%2Fopen-thread-400/comments" \
-H "x-api-key: YOUR_API_KEY"Responses
Substack comments.