Substack

Get Substack note

Get a Substack note by id.

GET/v1/substack/notes/{noteId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
noteIdstringrequiredpath

A note id as Substack displays it, e.g. `378007586`.

Response fields
59

Endpoint-specific response payload.

datalookupStatus
string

Whether the note was found.

one of: found, not_found

The note when `lookupStatus` is `found`; otherwise null.

datanoteid
integer

Numeric note id.

datanotebody
stringnullable

The note's plain text.

datanotebodyJson
objectnullable

The note's rich text document, when there is one.

datanotecreatedAt
stringnullable

ISO 8601 timestamp, or null when Substack does not publish one.

datanoteeditedAt
stringnullable

ISO 8601 timestamp, or null when Substack does not publish one.

The note's author.

datanoteauthorid
integernullable

Numeric user id.

datanoteauthorname
stringnullable

The name shown for the author.

datanoteauthorhandle
stringnullable

The author's handle.

datanoteauthorslug
stringnullable

The author's profile slug.

datanoteauthorbio
stringnullable

The author's short biography.

datanoteauthorphotoUrl
stringnullable

The author's profile photo URL.

The author's main badge, when there is one.

datanoteauthorbadgetype
stringnullable

The kind of badge, such as `bestseller`.

datanoteauthorbadgetier
integernullable

The badge tier, when it has one.

datanoteauthorbadgehandle
stringnullable

The handle the badge belongs to.

datanoteauthorbadgeservice
stringnullable

The service the badge comes from.

datanoteauthorbadgeurl
stringnullable

A link for the badge, when it has one.

datanoteauthorbadges
objectnullable

The author's reader status fields, when available.

datanoteauthorbestsellerTier
integernullable

The author's bestseller tier.

The author's primary publication, when there is one.

datanoteauthorprimaryPublicationid
integernullable

Numeric publication id.

datanoteauthorprimaryPublicationname
stringnullable

The publication's name.

datanoteauthorprimaryPublicationsubdomain
stringnullable

The publication's Substack subdomain.

datanoteauthorprimaryPublicationcustomDomain
stringnullable

The publication's custom domain, when it has one.

datanoteauthorprimaryPublicationlogoUrl
stringnullable

The publication's logo URL.

datanotereactionCount
integernullable

The number of reactions.

datanotereactions
object

Emoji to reaction count.

datanoterestackCount
integernullable

The number of restacks.

datanotereplyCount
integernullable

The number of replies.

datanotelanguage
stringnullable

The note's language code.

datanoteisAiGenerated
booleannullable

Substack's own flag.

datanotetranslation
objectnullable

A translation of the note, when there is one.

datanotereplyPermission
stringnullable

Who may reply to the note.

datanoteancestorPath
stringnullable

The note's position in a thread.

Images, links, posts or polls attached to the note.

datanoteattachments[]id
stringnullable

The attachment's id.

datanoteattachments[]type
stringnullable

`image`, `link`, `post`, `poll` or `missing`.

datanoteattachments[]imageUrl
stringnullable

The image URL, for an image attachment.

datanoteattachments[]imageWidth
integernullable

The image width in pixels.

datanoteattachments[]imageHeight
integernullable

The image height in pixels.

datanoteattachments[]explicit
booleannullable

Whether the attachment is explicit.

Preview metadata for a link attachment.

datanoteattachments[]linkurl
stringnullable

The link's URL.

datanoteattachments[]linkhost
stringnullable

The link's host.

datanoteattachments[]linktitle
stringnullable

The link's title.

datanoteattachments[]linkdescription
stringnullable

The link's description.

datanoteattachments[]linkimage
stringnullable

The link's preview image URL.

datanoteattachments[]linkoriginalImage
stringnullable

The link's original image URL.

datanoteattachments[]postId
integernullable

The attached post's id.

datanoteattachments[]publicationId
integernullable

The attached publication's id.

datanoteattachments[]reason
stringnullable

Why a missing attachment was removed.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/substack/notes/378007586" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Substack note.