Substack

List Substack note restacks

List the notes that restacked a Substack note.

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

API key (`sfk_...`)

Parameters
2
noteIdstringrequiredpath

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

cursorstringoptionalquery

Opaque cursor from the previous page's `nextCursor`.

max 4096 chars

Response fields
742

Endpoint-specific response payload.

datalookupStatus
string

Whether the note was found.

one of: found, not_found

datanoteId
integernullable

Numeric note id.

Notes that restacked this note.

datarestacks[]type
stringnullable

`post`, `comment`/note, or `profileSearchResults`.

datarestacks[]id
stringnullable

Substack's entity key, e.g. `p-123` or `c-456`.

The post, when the item is a post.

datarestacks[]postid
integer

Numeric post id.

datarestacks[]postpublicationId
integernullable

Numeric publication id.

datarestacks[]postslug
stringnullable

The post's URL slug.

datarestacks[]posttitle
stringnullable

The post's title.

datarestacks[]postsubtitle
stringnullable

The post's subtitle.

datarestacks[]postdescription
stringnullable

The post's short description.

datarestacks[]postkind
stringnullable

`newsletter`, `podcast`, `video` or `restack`.

datarestacks[]postaudience
stringnullable

`everyone`, `only_paid`, `only_subscribers` or another value Substack uses.

datarestacks[]postisPaywalled
booleannullable

Whether the post is paid.

datarestacks[]posturl
stringnullable

Canonical post URL.

datarestacks[]postpublishedAt
stringnullable

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

datarestacks[]postupdatedAt
stringnullable

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

datarestacks[]postlanguage
stringnullable

The post's language code.

datarestacks[]postbodyHtml
stringnullable

Full body HTML for a free post; the preview only when `bodyIsPreview` is true.

datarestacks[]postbodyIsPreview
boolean

True when the audience is not `everyone`.

datarestacks[]postpreviewText
stringnullable

The public preview text.

datarestacks[]postwordCount
integernullable

The post's word count.

datarestacks[]postcommentCount
integernullable

The number of comments on the post.

datarestacks[]postreplyCount
integernullable

Replies to comments on the post.

datarestacks[]postreactionCount
integernullable

The number of reactions to the post.

datarestacks[]postreactions
object

Emoji to reaction count.

datarestacks[]postrestackCount
integernullable

The number of restacks.

datarestacks[]postcommentPermission
stringnullable

Who may comment on the post.

datarestacks[]postcoverImageUrl
stringnullable

The post's cover image URL.

datarestacks[]postcoverImageIsSquare
booleannullable

Whether the cover image is square.

datarestacks[]postcoverImageIsExplicit
booleannullable

Whether the cover image is explicit.

datarestacks[]postisGeoblocked
booleannullable

Whether the post is geoblocked.

Countries where the post is blocked.

datarestacks[]postblockedCountries[]
stringoptional
datarestacks[]postliveStreamId
stringnullable

The live stream id, when the post is a live stream.

datarestacks[]postisPublished
booleannullable

Whether the post is published.

datarestacks[]postisPinned
booleannullable

Whether the post is pinned.

datarestacks[]postseoTitle
stringnullable

The title shown to search engines.

datarestacks[]postseoDescription
stringnullable

The description shown to search engines.

datarestacks[]postsocialTitle
stringnullable

The title used for social previews.

datarestacks[]postpreviousSlug
stringnullable

The previous post's slug.

datarestacks[]postnextSlug
stringnullable

The next post's slug.

The section the post belongs to.

datarestacks[]postsectionid
integernullable

Numeric section id.

datarestacks[]postsectionname
stringnullable

The section's name.

datarestacks[]postsectionslug
stringnullable

The section's URL slug.

The post's tags.

datarestacks[]posttags[]id
integernullable

Numeric tag id.

datarestacks[]posttags[]name
stringnullable

The tag's name.

datarestacks[]posttags[]slug
stringnullable

The tag's URL slug.

datarestacks[]posttags[]hidden
booleannullable

Whether the tag is hidden.

The post's authors.

datarestacks[]postauthors[]id
integernullable

Numeric user id.

datarestacks[]postauthors[]name
stringnullable

The name shown for the author.

datarestacks[]postauthors[]handle
stringnullable

The author's handle.

datarestacks[]postauthors[]slug
stringnullable

The author's profile slug.

datarestacks[]postauthors[]bio
stringnullable

The author's short biography.

datarestacks[]postauthors[]photoUrl
stringnullable

The author's profile photo URL.

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

datarestacks[]postauthors[]badgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]postauthors[]badgetier
integernullable

The badge tier, when it has one.

datarestacks[]postauthors[]badgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]postauthors[]badgeservice
stringnullable

The service the badge comes from.

datarestacks[]postauthors[]badgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]postauthors[]badges
objectnullable

The author's reader status fields, when available.

datarestacks[]postauthors[]bestsellerTier
integernullable

The author's bestseller tier.

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

datarestacks[]postauthors[]primaryPublicationid
integernullable

Numeric publication id.

datarestacks[]postauthors[]primaryPublicationname
stringnullable

The publication's name.

datarestacks[]postauthors[]primaryPublicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]postauthors[]primaryPublicationcustomDomain
stringnullable

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

datarestacks[]postauthors[]primaryPublicationlogoUrl
stringnullable

The publication's logo URL.

Podcast metadata, when the post is an episode.

datarestacks[]postpodcastepisodeNumber
integernullable

The episode number.

datarestacks[]postpodcastseasonNumber
integernullable

The season number.

datarestacks[]postpodcastepisodeType
stringnullable

The episode type.

Audio, when the post has any.

datarestacks[]postaudiourl
stringnullable

Audio file URL.

datarestacks[]postaudiodurationSeconds
numbernullable

Audio length in seconds.

datarestacks[]postaudiofileSizeBytes
integernullable

Audio file size in bytes.

datarestacks[]postaudiomediaType
stringnullable

The upload's media label, such as `audio`.

datarestacks[]postaudioepisodeImageUrl
stringnullable

Artwork for the episode.

Generated or uploaded audio items.

datarestacks[]postaudioitems[]postId
integernullable

Numeric post id.

datarestacks[]postaudioitems[]voiceId
stringnullable

The voice used for generated audio.

datarestacks[]postaudioitems[]audioUrl
stringnullable

The audio file URL.

datarestacks[]postaudioitems[]type
stringnullable

`tts` or Substack's own audio type.

datarestacks[]postaudioitems[]status
stringnullable

The audio item's status.

Video, when the post has any.

datarestacks[]postvideodurationSeconds
numbernullable

Video length in seconds.

datarestacks[]postvideowidth
integernullable

Video width in pixels.

datarestacks[]postvideoheight
integernullable

Video height in pixels.

datarestacks[]postvideoplaybackId
stringnullable

The playback id of the hosted video stream.

datarestacks[]postvideoisMux
booleannullable

Whether the video uses Substack's hosted player.

The note, when the item is a note.

datarestacks[]noteid
integer

Numeric note id.

datarestacks[]notebody
stringnullable

The note's plain text.

datarestacks[]notebodyJson
objectnullable

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

datarestacks[]notecreatedAt
stringnullable

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

datarestacks[]noteeditedAt
stringnullable

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

The note's author.

datarestacks[]noteauthorid
integernullable

Numeric user id.

datarestacks[]noteauthorname
stringnullable

The name shown for the author.

datarestacks[]noteauthorhandle
stringnullable

The author's handle.

datarestacks[]noteauthorslug
stringnullable

The author's profile slug.

datarestacks[]noteauthorbio
stringnullable

The author's short biography.

datarestacks[]noteauthorphotoUrl
stringnullable

The author's profile photo URL.

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

datarestacks[]noteauthorbadgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]noteauthorbadgetier
integernullable

The badge tier, when it has one.

datarestacks[]noteauthorbadgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]noteauthorbadgeservice
stringnullable

The service the badge comes from.

datarestacks[]noteauthorbadgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]noteauthorbadges
objectnullable

The author's reader status fields, when available.

datarestacks[]noteauthorbestsellerTier
integernullable

The author's bestseller tier.

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

datarestacks[]noteauthorprimaryPublicationid
integernullable

Numeric publication id.

datarestacks[]noteauthorprimaryPublicationname
stringnullable

The publication's name.

datarestacks[]noteauthorprimaryPublicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]noteauthorprimaryPublicationcustomDomain
stringnullable

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

datarestacks[]noteauthorprimaryPublicationlogoUrl
stringnullable

The publication's logo URL.

datarestacks[]notereactionCount
integernullable

The number of reactions.

datarestacks[]notereactions
object

Emoji to reaction count.

datarestacks[]noterestackCount
integernullable

The number of restacks.

datarestacks[]notereplyCount
integernullable

The number of replies.

datarestacks[]notelanguage
stringnullable

The note's language code.

datarestacks[]noteisAiGenerated
booleannullable

Substack's own flag.

datarestacks[]notetranslation
objectnullable

A translation of the note, when there is one.

datarestacks[]notereplyPermission
stringnullable

Who may reply to the note.

datarestacks[]noteancestorPath
stringnullable

The note's position in a thread.

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

datarestacks[]noteattachments[]id
stringnullable

The attachment's id.

datarestacks[]noteattachments[]type
stringnullable

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

datarestacks[]noteattachments[]imageUrl
stringnullable

The image URL, for an image attachment.

datarestacks[]noteattachments[]imageWidth
integernullable

The image width in pixels.

datarestacks[]noteattachments[]imageHeight
integernullable

The image height in pixels.

datarestacks[]noteattachments[]explicit
booleannullable

Whether the attachment is explicit.

Preview metadata for a link attachment.

datarestacks[]noteattachments[]linkurl
stringnullable

The link's URL.

datarestacks[]noteattachments[]linkhost
stringnullable

The link's host.

datarestacks[]noteattachments[]linktitle
stringnullable

The link's title.

datarestacks[]noteattachments[]linkdescription
stringnullable

The link's description.

datarestacks[]noteattachments[]linkimage
stringnullable

The link's preview image URL.

datarestacks[]noteattachments[]linkoriginalImage
stringnullable

The link's original image URL.

datarestacks[]noteattachments[]postId
integernullable

The attached post's id.

datarestacks[]noteattachments[]publicationId
integernullable

The attached publication's id.

datarestacks[]noteattachments[]reason
stringnullable

Why a missing attachment was removed.

The publication behind the item.

datarestacks[]publicationid
integer

Numeric publication id.

datarestacks[]publicationname
stringnullable

The publication's name.

datarestacks[]publicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]publicationcustomDomain
stringnullable

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

datarestacks[]publicationapexDomain
stringnullable

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

datarestacks[]publicationurl
stringnullable

The publication's canonical base URL.

datarestacks[]publicationhost
stringnullable

The host its pages are served from.

datarestacks[]publicationdescription
stringnullable

The publication's description.

datarestacks[]publicationlanguage
stringnullable

The publication's language code.

datarestacks[]publicationkind
stringnullable

`newsletter`, `podcast` or Substack's own type.

datarestacks[]publicationcreatedAt
stringnullable

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

datarestacks[]publicationfirstPostAt
stringnullable

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

datarestacks[]publicationhasPosts
booleannullable

Whether the publication has posts.

datarestacks[]publicationisExplicit
booleannullable

Whether the publication is marked explicit.

datarestacks[]publicationisInviteOnly
booleannullable

Whether the publication is invite-only.

datarestacks[]publicationisFlagged
booleannullable

Whether the publication is flagged.

datarestacks[]publicationnoIndex
booleannullable

Whether search engines are asked not to index it.

datarestacks[]publicationisOnSubstack
booleannullable

Whether the publication is hosted by Substack.

datarestacks[]publicationcommentsEnabled
booleannullable

Whether comments are enabled.

datarestacks[]publicationnotesEnabled
booleannullable

Whether Notes are enabled.

datarestacks[]publicationdefaultCommentSort
stringnullable

The default comment order.

datarestacks[]publicationannualDisabled
booleannullable

Whether annual plans are disabled.

datarestacks[]publicationmonthlyDisabled
booleannullable

Whether monthly plans are disabled.

datarestacks[]publicationpaymentsState
stringnullable

The publication's payments state.

datarestacks[]publicationfreeTrialEnabled
booleannullable

Whether a free trial is offered.

datarestacks[]publicationpausedUntil
stringnullable

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

datarestacks[]publicationemailBannerUrl
stringnullable

The email banner image URL.

datarestacks[]publicationcopyright
stringnullable

The copyright line the publication prints.

datarestacks[]publicationlogoUrl
stringnullable

The publication's logo URL.

datarestacks[]publicationwideLogoUrl
stringnullable

The publication's wide logo URL.

datarestacks[]publicationcoverImageUrl
stringnullable

The publication's cover image URL.

datarestacks[]publicationfoundingPlanName
stringnullable

The name of the founding-member plan.

datarestacks[]publicationhasRecommendations
booleannullable

Whether the publication recommends others.

The benefit lists for each subscription tier.

Benefits for free subscribers.

datarestacks[]publicationbenefitsfree[]
stringoptional

Benefits for paid subscribers.

datarestacks[]publicationbenefitspaid[]
stringoptional

Benefits for founding members.

datarestacks[]publicationbenefitsfounding[]
stringoptional

The publication's main author.

datarestacks[]publicationauthorid
integernullable

Numeric user id.

datarestacks[]publicationauthorname
stringnullable

The name shown for the author.

datarestacks[]publicationauthorhandle
stringnullable

The author's handle.

datarestacks[]publicationauthorslug
stringnullable

The author's profile slug.

datarestacks[]publicationauthorbio
stringnullable

The author's short biography.

datarestacks[]publicationauthorphotoUrl
stringnullable

The author's profile photo URL.

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

datarestacks[]publicationauthorbadgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]publicationauthorbadgetier
integernullable

The badge tier, when it has one.

datarestacks[]publicationauthorbadgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]publicationauthorbadgeservice
stringnullable

The service the badge comes from.

datarestacks[]publicationauthorbadgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]publicationauthorbadges
objectnullable

The author's reader status fields, when available.

datarestacks[]publicationauthorbestsellerTier
integernullable

The author's bestseller tier.

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

datarestacks[]publicationauthorprimaryPublicationid
integernullable

Numeric publication id.

datarestacks[]publicationauthorprimaryPublicationname
stringnullable

The publication's name.

datarestacks[]publicationauthorprimaryPublicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]publicationauthorprimaryPublicationcustomDomain
stringnullable

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

datarestacks[]publicationauthorprimaryPublicationlogoUrl
stringnullable

The publication's logo URL.

Approximate audience figures the publication prints. These are bands, not counts.

datarestacks[]publicationaudiencepaidLabel
stringnullable

The band Substack displays for paid subscribers.

datarestacks[]publicationaudiencepaidOrderOfMagnitude
integernullable

The order of magnitude behind the paid band.

datarestacks[]publicationaudiencetotalLabel
stringnullable

The band Substack displays for all subscribers.

datarestacks[]publicationaudiencetotalOrderOfMagnitude
integernullable

The order of magnitude behind the total band.

datarestacks[]publicationaudiencefreeLabel
stringnullable

The band Substack displays for free subscribers.

datarestacks[]publicationaudiencefreeShort
stringnullable

The short free-subscriber band.

datarestacks[]publicationaudiencechatMembersLabel
stringnullable

The band Substack displays for chat members.

People with a byline on the publication.

datarestacks[]publicationcontributors[]id
integernullable

Numeric user id.

datarestacks[]publicationcontributors[]name
stringnullable

The contributor's name.

datarestacks[]publicationcontributors[]handle
stringnullable

The contributor's handle.

datarestacks[]publicationcontributors[]role
stringnullable

The contributor's role on the publication.

datarestacks[]publicationcontributors[]owner
booleannullable

Whether the contributor owns the publication.

datarestacks[]publicationcontributors[]photoUrl
stringnullable

The contributor's photo URL.

datarestacks[]publicationcontributors[]bio
stringnullable

The contributor's short biography.

The contributor's badge.

datarestacks[]publicationcontributors[]badgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]publicationcontributors[]badgetier
integernullable

The badge tier, when it has one.

datarestacks[]publicationcontributors[]badgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]publicationcontributors[]badgeservice
stringnullable

The service the badge comes from.

datarestacks[]publicationcontributors[]badgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]publicationcontributors[]bestsellerTier
integernullable

The contributor's bestseller tier.

The publication's sections.

datarestacks[]publicationsections[]id
integernullable

Numeric section id.

datarestacks[]publicationsections[]name
stringnullable

The section's name.

datarestacks[]publicationsections[]description
stringnullable

The section's description.

datarestacks[]publicationsections[]slug
stringnullable

The section's URL slug.

datarestacks[]publicationsections[]isPodcast
booleannullable

Whether the section is a podcast.

datarestacks[]publicationsections[]isLive
booleannullable

Whether the section is a live stream.

datarestacks[]publicationsections[]isDefaultOn
booleannullable

Whether the section is on by default.

datarestacks[]publicationsections[]logoUrl
stringnullable

The section's logo URL.

datarestacks[]publicationsections[]coverImageUrl
stringnullable

The section's cover image URL.

datarestacks[]publicationsections[]hideFromNavbar
booleannullable

Whether the section is hidden from navigation.

datarestacks[]publicationsections[]hidePostsFromPubListings
booleannullable

Whether the section's posts are hidden from publication lists.

Links the publication shows.

datarestacks[]publicationlinks[]id
integernullable

Numeric link id.

datarestacks[]publicationlinks[]url
string

The link.

datarestacks[]publicationlinks[]platform
stringnullable

`apple_podcasts`, `spotify`, `youtube` or another label Substack uses.

datarestacks[]publicationlinks[]sectionId
integernullable

The section the link belongs to, when it has one.

The subscription plans the publication offers.

datarestacks[]publicationplans[]id
stringnullable

The plan's id.

datarestacks[]publicationplans[]nickname
stringnullable

The plan's display name.

datarestacks[]publicationplans[]amount
integernullable

Price in the currency's minor unit.

datarestacks[]publicationplans[]currency
stringnullable

Currency code for the price.

datarestacks[]publicationplans[]interval
stringnullable

`month`, `year` or Substack's own value.

datarestacks[]publicationplans[]intervalCount
integernullable

How many intervals one charge covers.

datarestacks[]publicationplans[]active
booleannullable

Whether the plan is on sale.

datarestacks[]publicationplans[]founding
boolean

Whether this is a founding-member plan.

The publication's podcast, when it has one.

datarestacks[]publicationpodcastexists
booleannullable

Whether the publication has a podcast.

datarestacks[]publicationpodcasthasFreeEpisodes
booleannullable

Whether free episodes are available.

datarestacks[]publicationpodcasthasPaidEpisodes
booleannullable

Whether paid episodes are available.

datarestacks[]publicationpodcastartUrl
stringnullable

The podcast artwork URL.

datarestacks[]publicationpodcastbyline
stringnullable

The podcast byline.

datarestacks[]publicationpodcastdescription
stringnullable

The podcast description.

datarestacks[]publicationpodcastfeedUrl
stringnullable

The podcast feed URL.

datarestacks[]publicationpodcasttitle
stringnullable

The podcast title.

datarestacks[]publicationpodcastpaidEpisodeArtUrl
stringnullable

Artwork for paid episodes.

Matching profiles, when the item is a profile block.

datarestacks[]profiles[]id
integer

Numeric user id.

datarestacks[]profiles[]name
stringnullable

The reader's display name.

datarestacks[]profiles[]handle
stringnullable

The reader's handle.

datarestacks[]profiles[]slug
stringnullable

The reader's profile slug.

datarestacks[]profiles[]bio
stringnullable

The reader's short biography.

datarestacks[]profiles[]photoUrl
stringnullable

The reader's profile photo URL.

datarestacks[]profiles[]createdAt
stringnullable

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

datarestacks[]profiles[]isDisabled
booleannullable

Whether the profile is disabled.

datarestacks[]profiles[]followerCount
integernullable

The number of followers.

datarestacks[]profiles[]subscriberCount
integernullable

The numeric count.

datarestacks[]profiles[]subscriberCountLabel
stringnullable

The label Substack displays.

datarestacks[]profiles[]roughFreeSubscribers
stringnullable

The free-subscriber band Substack displays.

datarestacks[]profiles[]roughFreeSubscribersInt
integernullable

The numeric value behind the free band.

datarestacks[]profiles[]roughSubscribers
stringnullable

The subscriber band Substack displays.

datarestacks[]profiles[]roughSubscribersInt
integernullable

The numeric value behind the subscriber band.

datarestacks[]profiles[]badges
objectnullable

The reader's status fields, when available.

datarestacks[]profiles[]bestsellerTier
integernullable

The reader's bestseller tier.

The reader's leaderboard position.

datarestacks[]profiles[]leaderboardcategory
stringnullable

The leaderboard category.

datarestacks[]profiles[]leaderboardrank
integernullable

The rank in that category.

datarestacks[]profiles[]leaderboardranking
stringnullable

`paid`, `free` or Substack's own label.

datarestacks[]profiles[]leaderboardpublicationId
integernullable

Numeric publication id.

datarestacks[]profiles[]leaderboardpublicationName
stringnullable

The publication's name.

Links the reader shows.

datarestacks[]profiles[]links[]id
integernullable

Numeric link id.

datarestacks[]profiles[]links[]value
stringnullable

The value the person entered for the link.

datarestacks[]profiles[]links[]url
stringnullable

The link's URL.

datarestacks[]profiles[]links[]type
stringnullable

The link type, such as `twitter`.

datarestacks[]profiles[]links[]label
stringnullable

The label shown for the link.

datarestacks[]profiles[]publicationUrl
stringnullable

The reader's publication URL.

datarestacks[]profiles[]hasNotes
booleannullable

Whether the reader has Notes.

datarestacks[]profiles[]hasGuestPost
booleannullable

Whether the reader has a guest post.

datarestacks[]profiles[]hasLikes
booleannullable

Whether the reader has likes.

datarestacks[]profiles[]hasPosts
booleannullable

Whether the reader has posts.

datarestacks[]profiles[]recommendationCount
integernullable

The number of recommendations.

The reader's primary publication.

datarestacks[]profiles[]primaryPublicationid
integer

Numeric publication id.

datarestacks[]profiles[]primaryPublicationname
stringnullable

The publication's name.

datarestacks[]profiles[]primaryPublicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]profiles[]primaryPublicationcustomDomain
stringnullable

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

datarestacks[]profiles[]primaryPublicationapexDomain
stringnullable

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

datarestacks[]profiles[]primaryPublicationurl
stringnullable

The publication's canonical base URL.

datarestacks[]profiles[]primaryPublicationhost
stringnullable

The host its pages are served from.

datarestacks[]profiles[]primaryPublicationdescription
stringnullable

The publication's description.

datarestacks[]profiles[]primaryPublicationlanguage
stringnullable

The publication's language code.

datarestacks[]profiles[]primaryPublicationkind
stringnullable

`newsletter`, `podcast` or Substack's own type.

datarestacks[]profiles[]primaryPublicationcreatedAt
stringnullable

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

datarestacks[]profiles[]primaryPublicationfirstPostAt
stringnullable

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

datarestacks[]profiles[]primaryPublicationhasPosts
booleannullable

Whether the publication has posts.

datarestacks[]profiles[]primaryPublicationisExplicit
booleannullable

Whether the publication is marked explicit.

datarestacks[]profiles[]primaryPublicationisInviteOnly
booleannullable

Whether the publication is invite-only.

datarestacks[]profiles[]primaryPublicationisFlagged
booleannullable

Whether the publication is flagged.

datarestacks[]profiles[]primaryPublicationnoIndex
booleannullable

Whether search engines are asked not to index it.

datarestacks[]profiles[]primaryPublicationisOnSubstack
booleannullable

Whether the publication is hosted by Substack.

datarestacks[]profiles[]primaryPublicationcommentsEnabled
booleannullable

Whether comments are enabled.

datarestacks[]profiles[]primaryPublicationnotesEnabled
booleannullable

Whether Notes are enabled.

datarestacks[]profiles[]primaryPublicationdefaultCommentSort
stringnullable

The default comment order.

datarestacks[]profiles[]primaryPublicationannualDisabled
booleannullable

Whether annual plans are disabled.

datarestacks[]profiles[]primaryPublicationmonthlyDisabled
booleannullable

Whether monthly plans are disabled.

datarestacks[]profiles[]primaryPublicationpaymentsState
stringnullable

The publication's payments state.

datarestacks[]profiles[]primaryPublicationfreeTrialEnabled
booleannullable

Whether a free trial is offered.

datarestacks[]profiles[]primaryPublicationpausedUntil
stringnullable

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

datarestacks[]profiles[]primaryPublicationemailBannerUrl
stringnullable

The email banner image URL.

datarestacks[]profiles[]primaryPublicationcopyright
stringnullable

The copyright line the publication prints.

datarestacks[]profiles[]primaryPublicationlogoUrl
stringnullable

The publication's logo URL.

datarestacks[]profiles[]primaryPublicationwideLogoUrl
stringnullable

The publication's wide logo URL.

datarestacks[]profiles[]primaryPublicationcoverImageUrl
stringnullable

The publication's cover image URL.

datarestacks[]profiles[]primaryPublicationfoundingPlanName
stringnullable

The name of the founding-member plan.

datarestacks[]profiles[]primaryPublicationhasRecommendations
booleannullable

Whether the publication recommends others.

The benefit lists for each subscription tier.

Benefits for free subscribers.

datarestacks[]profiles[]primaryPublicationbenefitsfree[]
stringoptional

Benefits for paid subscribers.

datarestacks[]profiles[]primaryPublicationbenefitspaid[]
stringoptional

Benefits for founding members.

datarestacks[]profiles[]primaryPublicationbenefitsfounding[]
stringoptional

The publication's main author.

datarestacks[]profiles[]primaryPublicationauthorid
integernullable

Numeric user id.

datarestacks[]profiles[]primaryPublicationauthorname
stringnullable

The name shown for the author.

datarestacks[]profiles[]primaryPublicationauthorhandle
stringnullable

The author's handle.

datarestacks[]profiles[]primaryPublicationauthorslug
stringnullable

The author's profile slug.

datarestacks[]profiles[]primaryPublicationauthorbio
stringnullable

The author's short biography.

datarestacks[]profiles[]primaryPublicationauthorphotoUrl
stringnullable

The author's profile photo URL.

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

datarestacks[]profiles[]primaryPublicationauthorbadgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]profiles[]primaryPublicationauthorbadgetier
integernullable

The badge tier, when it has one.

datarestacks[]profiles[]primaryPublicationauthorbadgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]profiles[]primaryPublicationauthorbadgeservice
stringnullable

The service the badge comes from.

datarestacks[]profiles[]primaryPublicationauthorbadgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]profiles[]primaryPublicationauthorbadges
objectnullable

The author's reader status fields, when available.

datarestacks[]profiles[]primaryPublicationauthorbestsellerTier
integernullable

The author's bestseller tier.

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

datarestacks[]profiles[]primaryPublicationauthorprimaryPublicationid
integernullable

Numeric publication id.

datarestacks[]profiles[]primaryPublicationauthorprimaryPublicationname
stringnullable

The publication's name.

datarestacks[]profiles[]primaryPublicationauthorprimaryPublicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]profiles[]primaryPublicationauthorprimaryPublicationcustomDomain
stringnullable

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

datarestacks[]profiles[]primaryPublicationauthorprimaryPublicationlogoUrl
stringnullable

The publication's logo URL.

Approximate audience figures the publication prints. These are bands, not counts.

datarestacks[]profiles[]primaryPublicationaudiencepaidLabel
stringnullable

The band Substack displays for paid subscribers.

datarestacks[]profiles[]primaryPublicationaudiencepaidOrderOfMagnitude
integernullable

The order of magnitude behind the paid band.

datarestacks[]profiles[]primaryPublicationaudiencetotalLabel
stringnullable

The band Substack displays for all subscribers.

datarestacks[]profiles[]primaryPublicationaudiencetotalOrderOfMagnitude
integernullable

The order of magnitude behind the total band.

datarestacks[]profiles[]primaryPublicationaudiencefreeLabel
stringnullable

The band Substack displays for free subscribers.

datarestacks[]profiles[]primaryPublicationaudiencefreeShort
stringnullable

The short free-subscriber band.

datarestacks[]profiles[]primaryPublicationaudiencechatMembersLabel
stringnullable

The band Substack displays for chat members.

People with a byline on the publication.

datarestacks[]profiles[]primaryPublicationcontributors[]id
integernullable

Numeric user id.

datarestacks[]profiles[]primaryPublicationcontributors[]name
stringnullable

The contributor's name.

datarestacks[]profiles[]primaryPublicationcontributors[]handle
stringnullable

The contributor's handle.

datarestacks[]profiles[]primaryPublicationcontributors[]role
stringnullable

The contributor's role on the publication.

datarestacks[]profiles[]primaryPublicationcontributors[]owner
booleannullable

Whether the contributor owns the publication.

datarestacks[]profiles[]primaryPublicationcontributors[]photoUrl
stringnullable

The contributor's photo URL.

datarestacks[]profiles[]primaryPublicationcontributors[]bio
stringnullable

The contributor's short biography.

The contributor's badge.

datarestacks[]profiles[]primaryPublicationcontributors[]badgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]profiles[]primaryPublicationcontributors[]badgetier
integernullable

The badge tier, when it has one.

datarestacks[]profiles[]primaryPublicationcontributors[]badgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]profiles[]primaryPublicationcontributors[]badgeservice
stringnullable

The service the badge comes from.

datarestacks[]profiles[]primaryPublicationcontributors[]badgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]profiles[]primaryPublicationcontributors[]bestsellerTier
integernullable

The contributor's bestseller tier.

The publication's sections.

datarestacks[]profiles[]primaryPublicationsections[]id
integernullable

Numeric section id.

datarestacks[]profiles[]primaryPublicationsections[]name
stringnullable

The section's name.

datarestacks[]profiles[]primaryPublicationsections[]description
stringnullable

The section's description.

datarestacks[]profiles[]primaryPublicationsections[]slug
stringnullable

The section's URL slug.

datarestacks[]profiles[]primaryPublicationsections[]isPodcast
booleannullable

Whether the section is a podcast.

datarestacks[]profiles[]primaryPublicationsections[]isLive
booleannullable

Whether the section is a live stream.

datarestacks[]profiles[]primaryPublicationsections[]isDefaultOn
booleannullable

Whether the section is on by default.

datarestacks[]profiles[]primaryPublicationsections[]logoUrl
stringnullable

The section's logo URL.

datarestacks[]profiles[]primaryPublicationsections[]coverImageUrl
stringnullable

The section's cover image URL.

datarestacks[]profiles[]primaryPublicationsections[]hideFromNavbar
booleannullable

Whether the section is hidden from navigation.

datarestacks[]profiles[]primaryPublicationsections[]hidePostsFromPubListings
booleannullable

Whether the section's posts are hidden from publication lists.

Links the publication shows.

datarestacks[]profiles[]primaryPublicationlinks[]id
integernullable

Numeric link id.

datarestacks[]profiles[]primaryPublicationlinks[]url
string

The link.

datarestacks[]profiles[]primaryPublicationlinks[]platform
stringnullable

`apple_podcasts`, `spotify`, `youtube` or another label Substack uses.

datarestacks[]profiles[]primaryPublicationlinks[]sectionId
integernullable

The section the link belongs to, when it has one.

The subscription plans the publication offers.

datarestacks[]profiles[]primaryPublicationplans[]id
stringnullable

The plan's id.

datarestacks[]profiles[]primaryPublicationplans[]nickname
stringnullable

The plan's display name.

datarestacks[]profiles[]primaryPublicationplans[]amount
integernullable

Price in the currency's minor unit.

datarestacks[]profiles[]primaryPublicationplans[]currency
stringnullable

Currency code for the price.

datarestacks[]profiles[]primaryPublicationplans[]interval
stringnullable

`month`, `year` or Substack's own value.

datarestacks[]profiles[]primaryPublicationplans[]intervalCount
integernullable

How many intervals one charge covers.

datarestacks[]profiles[]primaryPublicationplans[]active
booleannullable

Whether the plan is on sale.

datarestacks[]profiles[]primaryPublicationplans[]founding
boolean

Whether this is a founding-member plan.

The publication's podcast, when it has one.

datarestacks[]profiles[]primaryPublicationpodcastexists
booleannullable

Whether the publication has a podcast.

datarestacks[]profiles[]primaryPublicationpodcasthasFreeEpisodes
booleannullable

Whether free episodes are available.

datarestacks[]profiles[]primaryPublicationpodcasthasPaidEpisodes
booleannullable

Whether paid episodes are available.

datarestacks[]profiles[]primaryPublicationpodcastartUrl
stringnullable

The podcast artwork URL.

datarestacks[]profiles[]primaryPublicationpodcastbyline
stringnullable

The podcast byline.

datarestacks[]profiles[]primaryPublicationpodcastdescription
stringnullable

The podcast description.

datarestacks[]profiles[]primaryPublicationpodcastfeedUrl
stringnullable

The podcast feed URL.

datarestacks[]profiles[]primaryPublicationpodcasttitle
stringnullable

The podcast title.

datarestacks[]profiles[]primaryPublicationpodcastpaidEpisodeArtUrl
stringnullable

Artwork for paid episodes.

Publications the reader writes for.

datarestacks[]profiles[]publications[]role
stringnullable

The person's role on the publication.

datarestacks[]profiles[]publications[]public
booleannullable

Whether the role is shown publicly.

datarestacks[]profiles[]publications[]isPrimary
booleannullable

Whether this is the person's primary publication.

A Substack publication.

datarestacks[]profiles[]publications[]publicationid
integer

Numeric publication id.

datarestacks[]profiles[]publications[]publicationname
stringnullable

The publication's name.

datarestacks[]profiles[]publications[]publicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]profiles[]publications[]publicationcustomDomain
stringnullable

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

datarestacks[]profiles[]publications[]publicationapexDomain
stringnullable

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

datarestacks[]profiles[]publications[]publicationurl
stringnullable

The publication's canonical base URL.

datarestacks[]profiles[]publications[]publicationhost
stringnullable

The host its pages are served from.

datarestacks[]profiles[]publications[]publicationdescription
stringnullable

The publication's description.

datarestacks[]profiles[]publications[]publicationlanguage
stringnullable

The publication's language code.

datarestacks[]profiles[]publications[]publicationkind
stringnullable

`newsletter`, `podcast` or Substack's own type.

datarestacks[]profiles[]publications[]publicationcreatedAt
stringnullable

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

datarestacks[]profiles[]publications[]publicationfirstPostAt
stringnullable

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

datarestacks[]profiles[]publications[]publicationhasPosts
booleannullable

Whether the publication has posts.

datarestacks[]profiles[]publications[]publicationisExplicit
booleannullable

Whether the publication is marked explicit.

datarestacks[]profiles[]publications[]publicationisInviteOnly
booleannullable

Whether the publication is invite-only.

datarestacks[]profiles[]publications[]publicationisFlagged
booleannullable

Whether the publication is flagged.

datarestacks[]profiles[]publications[]publicationnoIndex
booleannullable

Whether search engines are asked not to index it.

datarestacks[]profiles[]publications[]publicationisOnSubstack
booleannullable

Whether the publication is hosted by Substack.

datarestacks[]profiles[]publications[]publicationcommentsEnabled
booleannullable

Whether comments are enabled.

datarestacks[]profiles[]publications[]publicationnotesEnabled
booleannullable

Whether Notes are enabled.

datarestacks[]profiles[]publications[]publicationdefaultCommentSort
stringnullable

The default comment order.

datarestacks[]profiles[]publications[]publicationannualDisabled
booleannullable

Whether annual plans are disabled.

datarestacks[]profiles[]publications[]publicationmonthlyDisabled
booleannullable

Whether monthly plans are disabled.

datarestacks[]profiles[]publications[]publicationpaymentsState
stringnullable

The publication's payments state.

datarestacks[]profiles[]publications[]publicationfreeTrialEnabled
booleannullable

Whether a free trial is offered.

datarestacks[]profiles[]publications[]publicationpausedUntil
stringnullable

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

datarestacks[]profiles[]publications[]publicationemailBannerUrl
stringnullable

The email banner image URL.

datarestacks[]profiles[]publications[]publicationcopyright
stringnullable

The copyright line the publication prints.

datarestacks[]profiles[]publications[]publicationlogoUrl
stringnullable

The publication's logo URL.

datarestacks[]profiles[]publications[]publicationwideLogoUrl
stringnullable

The publication's wide logo URL.

datarestacks[]profiles[]publications[]publicationcoverImageUrl
stringnullable

The publication's cover image URL.

datarestacks[]profiles[]publications[]publicationfoundingPlanName
stringnullable

The name of the founding-member plan.

datarestacks[]profiles[]publications[]publicationhasRecommendations
booleannullable

Whether the publication recommends others.

The benefit lists for each subscription tier.

Benefits for free subscribers.

datarestacks[]profiles[]publications[]publicationbenefitsfree[]
stringoptional

Benefits for paid subscribers.

datarestacks[]profiles[]publications[]publicationbenefitspaid[]
stringoptional

Benefits for founding members.

datarestacks[]profiles[]publications[]publicationbenefitsfounding[]
stringoptional

The publication's main author.

datarestacks[]profiles[]publications[]publicationauthorid
integernullable

Numeric user id.

datarestacks[]profiles[]publications[]publicationauthorname
stringnullable

The name shown for the author.

datarestacks[]profiles[]publications[]publicationauthorhandle
stringnullable

The author's handle.

datarestacks[]profiles[]publications[]publicationauthorslug
stringnullable

The author's profile slug.

datarestacks[]profiles[]publications[]publicationauthorbio
stringnullable

The author's short biography.

datarestacks[]profiles[]publications[]publicationauthorphotoUrl
stringnullable

The author's profile photo URL.

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

datarestacks[]profiles[]publications[]publicationauthorbadgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]profiles[]publications[]publicationauthorbadgetier
integernullable

The badge tier, when it has one.

datarestacks[]profiles[]publications[]publicationauthorbadgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]profiles[]publications[]publicationauthorbadgeservice
stringnullable

The service the badge comes from.

datarestacks[]profiles[]publications[]publicationauthorbadgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]profiles[]publications[]publicationauthorbadges
objectnullable

The author's reader status fields, when available.

datarestacks[]profiles[]publications[]publicationauthorbestsellerTier
integernullable

The author's bestseller tier.

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

datarestacks[]profiles[]publications[]publicationauthorprimaryPublicationid
integernullable

Numeric publication id.

datarestacks[]profiles[]publications[]publicationauthorprimaryPublicationname
stringnullable

The publication's name.

datarestacks[]profiles[]publications[]publicationauthorprimaryPublicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]profiles[]publications[]publicationauthorprimaryPublicationcustomDomain
stringnullable

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

datarestacks[]profiles[]publications[]publicationauthorprimaryPublicationlogoUrl
stringnullable

The publication's logo URL.

Approximate audience figures the publication prints. These are bands, not counts.

datarestacks[]profiles[]publications[]publicationaudiencepaidLabel
stringnullable

The band Substack displays for paid subscribers.

datarestacks[]profiles[]publications[]publicationaudiencepaidOrderOfMagnitude
integernullable

The order of magnitude behind the paid band.

datarestacks[]profiles[]publications[]publicationaudiencetotalLabel
stringnullable

The band Substack displays for all subscribers.

datarestacks[]profiles[]publications[]publicationaudiencetotalOrderOfMagnitude
integernullable

The order of magnitude behind the total band.

datarestacks[]profiles[]publications[]publicationaudiencefreeLabel
stringnullable

The band Substack displays for free subscribers.

datarestacks[]profiles[]publications[]publicationaudiencefreeShort
stringnullable

The short free-subscriber band.

datarestacks[]profiles[]publications[]publicationaudiencechatMembersLabel
stringnullable

The band Substack displays for chat members.

People with a byline on the publication.

datarestacks[]profiles[]publications[]publicationcontributors[]id
integernullable

Numeric user id.

datarestacks[]profiles[]publications[]publicationcontributors[]name
stringnullable

The contributor's name.

datarestacks[]profiles[]publications[]publicationcontributors[]handle
stringnullable

The contributor's handle.

datarestacks[]profiles[]publications[]publicationcontributors[]role
stringnullable

The contributor's role on the publication.

datarestacks[]profiles[]publications[]publicationcontributors[]owner
booleannullable

Whether the contributor owns the publication.

datarestacks[]profiles[]publications[]publicationcontributors[]photoUrl
stringnullable

The contributor's photo URL.

datarestacks[]profiles[]publications[]publicationcontributors[]bio
stringnullable

The contributor's short biography.

The contributor's badge.

datarestacks[]profiles[]publications[]publicationcontributors[]badgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]profiles[]publications[]publicationcontributors[]badgetier
integernullable

The badge tier, when it has one.

datarestacks[]profiles[]publications[]publicationcontributors[]badgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]profiles[]publications[]publicationcontributors[]badgeservice
stringnullable

The service the badge comes from.

datarestacks[]profiles[]publications[]publicationcontributors[]badgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]profiles[]publications[]publicationcontributors[]bestsellerTier
integernullable

The contributor's bestseller tier.

The publication's sections.

datarestacks[]profiles[]publications[]publicationsections[]id
integernullable

Numeric section id.

datarestacks[]profiles[]publications[]publicationsections[]name
stringnullable

The section's name.

datarestacks[]profiles[]publications[]publicationsections[]description
stringnullable

The section's description.

datarestacks[]profiles[]publications[]publicationsections[]slug
stringnullable

The section's URL slug.

datarestacks[]profiles[]publications[]publicationsections[]isPodcast
booleannullable

Whether the section is a podcast.

datarestacks[]profiles[]publications[]publicationsections[]isLive
booleannullable

Whether the section is a live stream.

datarestacks[]profiles[]publications[]publicationsections[]isDefaultOn
booleannullable

Whether the section is on by default.

datarestacks[]profiles[]publications[]publicationsections[]logoUrl
stringnullable

The section's logo URL.

datarestacks[]profiles[]publications[]publicationsections[]coverImageUrl
stringnullable

The section's cover image URL.

datarestacks[]profiles[]publications[]publicationsections[]hideFromNavbar
booleannullable

Whether the section is hidden from navigation.

datarestacks[]profiles[]publications[]publicationsections[]hidePostsFromPubListings
booleannullable

Whether the section's posts are hidden from publication lists.

Links the publication shows.

datarestacks[]profiles[]publications[]publicationlinks[]id
integernullable

Numeric link id.

datarestacks[]profiles[]publications[]publicationlinks[]url
string

The link.

datarestacks[]profiles[]publications[]publicationlinks[]platform
stringnullable

`apple_podcasts`, `spotify`, `youtube` or another label Substack uses.

datarestacks[]profiles[]publications[]publicationlinks[]sectionId
integernullable

The section the link belongs to, when it has one.

The subscription plans the publication offers.

datarestacks[]profiles[]publications[]publicationplans[]id
stringnullable

The plan's id.

datarestacks[]profiles[]publications[]publicationplans[]nickname
stringnullable

The plan's display name.

datarestacks[]profiles[]publications[]publicationplans[]amount
integernullable

Price in the currency's minor unit.

datarestacks[]profiles[]publications[]publicationplans[]currency
stringnullable

Currency code for the price.

datarestacks[]profiles[]publications[]publicationplans[]interval
stringnullable

`month`, `year` or Substack's own value.

datarestacks[]profiles[]publications[]publicationplans[]intervalCount
integernullable

How many intervals one charge covers.

datarestacks[]profiles[]publications[]publicationplans[]active
booleannullable

Whether the plan is on sale.

datarestacks[]profiles[]publications[]publicationplans[]founding
boolean

Whether this is a founding-member plan.

The publication's podcast, when it has one.

datarestacks[]profiles[]publications[]publicationpodcastexists
booleannullable

Whether the publication has a podcast.

datarestacks[]profiles[]publications[]publicationpodcasthasFreeEpisodes
booleannullable

Whether free episodes are available.

datarestacks[]profiles[]publications[]publicationpodcasthasPaidEpisodes
booleannullable

Whether paid episodes are available.

datarestacks[]profiles[]publications[]publicationpodcastartUrl
stringnullable

The podcast artwork URL.

datarestacks[]profiles[]publications[]publicationpodcastbyline
stringnullable

The podcast byline.

datarestacks[]profiles[]publications[]publicationpodcastdescription
stringnullable

The podcast description.

datarestacks[]profiles[]publications[]publicationpodcastfeedUrl
stringnullable

The podcast feed URL.

datarestacks[]profiles[]publications[]publicationpodcasttitle
stringnullable

The podcast title.

datarestacks[]profiles[]publications[]publicationpodcastpaidEpisodeArtUrl
stringnullable

Artwork for paid episodes.

Publications the reader shows publicly.

datarestacks[]profiles[]subscriptions[]id
integernullable

Numeric subscription id.

datarestacks[]profiles[]subscriptions[]visibility
stringnullable

Who can see the subscription.

datarestacks[]profiles[]subscriptions[]membershipState
stringnullable

The person's membership state.

datarestacks[]profiles[]subscriptions[]type
stringnullable

The subscription type.

datarestacks[]profiles[]subscriptions[]isFounding
booleannullable

Whether this is a founding membership.

A Substack publication.

datarestacks[]profiles[]subscriptions[]publicationid
integer

Numeric publication id.

datarestacks[]profiles[]subscriptions[]publicationname
stringnullable

The publication's name.

datarestacks[]profiles[]subscriptions[]publicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]profiles[]subscriptions[]publicationcustomDomain
stringnullable

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

datarestacks[]profiles[]subscriptions[]publicationapexDomain
stringnullable

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

datarestacks[]profiles[]subscriptions[]publicationurl
stringnullable

The publication's canonical base URL.

datarestacks[]profiles[]subscriptions[]publicationhost
stringnullable

The host its pages are served from.

datarestacks[]profiles[]subscriptions[]publicationdescription
stringnullable

The publication's description.

datarestacks[]profiles[]subscriptions[]publicationlanguage
stringnullable

The publication's language code.

datarestacks[]profiles[]subscriptions[]publicationkind
stringnullable

`newsletter`, `podcast` or Substack's own type.

datarestacks[]profiles[]subscriptions[]publicationcreatedAt
stringnullable

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

datarestacks[]profiles[]subscriptions[]publicationfirstPostAt
stringnullable

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

datarestacks[]profiles[]subscriptions[]publicationhasPosts
booleannullable

Whether the publication has posts.

datarestacks[]profiles[]subscriptions[]publicationisExplicit
booleannullable

Whether the publication is marked explicit.

datarestacks[]profiles[]subscriptions[]publicationisInviteOnly
booleannullable

Whether the publication is invite-only.

datarestacks[]profiles[]subscriptions[]publicationisFlagged
booleannullable

Whether the publication is flagged.

datarestacks[]profiles[]subscriptions[]publicationnoIndex
booleannullable

Whether search engines are asked not to index it.

datarestacks[]profiles[]subscriptions[]publicationisOnSubstack
booleannullable

Whether the publication is hosted by Substack.

datarestacks[]profiles[]subscriptions[]publicationcommentsEnabled
booleannullable

Whether comments are enabled.

datarestacks[]profiles[]subscriptions[]publicationnotesEnabled
booleannullable

Whether Notes are enabled.

datarestacks[]profiles[]subscriptions[]publicationdefaultCommentSort
stringnullable

The default comment order.

datarestacks[]profiles[]subscriptions[]publicationannualDisabled
booleannullable

Whether annual plans are disabled.

datarestacks[]profiles[]subscriptions[]publicationmonthlyDisabled
booleannullable

Whether monthly plans are disabled.

datarestacks[]profiles[]subscriptions[]publicationpaymentsState
stringnullable

The publication's payments state.

datarestacks[]profiles[]subscriptions[]publicationfreeTrialEnabled
booleannullable

Whether a free trial is offered.

datarestacks[]profiles[]subscriptions[]publicationpausedUntil
stringnullable

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

datarestacks[]profiles[]subscriptions[]publicationemailBannerUrl
stringnullable

The email banner image URL.

datarestacks[]profiles[]subscriptions[]publicationcopyright
stringnullable

The copyright line the publication prints.

datarestacks[]profiles[]subscriptions[]publicationlogoUrl
stringnullable

The publication's logo URL.

datarestacks[]profiles[]subscriptions[]publicationwideLogoUrl
stringnullable

The publication's wide logo URL.

datarestacks[]profiles[]subscriptions[]publicationcoverImageUrl
stringnullable

The publication's cover image URL.

datarestacks[]profiles[]subscriptions[]publicationfoundingPlanName
stringnullable

The name of the founding-member plan.

datarestacks[]profiles[]subscriptions[]publicationhasRecommendations
booleannullable

Whether the publication recommends others.

The benefit lists for each subscription tier.

Benefits for free subscribers.

datarestacks[]profiles[]subscriptions[]publicationbenefitsfree[]
stringoptional

Benefits for paid subscribers.

datarestacks[]profiles[]subscriptions[]publicationbenefitspaid[]
stringoptional

Benefits for founding members.

datarestacks[]profiles[]subscriptions[]publicationbenefitsfounding[]
stringoptional

The publication's main author.

datarestacks[]profiles[]subscriptions[]publicationauthorid
integernullable

Numeric user id.

datarestacks[]profiles[]subscriptions[]publicationauthorname
stringnullable

The name shown for the author.

datarestacks[]profiles[]subscriptions[]publicationauthorhandle
stringnullable

The author's handle.

datarestacks[]profiles[]subscriptions[]publicationauthorslug
stringnullable

The author's profile slug.

datarestacks[]profiles[]subscriptions[]publicationauthorbio
stringnullable

The author's short biography.

datarestacks[]profiles[]subscriptions[]publicationauthorphotoUrl
stringnullable

The author's profile photo URL.

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

datarestacks[]profiles[]subscriptions[]publicationauthorbadgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]profiles[]subscriptions[]publicationauthorbadgetier
integernullable

The badge tier, when it has one.

datarestacks[]profiles[]subscriptions[]publicationauthorbadgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]profiles[]subscriptions[]publicationauthorbadgeservice
stringnullable

The service the badge comes from.

datarestacks[]profiles[]subscriptions[]publicationauthorbadgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]profiles[]subscriptions[]publicationauthorbadges
objectnullable

The author's reader status fields, when available.

datarestacks[]profiles[]subscriptions[]publicationauthorbestsellerTier
integernullable

The author's bestseller tier.

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

datarestacks[]profiles[]subscriptions[]publicationauthorprimaryPublicationid
integernullable

Numeric publication id.

datarestacks[]profiles[]subscriptions[]publicationauthorprimaryPublicationname
stringnullable

The publication's name.

datarestacks[]profiles[]subscriptions[]publicationauthorprimaryPublicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]profiles[]subscriptions[]publicationauthorprimaryPublicationcustomDomain
stringnullable

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

datarestacks[]profiles[]subscriptions[]publicationauthorprimaryPublicationlogoUrl
stringnullable

The publication's logo URL.

Approximate audience figures the publication prints. These are bands, not counts.

datarestacks[]profiles[]subscriptions[]publicationaudiencepaidLabel
stringnullable

The band Substack displays for paid subscribers.

datarestacks[]profiles[]subscriptions[]publicationaudiencepaidOrderOfMagnitude
integernullable

The order of magnitude behind the paid band.

datarestacks[]profiles[]subscriptions[]publicationaudiencetotalLabel
stringnullable

The band Substack displays for all subscribers.

datarestacks[]profiles[]subscriptions[]publicationaudiencetotalOrderOfMagnitude
integernullable

The order of magnitude behind the total band.

datarestacks[]profiles[]subscriptions[]publicationaudiencefreeLabel
stringnullable

The band Substack displays for free subscribers.

datarestacks[]profiles[]subscriptions[]publicationaudiencefreeShort
stringnullable

The short free-subscriber band.

datarestacks[]profiles[]subscriptions[]publicationaudiencechatMembersLabel
stringnullable

The band Substack displays for chat members.

People with a byline on the publication.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]id
integernullable

Numeric user id.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]name
stringnullable

The contributor's name.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]handle
stringnullable

The contributor's handle.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]role
stringnullable

The contributor's role on the publication.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]owner
booleannullable

Whether the contributor owns the publication.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]photoUrl
stringnullable

The contributor's photo URL.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]bio
stringnullable

The contributor's short biography.

The contributor's badge.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]badgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]badgetier
integernullable

The badge tier, when it has one.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]badgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]badgeservice
stringnullable

The service the badge comes from.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]badgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]profiles[]subscriptions[]publicationcontributors[]bestsellerTier
integernullable

The contributor's bestseller tier.

The publication's sections.

datarestacks[]profiles[]subscriptions[]publicationsections[]id
integernullable

Numeric section id.

datarestacks[]profiles[]subscriptions[]publicationsections[]name
stringnullable

The section's name.

datarestacks[]profiles[]subscriptions[]publicationsections[]description
stringnullable

The section's description.

datarestacks[]profiles[]subscriptions[]publicationsections[]slug
stringnullable

The section's URL slug.

datarestacks[]profiles[]subscriptions[]publicationsections[]isPodcast
booleannullable

Whether the section is a podcast.

datarestacks[]profiles[]subscriptions[]publicationsections[]isLive
booleannullable

Whether the section is a live stream.

datarestacks[]profiles[]subscriptions[]publicationsections[]isDefaultOn
booleannullable

Whether the section is on by default.

datarestacks[]profiles[]subscriptions[]publicationsections[]logoUrl
stringnullable

The section's logo URL.

datarestacks[]profiles[]subscriptions[]publicationsections[]coverImageUrl
stringnullable

The section's cover image URL.

datarestacks[]profiles[]subscriptions[]publicationsections[]hideFromNavbar
booleannullable

Whether the section is hidden from navigation.

datarestacks[]profiles[]subscriptions[]publicationsections[]hidePostsFromPubListings
booleannullable

Whether the section's posts are hidden from publication lists.

Links the publication shows.

datarestacks[]profiles[]subscriptions[]publicationlinks[]id
integernullable

Numeric link id.

datarestacks[]profiles[]subscriptions[]publicationlinks[]url
string

The link.

datarestacks[]profiles[]subscriptions[]publicationlinks[]platform
stringnullable

`apple_podcasts`, `spotify`, `youtube` or another label Substack uses.

datarestacks[]profiles[]subscriptions[]publicationlinks[]sectionId
integernullable

The section the link belongs to, when it has one.

The subscription plans the publication offers.

datarestacks[]profiles[]subscriptions[]publicationplans[]id
stringnullable

The plan's id.

datarestacks[]profiles[]subscriptions[]publicationplans[]nickname
stringnullable

The plan's display name.

datarestacks[]profiles[]subscriptions[]publicationplans[]amount
integernullable

Price in the currency's minor unit.

datarestacks[]profiles[]subscriptions[]publicationplans[]currency
stringnullable

Currency code for the price.

datarestacks[]profiles[]subscriptions[]publicationplans[]interval
stringnullable

`month`, `year` or Substack's own value.

datarestacks[]profiles[]subscriptions[]publicationplans[]intervalCount
integernullable

How many intervals one charge covers.

datarestacks[]profiles[]subscriptions[]publicationplans[]active
booleannullable

Whether the plan is on sale.

datarestacks[]profiles[]subscriptions[]publicationplans[]founding
boolean

Whether this is a founding-member plan.

The publication's podcast, when it has one.

datarestacks[]profiles[]subscriptions[]publicationpodcastexists
booleannullable

Whether the publication has a podcast.

datarestacks[]profiles[]subscriptions[]publicationpodcasthasFreeEpisodes
booleannullable

Whether free episodes are available.

datarestacks[]profiles[]subscriptions[]publicationpodcasthasPaidEpisodes
booleannullable

Whether paid episodes are available.

datarestacks[]profiles[]subscriptions[]publicationpodcastartUrl
stringnullable

The podcast artwork URL.

datarestacks[]profiles[]subscriptions[]publicationpodcastbyline
stringnullable

The podcast byline.

datarestacks[]profiles[]subscriptions[]publicationpodcastdescription
stringnullable

The podcast description.

datarestacks[]profiles[]subscriptions[]publicationpodcastfeedUrl
stringnullable

The podcast feed URL.

datarestacks[]profiles[]subscriptions[]publicationpodcasttitle
stringnullable

The podcast title.

datarestacks[]profiles[]subscriptions[]publicationpodcastpaidEpisodeArtUrl
stringnullable

Artwork for paid episodes.

datarestacks[]profiles[]subscriptionCount
integernullable

The number of public subscriptions.

datarestacks[]profiles[]subscriptionsTruncated
booleannullable

True when Substack cut the subscription list.

datarestacks[]createdAt
stringnullable

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

Parent notes, when the item is a reply.

datarestacks[]parentComments[]id
integer

Numeric note id.

datarestacks[]parentComments[]body
stringnullable

The note's plain text.

datarestacks[]parentComments[]bodyJson
objectnullable

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

datarestacks[]parentComments[]createdAt
stringnullable

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

datarestacks[]parentComments[]editedAt
stringnullable

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

The note's author.

datarestacks[]parentComments[]authorid
integernullable

Numeric user id.

datarestacks[]parentComments[]authorname
stringnullable

The name shown for the author.

datarestacks[]parentComments[]authorhandle
stringnullable

The author's handle.

datarestacks[]parentComments[]authorslug
stringnullable

The author's profile slug.

datarestacks[]parentComments[]authorbio
stringnullable

The author's short biography.

datarestacks[]parentComments[]authorphotoUrl
stringnullable

The author's profile photo URL.

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

datarestacks[]parentComments[]authorbadgetype
stringnullable

The kind of badge, such as `bestseller`.

datarestacks[]parentComments[]authorbadgetier
integernullable

The badge tier, when it has one.

datarestacks[]parentComments[]authorbadgehandle
stringnullable

The handle the badge belongs to.

datarestacks[]parentComments[]authorbadgeservice
stringnullable

The service the badge comes from.

datarestacks[]parentComments[]authorbadgeurl
stringnullable

A link for the badge, when it has one.

datarestacks[]parentComments[]authorbadges
objectnullable

The author's reader status fields, when available.

datarestacks[]parentComments[]authorbestsellerTier
integernullable

The author's bestseller tier.

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

datarestacks[]parentComments[]authorprimaryPublicationid
integernullable

Numeric publication id.

datarestacks[]parentComments[]authorprimaryPublicationname
stringnullable

The publication's name.

datarestacks[]parentComments[]authorprimaryPublicationsubdomain
stringnullable

The publication's Substack subdomain.

datarestacks[]parentComments[]authorprimaryPublicationcustomDomain
stringnullable

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

datarestacks[]parentComments[]authorprimaryPublicationlogoUrl
stringnullable

The publication's logo URL.

datarestacks[]parentComments[]reactionCount
integernullable

The number of reactions.

datarestacks[]parentComments[]reactions
object

Emoji to reaction count.

datarestacks[]parentComments[]restackCount
integernullable

The number of restacks.

datarestacks[]parentComments[]replyCount
integernullable

The number of replies.

datarestacks[]parentComments[]language
stringnullable

The note's language code.

datarestacks[]parentComments[]isAiGenerated
booleannullable

Substack's own flag.

datarestacks[]parentComments[]translation
objectnullable

A translation of the note, when there is one.

datarestacks[]parentComments[]replyPermission
stringnullable

Who may reply to the note.

datarestacks[]parentComments[]ancestorPath
stringnullable

The note's position in a thread.

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

datarestacks[]parentComments[]attachments[]id
stringnullable

The attachment's id.

datarestacks[]parentComments[]attachments[]type
stringnullable

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

datarestacks[]parentComments[]attachments[]imageUrl
stringnullable

The image URL, for an image attachment.

datarestacks[]parentComments[]attachments[]imageWidth
integernullable

The image width in pixels.

datarestacks[]parentComments[]attachments[]imageHeight
integernullable

The image height in pixels.

datarestacks[]parentComments[]attachments[]explicit
booleannullable

Whether the attachment is explicit.

Preview metadata for a link attachment.

datarestacks[]parentComments[]attachments[]linkurl
stringnullable

The link's URL.

datarestacks[]parentComments[]attachments[]linkhost
stringnullable

The link's host.

datarestacks[]parentComments[]attachments[]linktitle
stringnullable

The link's title.

datarestacks[]parentComments[]attachments[]linkdescription
stringnullable

The link's description.

datarestacks[]parentComments[]attachments[]linkimage
stringnullable

The link's preview image URL.

datarestacks[]parentComments[]attachments[]linkoriginalImage
stringnullable

The link's original image URL.

datarestacks[]parentComments[]attachments[]postId
integernullable

The attached post's id.

datarestacks[]parentComments[]attachments[]publicationId
integernullable

The attached publication's id.

datarestacks[]parentComments[]attachments[]reason
stringnullable

Why a missing attachment was removed.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

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/restacks" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Substack note restacks.