List Substack note replies List the reply branches and comments of a Substack note.
GET /v1/substack/notes/{noteId}/replies
x-api-key* string header
API key (`sfk_...`)
noteId* string required path
A note id as Substack displays it, e.g. `378007586`.
Response fields 168 Expand all Collapse all Collapse all Endpoint-specific response payload.
Whether the note was found.
data . noteId
integer nullable
Numeric note id.
The note the replies belong to.
data . root . body
string nullable
The note's plain text.
data . root . bodyJson
object nullable
The note's rich text document, when there is one.
data . root . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . root . editedAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . root . author . id
integer nullable
Numeric user id.
data . root . author . name
string nullable
The name shown for the author.
data . root . author . handle
string nullable
The author's handle.
data . root . author . slug
string nullable
The author's profile slug.
data . root . author . bio
string nullable
The author's short biography.
data . root . author . photoUrl
string nullable
The author's profile photo URL.
The author's main badge, when there is one.
data . root . author . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . root . author . badge . tier
integer nullable
The badge tier, when it has one.
data . root . author . badge . handle
string nullable
The handle the badge belongs to.
data . root . author . badge . service
string nullable
The service the badge comes from.
data . root . author . badge . url
string nullable
A link for the badge, when it has one.
data . root . author . badges
object nullable
The author's reader status fields, when available.
data . root . author . bestsellerTier
integer nullable
The author's bestseller tier.
data . root . author . primaryPublication object nullable
The author's primary publication, when there is one.
data . root . author . primaryPublication . id
integer nullable
Numeric publication id.
data . root . author . primaryPublication . name
string nullable
The publication's name.
data . root . author . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . root . author . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . root . author . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . root . reactionCount
integer nullable
The number of reactions.
data . root . reactions
object
Emoji to reaction count.
data . root . restackCount
integer nullable
The number of restacks.
data . root . replyCount
integer nullable
The number of replies.
data . root . language
string nullable
The note's language code.
data . root . isAiGenerated
boolean nullable
Substack's own flag.
data . root . translation
object nullable
A translation of the note, when there is one.
data . root . replyPermission
string nullable
Who may reply to the note.
data . root . ancestorPath
string nullable
The note's position in a thread.
Images, links, posts or polls attached to the note.
data . root . attachments [] . id
string nullable
The attachment's id.
data . root . attachments [] . type
string nullable
`image`, `link`, `post`, `poll` or `missing`.
data . root . attachments [] . imageUrl
string nullable
The image URL, for an image attachment.
data . root . attachments [] . imageWidth
integer nullable
The image width in pixels.
data . root . attachments [] . imageHeight
integer nullable
The image height in pixels.
data . root . attachments [] . explicit
boolean nullable
Whether the attachment is explicit.
data . root . attachments [] . link object nullable
Preview metadata for a link attachment.
data . root . attachments [] . link . url
string nullable
The link's URL.
data . root . attachments [] . link . host
string nullable
The link's host.
data . root . attachments [] . link . title
string nullable
The link's title.
data . root . attachments [] . link . description
string nullable
The link's description.
data . root . attachments [] . link . image
string nullable
The link's preview image URL.
data . root . attachments [] . link . originalImage
string nullable
The link's original image URL.
data . root . attachments [] . postId
integer nullable
The attached post's id.
data . root . attachments [] . publicationId
integer nullable
The attached publication's id.
data . root . attachments [] . reason
string nullable
Why a missing attachment was removed.
The reply branches under the note.
The first reply in the branch.
data . replies [] . comment . id
integer
Numeric note id.
data . replies [] . comment . body
string nullable
The note's plain text.
data . replies [] . comment . bodyJson
object nullable
The note's rich text document, when there is one.
data . replies [] . comment . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . replies [] . comment . editedAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . replies [] . comment . author object
The note's author.
data . replies [] . comment . author . id
integer nullable
Numeric user id.
data . replies [] . comment . author . name
string nullable
The name shown for the author.
data . replies [] . comment . author . handle
string nullable
The author's handle.
data . replies [] . comment . author . slug
string nullable
The author's profile slug.
data . replies [] . comment . author . bio
string nullable
The author's short biography.
data . replies [] . comment . author . photoUrl
string nullable
The author's profile photo URL.
data . replies [] . comment . author . badge object nullable
The author's main badge, when there is one.
data . replies [] . comment . author . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . replies [] . comment . author . badge . tier
integer nullable
The badge tier, when it has one.
data . replies [] . comment . author . badge . handle
string nullable
The handle the badge belongs to.
data . replies [] . comment . author . badge . service
string nullable
The service the badge comes from.
data . replies [] . comment . author . badge . url
string nullable
A link for the badge, when it has one.
data . replies [] . comment . author . badges
object nullable
The author's reader status fields, when available.
data . replies [] . comment . author . bestsellerTier
integer nullable
The author's bestseller tier.
data . replies [] . comment . author . primaryPublication object nullable
The author's primary publication, when there is one.
data . replies [] . comment . author . primaryPublication . id
integer nullable
Numeric publication id.
data . replies [] . comment . author . primaryPublication . name
string nullable
The publication's name.
data . replies [] . comment . author . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . replies [] . comment . author . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . replies [] . comment . author . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . replies [] . comment . reactionCount
integer nullable
The number of reactions.
data . replies [] . comment . reactions
object
Emoji to reaction count.
data . replies [] . comment . restackCount
integer nullable
The number of restacks.
data . replies [] . comment . replyCount
integer nullable
The number of replies.
data . replies [] . comment . language
string nullable
The note's language code.
data . replies [] . comment . isAiGenerated
boolean nullable
Substack's own flag.
data . replies [] . comment . translation
object nullable
A translation of the note, when there is one.
data . replies [] . comment . replyPermission
string nullable
Who may reply to the note.
data . replies [] . comment . ancestorPath
string nullable
The note's position in a thread.
data . replies [] . comment . attachments array
Images, links, posts or polls attached to the note.
data . replies [] . comment . attachments [] . id
string nullable
The attachment's id.
data . replies [] . comment . attachments [] . type
string nullable
`image`, `link`, `post`, `poll` or `missing`.
data . replies [] . comment . attachments [] . imageUrl
string nullable
The image URL, for an image attachment.
data . replies [] . comment . attachments [] . imageWidth
integer nullable
The image width in pixels.
data . replies [] . comment . attachments [] . imageHeight
integer nullable
The image height in pixels.
data . replies [] . comment . attachments [] . explicit
boolean nullable
Whether the attachment is explicit.
data . replies [] . comment . attachments [] . link object nullable
Preview metadata for a link attachment.
data . replies [] . comment . attachments [] . link . url
string nullable
The link's URL.
data . replies [] . comment . attachments [] . link . host
string nullable
The link's host.
data . replies [] . comment . attachments [] . link . title
string nullable
The link's title.
data . replies [] . comment . attachments [] . link . description
string nullable
The link's description.
data . replies [] . comment . attachments [] . link . image
string nullable
The link's preview image URL.
data . replies [] . comment . attachments [] . link . originalImage
string nullable
The link's original image URL.
data . replies [] . comment . attachments [] . postId
integer nullable
The attached post's id.
data . replies [] . comment . attachments [] . publicationId
integer nullable
The attached publication's id.
data . replies [] . comment . attachments [] . reason
string nullable
Why a missing attachment was removed.
data . replies [] . descendantComments array
Replies under the first reply.
data . replies [] . descendantComments [] . id
integer
Numeric note id.
data . replies [] . descendantComments [] . body
string nullable
The note's plain text.
data . replies [] . descendantComments [] . bodyJson
object nullable
The note's rich text document, when there is one.
data . replies [] . descendantComments [] . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . replies [] . descendantComments [] . editedAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . replies [] . descendantComments [] . author object
The note's author.
data . replies [] . descendantComments [] . author . id
integer nullable
Numeric user id.
data . replies [] . descendantComments [] . author . name
string nullable
The name shown for the author.
data . replies [] . descendantComments [] . author . handle
string nullable
The author's handle.
data . replies [] . descendantComments [] . author . slug
string nullable
The author's profile slug.
data . replies [] . descendantComments [] . author . bio
string nullable
The author's short biography.
data . replies [] . descendantComments [] . author . photoUrl
string nullable
The author's profile photo URL.
data . replies [] . descendantComments [] . author . badge object nullable
The author's main badge, when there is one.
data . replies [] . descendantComments [] . author . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . replies [] . descendantComments [] . author . badge . tier
integer nullable
The badge tier, when it has one.
data . replies [] . descendantComments [] . author . badge . handle
string nullable
The handle the badge belongs to.
data . replies [] . descendantComments [] . author . badge . service
string nullable
The service the badge comes from.
data . replies [] . descendantComments [] . author . badge . url
string nullable
A link for the badge, when it has one.
data . replies [] . descendantComments [] . author . badges
object nullable
The author's reader status fields, when available.
data . replies [] . descendantComments [] . author . bestsellerTier
integer nullable
The author's bestseller tier.
data . replies [] . descendantComments [] . author . primaryPublication object nullable
The author's primary publication, when there is one.
data . replies [] . descendantComments [] . author . primaryPublication . id
integer nullable
Numeric publication id.
data . replies [] . descendantComments [] . author . primaryPublication . name
string nullable
The publication's name.
data . replies [] . descendantComments [] . author . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . replies [] . descendantComments [] . author . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . replies [] . descendantComments [] . author . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . replies [] . descendantComments [] . reactionCount
integer nullable
The number of reactions.
data . replies [] . descendantComments [] . reactions
object
Emoji to reaction count.
data . replies [] . descendantComments [] . restackCount
integer nullable
The number of restacks.
data . replies [] . descendantComments [] . replyCount
integer nullable
The number of replies.
data . replies [] . descendantComments [] . language
string nullable
The note's language code.
data . replies [] . descendantComments [] . isAiGenerated
boolean nullable
Substack's own flag.
data . replies [] . descendantComments [] . translation
object nullable
A translation of the note, when there is one.
data . replies [] . descendantComments [] . replyPermission
string nullable
Who may reply to the note.
data . replies [] . descendantComments [] . ancestorPath
string nullable
The note's position in a thread.
data . replies [] . descendantComments [] . attachments array
Images, links, posts or polls attached to the note.
data . replies [] . descendantComments [] . attachments [] . id
string nullable
The attachment's id.
data . replies [] . descendantComments [] . attachments [] . type
string nullable
`image`, `link`, `post`, `poll` or `missing`.
data . replies [] . descendantComments [] . attachments [] . imageUrl
string nullable
The image URL, for an image attachment.
data . replies [] . descendantComments [] . attachments [] . imageWidth
integer nullable
The image width in pixels.
data . replies [] . descendantComments [] . attachments [] . imageHeight
integer nullable
The image height in pixels.
data . replies [] . descendantComments [] . attachments [] . explicit
boolean nullable
Whether the attachment is explicit.
data . replies [] . descendantComments [] . attachments [] . link object nullable
Preview metadata for a link attachment.
data . replies [] . descendantComments [] . attachments [] . link . url
string nullable
The link's URL.
data . replies [] . descendantComments [] . attachments [] . link . host
string nullable
The link's host.
data . replies [] . descendantComments [] . attachments [] . link . title
string nullable
The link's title.
data . replies [] . descendantComments [] . attachments [] . link . description
string nullable
The link's description.
data . replies [] . descendantComments [] . attachments [] . link . image
string nullable
The link's preview image URL.
data . replies [] . descendantComments [] . attachments [] . link . originalImage
string nullable
The link's original image URL.
data . replies [] . descendantComments [] . attachments [] . postId
integer nullable
The attached post's id.
data . replies [] . descendantComments [] . attachments [] . publicationId
integer nullable
The attached publication's id.
data . replies [] . descendantComments [] . attachments [] . reason
string nullable
Why a missing attachment was removed.
Reply branches not included in this response.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
meta . creditsCharged
integer
Credits charged for this request.
Public API version that served the response.