Search Substack posts, notes and people Search Substack posts, notes and profiles, cursor paged.
x-api-key* string header
API key (`sfk_...`)
query* string required query
Text to search posts, notes and profiles for.
min 1 chars · max 200 chars
cursor string optional query
Opaque cursor from the previous page's `nextCursor`.
max 4096 chars
Response fields 742 Expand all Collapse all Collapse all Endpoint-specific response payload.
The query that was searched.
data . items [] . type
string nullable
`post`, `comment`/note, or `profileSearchResults`.
data . items [] . id
string nullable
Substack's entity key, e.g. `p-123` or `c-456`.
The post, when the item is a post.
data . items [] . post . id
integer
Numeric post id.
data . items [] . post . publicationId
integer nullable
Numeric publication id.
data . items [] . post . slug
string nullable
The post's URL slug.
data . items [] . post . title
string nullable
The post's title.
data . items [] . post . subtitle
string nullable
The post's subtitle.
data . items [] . post . description
string nullable
The post's short description.
data . items [] . post . kind
string nullable
`newsletter`, `podcast`, `video` or `restack`.
data . items [] . post . audience
string nullable
`everyone`, `only_paid`, `only_subscribers` or another value Substack uses.
data . items [] . post . isPaywalled
boolean nullable
Whether the post is paid.
data . items [] . post . url
string nullable
Canonical post URL.
data . items [] . post . publishedAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . post . updatedAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . post . language
string nullable
The post's language code.
data . items [] . post . bodyHtml
string nullable
Full body HTML for a free post; the preview only when `bodyIsPreview` is true.
data . items [] . post . bodyIsPreview
boolean
True when the audience is not `everyone`.
data . items [] . post . previewText
string nullable
The public preview text.
data . items [] . post . wordCount
integer nullable
The post's word count.
data . items [] . post . commentCount
integer nullable
The number of comments on the post.
data . items [] . post . replyCount
integer nullable
Replies to comments on the post.
data . items [] . post . reactionCount
integer nullable
The number of reactions to the post.
data . items [] . post . reactions
object
Emoji to reaction count.
data . items [] . post . restackCount
integer nullable
The number of restacks.
data . items [] . post . commentPermission
string nullable
Who may comment on the post.
data . items [] . post . coverImageUrl
string nullable
The post's cover image URL.
data . items [] . post . coverImageIsSquare
boolean nullable
Whether the cover image is square.
data . items [] . post . coverImageIsExplicit
boolean nullable
Whether the cover image is explicit.
data . items [] . post . isGeoblocked
boolean nullable
Whether the post is geoblocked.
data . items [] . post . blockedCountries array
Countries where the post is blocked.
data . items [] . post . blockedCountries []
string optional
data . items [] . post . liveStreamId
string nullable
The live stream id, when the post is a live stream.
data . items [] . post . isPublished
boolean nullable
Whether the post is published.
data . items [] . post . isPinned
boolean nullable
Whether the post is pinned.
data . items [] . post . seoTitle
string nullable
The title shown to search engines.
data . items [] . post . seoDescription
string nullable
The description shown to search engines.
data . items [] . post . socialTitle
string nullable
The title used for social previews.
data . items [] . post . previousSlug
string nullable
The previous post's slug.
data . items [] . post . nextSlug
string nullable
The next post's slug.
data . items [] . post . section object nullable
The section the post belongs to.
data . items [] . post . section . id
integer nullable
Numeric section id.
data . items [] . post . section . name
string nullable
The section's name.
data . items [] . post . section . slug
string nullable
The section's URL slug.
data . items [] . post . tags [] . id
integer nullable
Numeric tag id.
data . items [] . post . tags [] . name
string nullable
The tag's name.
data . items [] . post . tags [] . slug
string nullable
The tag's URL slug.
data . items [] . post . tags [] . hidden
boolean nullable
Whether the tag is hidden.
data . items [] . post . authors array
The post's authors.
data . items [] . post . authors [] . id
integer nullable
Numeric user id.
data . items [] . post . authors [] . name
string nullable
The name shown for the author.
data . items [] . post . authors [] . handle
string nullable
The author's handle.
data . items [] . post . authors [] . slug
string nullable
The author's profile slug.
data . items [] . post . authors [] . bio
string nullable
The author's short biography.
data . items [] . post . authors [] . photoUrl
string nullable
The author's profile photo URL.
data . items [] . post . authors [] . badge object nullable
The author's main badge, when there is one.
data . items [] . post . authors [] . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . post . authors [] . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . post . authors [] . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . post . authors [] . badge . service
string nullable
The service the badge comes from.
data . items [] . post . authors [] . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . post . authors [] . badges
object nullable
The author's reader status fields, when available.
data . items [] . post . authors [] . bestsellerTier
integer nullable
The author's bestseller tier.
data . items [] . post . authors [] . primaryPublication object nullable
The author's primary publication, when there is one.
data . items [] . post . authors [] . primaryPublication . id
integer nullable
Numeric publication id.
data . items [] . post . authors [] . primaryPublication . name
string nullable
The publication's name.
data . items [] . post . authors [] . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . post . authors [] . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . post . authors [] . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . items [] . post . podcast object nullable
Podcast metadata, when the post is an episode.
data . items [] . post . podcast . episodeNumber
integer nullable
The episode number.
data . items [] . post . podcast . seasonNumber
integer nullable
The season number.
data . items [] . post . podcast . episodeType
string nullable
The episode type.
Audio, when the post has any.
data . items [] . post . audio . url
string nullable
Audio file URL.
data . items [] . post . audio . durationSeconds
number nullable
Audio length in seconds.
data . items [] . post . audio . fileSizeBytes
integer nullable
Audio file size in bytes.
data . items [] . post . audio . mediaType
string nullable
The upload's media label, such as `audio`.
data . items [] . post . audio . episodeImageUrl
string nullable
Artwork for the episode.
data . items [] . post . audio . items array
Generated or uploaded audio items.
data . items [] . post . audio . items [] . postId
integer nullable
Numeric post id.
data . items [] . post . audio . items [] . voiceId
string nullable
The voice used for generated audio.
data . items [] . post . audio . items [] . audioUrl
string nullable
The audio file URL.
data . items [] . post . audio . items [] . type
string nullable
`tts` or Substack's own audio type.
data . items [] . post . audio . items [] . status
string nullable
The audio item's status.
Video, when the post has any.
data . items [] . post . video . durationSeconds
number nullable
Video length in seconds.
data . items [] . post . video . width
integer nullable
Video width in pixels.
data . items [] . post . video . height
integer nullable
Video height in pixels.
data . items [] . post . video . playbackId
string nullable
The playback id of the hosted video stream.
data . items [] . post . video . isMux
boolean nullable
Whether the video uses Substack's hosted player.
The note, when the item is a note.
data . items [] . note . id
integer
Numeric note id.
data . items [] . note . body
string nullable
The note's plain text.
data . items [] . note . bodyJson
object nullable
The note's rich text document, when there is one.
data . items [] . note . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . note . editedAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . note . author . id
integer nullable
Numeric user id.
data . items [] . note . author . name
string nullable
The name shown for the author.
data . items [] . note . author . handle
string nullable
The author's handle.
data . items [] . note . author . slug
string nullable
The author's profile slug.
data . items [] . note . author . bio
string nullable
The author's short biography.
data . items [] . note . author . photoUrl
string nullable
The author's profile photo URL.
data . items [] . note . author . badge object nullable
The author's main badge, when there is one.
data . items [] . note . author . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . note . author . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . note . author . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . note . author . badge . service
string nullable
The service the badge comes from.
data . items [] . note . author . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . note . author . badges
object nullable
The author's reader status fields, when available.
data . items [] . note . author . bestsellerTier
integer nullable
The author's bestseller tier.
data . items [] . note . author . primaryPublication object nullable
The author's primary publication, when there is one.
data . items [] . note . author . primaryPublication . id
integer nullable
Numeric publication id.
data . items [] . note . author . primaryPublication . name
string nullable
The publication's name.
data . items [] . note . author . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . note . author . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . note . author . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . items [] . note . reactionCount
integer nullable
The number of reactions.
data . items [] . note . reactions
object
Emoji to reaction count.
data . items [] . note . restackCount
integer nullable
The number of restacks.
data . items [] . note . replyCount
integer nullable
The number of replies.
data . items [] . note . language
string nullable
The note's language code.
data . items [] . note . isAiGenerated
boolean nullable
Substack's own flag.
data . items [] . note . translation
object nullable
A translation of the note, when there is one.
data . items [] . note . replyPermission
string nullable
Who may reply to the note.
data . items [] . note . ancestorPath
string nullable
The note's position in a thread.
data . items [] . note . attachments array
Images, links, posts or polls attached to the note.
data . items [] . note . attachments [] . id
string nullable
The attachment's id.
data . items [] . note . attachments [] . type
string nullable
`image`, `link`, `post`, `poll` or `missing`.
data . items [] . note . attachments [] . imageUrl
string nullable
The image URL, for an image attachment.
data . items [] . note . attachments [] . imageWidth
integer nullable
The image width in pixels.
data . items [] . note . attachments [] . imageHeight
integer nullable
The image height in pixels.
data . items [] . note . attachments [] . explicit
boolean nullable
Whether the attachment is explicit.
data . items [] . note . attachments [] . link object nullable
Preview metadata for a link attachment.
data . items [] . note . attachments [] . link . url
string nullable
The link's URL.
data . items [] . note . attachments [] . link . host
string nullable
The link's host.
data . items [] . note . attachments [] . link . title
string nullable
The link's title.
data . items [] . note . attachments [] . link . description
string nullable
The link's description.
data . items [] . note . attachments [] . link . image
string nullable
The link's preview image URL.
data . items [] . note . attachments [] . link . originalImage
string nullable
The link's original image URL.
data . items [] . note . attachments [] . postId
integer nullable
The attached post's id.
data . items [] . note . attachments [] . publicationId
integer nullable
The attached publication's id.
data . items [] . note . attachments [] . reason
string nullable
Why a missing attachment was removed.
The publication behind the item.
data . items [] . publication . id
integer
Numeric publication id.
data . items [] . publication . name
string nullable
The publication's name.
data . items [] . publication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . publication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . publication . apexDomain
string nullable
The publication's apex domain, when it has one.
data . items [] . publication . url
string nullable
The publication's canonical base URL.
data . items [] . publication . host
string nullable
The host its pages are served from.
data . items [] . publication . description
string nullable
The publication's description.
data . items [] . publication . language
string nullable
The publication's language code.
data . items [] . publication . kind
string nullable
`newsletter`, `podcast` or Substack's own type.
data . items [] . publication . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . publication . firstPostAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . publication . hasPosts
boolean nullable
Whether the publication has posts.
data . items [] . publication . isExplicit
boolean nullable
Whether the publication is marked explicit.
data . items [] . publication . isInviteOnly
boolean nullable
Whether the publication is invite-only.
data . items [] . publication . isFlagged
boolean nullable
Whether the publication is flagged.
data . items [] . publication . noIndex
boolean nullable
Whether search engines are asked not to index it.
data . items [] . publication . isOnSubstack
boolean nullable
Whether the publication is hosted by Substack.
data . items [] . publication . commentsEnabled
boolean nullable
Whether comments are enabled.
data . items [] . publication . notesEnabled
boolean nullable
Whether Notes are enabled.
data . items [] . publication . defaultCommentSort
string nullable
The default comment order.
data . items [] . publication . annualDisabled
boolean nullable
Whether annual plans are disabled.
data . items [] . publication . monthlyDisabled
boolean nullable
Whether monthly plans are disabled.
data . items [] . publication . paymentsState
string nullable
The publication's payments state.
data . items [] . publication . freeTrialEnabled
boolean nullable
Whether a free trial is offered.
data . items [] . publication . pausedUntil
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . publication . emailBannerUrl
string nullable
The email banner image URL.
data . items [] . publication . copyright
string nullable
The copyright line the publication prints.
data . items [] . publication . logoUrl
string nullable
The publication's logo URL.
data . items [] . publication . wideLogoUrl
string nullable
The publication's wide logo URL.
data . items [] . publication . coverImageUrl
string nullable
The publication's cover image URL.
data . items [] . publication . foundingPlanName
string nullable
The name of the founding-member plan.
data . items [] . publication . hasRecommendations
boolean nullable
Whether the publication recommends others.
data . items [] . publication . benefits object
The benefit lists for each subscription tier.
data . items [] . publication . benefits . free array
Benefits for free subscribers.
data . items [] . publication . benefits . free []
string optional
data . items [] . publication . benefits . paid array
Benefits for paid subscribers.
data . items [] . publication . benefits . paid []
string optional
data . items [] . publication . benefits . founding array
Benefits for founding members.
data . items [] . publication . benefits . founding []
string optional
data . items [] . publication . author object
The publication's main author.
data . items [] . publication . author . id
integer nullable
Numeric user id.
data . items [] . publication . author . name
string nullable
The name shown for the author.
data . items [] . publication . author . handle
string nullable
The author's handle.
data . items [] . publication . author . slug
string nullable
The author's profile slug.
data . items [] . publication . author . bio
string nullable
The author's short biography.
data . items [] . publication . author . photoUrl
string nullable
The author's profile photo URL.
data . items [] . publication . author . badge object nullable
The author's main badge, when there is one.
data . items [] . publication . author . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . publication . author . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . publication . author . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . publication . author . badge . service
string nullable
The service the badge comes from.
data . items [] . publication . author . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . publication . author . badges
object nullable
The author's reader status fields, when available.
data . items [] . publication . author . bestsellerTier
integer nullable
The author's bestseller tier.
data . items [] . publication . author . primaryPublication object nullable
The author's primary publication, when there is one.
data . items [] . publication . author . primaryPublication . id
integer nullable
Numeric publication id.
data . items [] . publication . author . primaryPublication . name
string nullable
The publication's name.
data . items [] . publication . author . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . publication . author . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . publication . author . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . items [] . publication . audience object
Approximate audience figures the publication prints. These are bands, not counts.
data . items [] . publication . audience . paidLabel
string nullable
The band Substack displays for paid subscribers.
data . items [] . publication . audience . paidOrderOfMagnitude
integer nullable
The order of magnitude behind the paid band.
data . items [] . publication . audience . totalLabel
string nullable
The band Substack displays for all subscribers.
data . items [] . publication . audience . totalOrderOfMagnitude
integer nullable
The order of magnitude behind the total band.
data . items [] . publication . audience . freeLabel
string nullable
The band Substack displays for free subscribers.
data . items [] . publication . audience . freeShort
string nullable
The short free-subscriber band.
data . items [] . publication . audience . chatMembersLabel
string nullable
The band Substack displays for chat members.
data . items [] . publication . contributors array
People with a byline on the publication.
data . items [] . publication . contributors [] . id
integer nullable
Numeric user id.
data . items [] . publication . contributors [] . name
string nullable
The contributor's name.
data . items [] . publication . contributors [] . handle
string nullable
The contributor's handle.
data . items [] . publication . contributors [] . role
string nullable
The contributor's role on the publication.
data . items [] . publication . contributors [] . owner
boolean nullable
Whether the contributor owns the publication.
data . items [] . publication . contributors [] . photoUrl
string nullable
The contributor's photo URL.
data . items [] . publication . contributors [] . bio
string nullable
The contributor's short biography.
data . items [] . publication . contributors [] . badge object nullable
The contributor's badge.
data . items [] . publication . contributors [] . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . publication . contributors [] . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . publication . contributors [] . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . publication . contributors [] . badge . service
string nullable
The service the badge comes from.
data . items [] . publication . contributors [] . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . publication . contributors [] . bestsellerTier
integer nullable
The contributor's bestseller tier.
data . items [] . publication . sections array
The publication's sections.
data . items [] . publication . sections [] . id
integer nullable
Numeric section id.
data . items [] . publication . sections [] . name
string nullable
The section's name.
data . items [] . publication . sections [] . description
string nullable
The section's description.
data . items [] . publication . sections [] . slug
string nullable
The section's URL slug.
data . items [] . publication . sections [] . isPodcast
boolean nullable
Whether the section is a podcast.
data . items [] . publication . sections [] . isLive
boolean nullable
Whether the section is a live stream.
data . items [] . publication . sections [] . isDefaultOn
boolean nullable
Whether the section is on by default.
data . items [] . publication . sections [] . logoUrl
string nullable
The section's logo URL.
data . items [] . publication . sections [] . coverImageUrl
string nullable
The section's cover image URL.
data . items [] . publication . sections [] . hideFromNavbar
boolean nullable
Whether the section is hidden from navigation.
data . items [] . publication . sections [] . hidePostsFromPubListings
boolean nullable
Whether the section's posts are hidden from publication lists.
data . items [] . publication . links array
Links the publication shows.
data . items [] . publication . links [] . id
integer nullable
Numeric link id.
data . items [] . publication . links [] . url
string
The link.
data . items [] . publication . links [] . platform
string nullable
`apple_podcasts`, `spotify`, `youtube` or another label Substack uses.
data . items [] . publication . links [] . sectionId
integer nullable
The section the link belongs to, when it has one.
data . items [] . publication . plans array
The subscription plans the publication offers.
data . items [] . publication . plans [] . id
string nullable
The plan's id.
data . items [] . publication . plans [] . nickname
string nullable
The plan's display name.
data . items [] . publication . plans [] . amount
integer nullable
Price in the currency's minor unit.
data . items [] . publication . plans [] . currency
string nullable
Currency code for the price.
data . items [] . publication . plans [] . interval
string nullable
`month`, `year` or Substack's own value.
data . items [] . publication . plans [] . intervalCount
integer nullable
How many intervals one charge covers.
data . items [] . publication . plans [] . active
boolean nullable
Whether the plan is on sale.
data . items [] . publication . plans [] . founding
boolean
Whether this is a founding-member plan.
data . items [] . publication . podcast object
The publication's podcast, when it has one.
data . items [] . publication . podcast . exists
boolean nullable
Whether the publication has a podcast.
data . items [] . publication . podcast . hasFreeEpisodes
boolean nullable
Whether free episodes are available.
data . items [] . publication . podcast . hasPaidEpisodes
boolean nullable
Whether paid episodes are available.
data . items [] . publication . podcast . artUrl
string nullable
The podcast artwork URL.
data . items [] . publication . podcast . byline
string nullable
The podcast byline.
data . items [] . publication . podcast . description
string nullable
The podcast description.
data . items [] . publication . podcast . feedUrl
string nullable
The podcast feed URL.
data . items [] . publication . podcast . title
string nullable
The podcast title.
data . items [] . publication . podcast . paidEpisodeArtUrl
string nullable
Artwork for paid episodes.
Matching profiles, when the item is a profile block.
data . items [] . profiles [] . id
integer
Numeric user id.
data . items [] . profiles [] . name
string nullable
The reader's display name.
data . items [] . profiles [] . handle
string nullable
The reader's handle.
data . items [] . profiles [] . slug
string nullable
The reader's profile slug.
data . items [] . profiles [] . bio
string nullable
The reader's short biography.
data . items [] . profiles [] . photoUrl
string nullable
The reader's profile photo URL.
data . items [] . profiles [] . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . profiles [] . isDisabled
boolean nullable
Whether the profile is disabled.
data . items [] . profiles [] . followerCount
integer nullable
The number of followers.
data . items [] . profiles [] . subscriberCount
integer nullable
The numeric count.
data . items [] . profiles [] . subscriberCountLabel
string nullable
The label Substack displays.
data . items [] . profiles [] . roughFreeSubscribers
string nullable
The free-subscriber band Substack displays.
data . items [] . profiles [] . roughFreeSubscribersInt
integer nullable
The numeric value behind the free band.
data . items [] . profiles [] . roughSubscribers
string nullable
The subscriber band Substack displays.
data . items [] . profiles [] . roughSubscribersInt
integer nullable
The numeric value behind the subscriber band.
data . items [] . profiles [] . badges
object nullable
The reader's status fields, when available.
data . items [] . profiles [] . bestsellerTier
integer nullable
The reader's bestseller tier.
data . items [] . profiles [] . leaderboard object nullable
The reader's leaderboard position.
data . items [] . profiles [] . leaderboard . category
string nullable
The leaderboard category.
data . items [] . profiles [] . leaderboard . rank
integer nullable
The rank in that category.
data . items [] . profiles [] . leaderboard . ranking
string nullable
`paid`, `free` or Substack's own label.
data . items [] . profiles [] . leaderboard . publicationId
integer nullable
Numeric publication id.
data . items [] . profiles [] . leaderboard . publicationName
string nullable
The publication's name.
data . items [] . profiles [] . links array
Links the reader shows.
data . items [] . profiles [] . links [] . id
integer nullable
Numeric link id.
data . items [] . profiles [] . links [] . value
string nullable
The value the person entered for the link.
data . items [] . profiles [] . links [] . url
string nullable
The link's URL.
data . items [] . profiles [] . links [] . type
string nullable
The link type, such as `twitter`.
data . items [] . profiles [] . links [] . label
string nullable
The label shown for the link.
data . items [] . profiles [] . publicationUrl
string nullable
The reader's publication URL.
data . items [] . profiles [] . hasNotes
boolean nullable
Whether the reader has Notes.
data . items [] . profiles [] . hasGuestPost
boolean nullable
Whether the reader has a guest post.
data . items [] . profiles [] . hasLikes
boolean nullable
Whether the reader has likes.
data . items [] . profiles [] . hasPosts
boolean nullable
Whether the reader has posts.
data . items [] . profiles [] . recommendationCount
integer nullable
The number of recommendations.
data . items [] . profiles [] . primaryPublication object nullable
The reader's primary publication.
data . items [] . profiles [] . primaryPublication . id
integer
Numeric publication id.
data . items [] . profiles [] . primaryPublication . name
string nullable
The publication's name.
data . items [] . profiles [] . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . profiles [] . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . profiles [] . primaryPublication . apexDomain
string nullable
The publication's apex domain, when it has one.
data . items [] . profiles [] . primaryPublication . url
string nullable
The publication's canonical base URL.
data . items [] . profiles [] . primaryPublication . host
string nullable
The host its pages are served from.
data . items [] . profiles [] . primaryPublication . description
string nullable
The publication's description.
data . items [] . profiles [] . primaryPublication . language
string nullable
The publication's language code.
data . items [] . profiles [] . primaryPublication . kind
string nullable
`newsletter`, `podcast` or Substack's own type.
data . items [] . profiles [] . primaryPublication . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . profiles [] . primaryPublication . firstPostAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . profiles [] . primaryPublication . hasPosts
boolean nullable
Whether the publication has posts.
data . items [] . profiles [] . primaryPublication . isExplicit
boolean nullable
Whether the publication is marked explicit.
data . items [] . profiles [] . primaryPublication . isInviteOnly
boolean nullable
Whether the publication is invite-only.
data . items [] . profiles [] . primaryPublication . isFlagged
boolean nullable
Whether the publication is flagged.
data . items [] . profiles [] . primaryPublication . noIndex
boolean nullable
Whether search engines are asked not to index it.
data . items [] . profiles [] . primaryPublication . isOnSubstack
boolean nullable
Whether the publication is hosted by Substack.
data . items [] . profiles [] . primaryPublication . commentsEnabled
boolean nullable
Whether comments are enabled.
data . items [] . profiles [] . primaryPublication . notesEnabled
boolean nullable
Whether Notes are enabled.
data . items [] . profiles [] . primaryPublication . defaultCommentSort
string nullable
The default comment order.
data . items [] . profiles [] . primaryPublication . annualDisabled
boolean nullable
Whether annual plans are disabled.
data . items [] . profiles [] . primaryPublication . monthlyDisabled
boolean nullable
Whether monthly plans are disabled.
data . items [] . profiles [] . primaryPublication . paymentsState
string nullable
The publication's payments state.
data . items [] . profiles [] . primaryPublication . freeTrialEnabled
boolean nullable
Whether a free trial is offered.
data . items [] . profiles [] . primaryPublication . pausedUntil
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . profiles [] . primaryPublication . emailBannerUrl
string nullable
The email banner image URL.
data . items [] . profiles [] . primaryPublication . copyright
string nullable
The copyright line the publication prints.
data . items [] . profiles [] . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . items [] . profiles [] . primaryPublication . wideLogoUrl
string nullable
The publication's wide logo URL.
data . items [] . profiles [] . primaryPublication . coverImageUrl
string nullable
The publication's cover image URL.
data . items [] . profiles [] . primaryPublication . foundingPlanName
string nullable
The name of the founding-member plan.
data . items [] . profiles [] . primaryPublication . hasRecommendations
boolean nullable
Whether the publication recommends others.
data . items [] . profiles [] . primaryPublication . benefits object
The benefit lists for each subscription tier.
data . items [] . profiles [] . primaryPublication . benefits . free array
Benefits for free subscribers.
data . items [] . profiles [] . primaryPublication . benefits . free []
string optional
data . items [] . profiles [] . primaryPublication . benefits . paid array
Benefits for paid subscribers.
data . items [] . profiles [] . primaryPublication . benefits . paid []
string optional
data . items [] . profiles [] . primaryPublication . benefits . founding array
Benefits for founding members.
data . items [] . profiles [] . primaryPublication . benefits . founding []
string optional
data . items [] . profiles [] . primaryPublication . author object
The publication's main author.
data . items [] . profiles [] . primaryPublication . author . id
integer nullable
Numeric user id.
data . items [] . profiles [] . primaryPublication . author . name
string nullable
The name shown for the author.
data . items [] . profiles [] . primaryPublication . author . handle
string nullable
The author's handle.
data . items [] . profiles [] . primaryPublication . author . slug
string nullable
The author's profile slug.
data . items [] . profiles [] . primaryPublication . author . bio
string nullable
The author's short biography.
data . items [] . profiles [] . primaryPublication . author . photoUrl
string nullable
The author's profile photo URL.
data . items [] . profiles [] . primaryPublication . author . badge object nullable
The author's main badge, when there is one.
data . items [] . profiles [] . primaryPublication . author . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . profiles [] . primaryPublication . author . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . profiles [] . primaryPublication . author . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . profiles [] . primaryPublication . author . badge . service
string nullable
The service the badge comes from.
data . items [] . profiles [] . primaryPublication . author . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . profiles [] . primaryPublication . author . badges
object nullable
The author's reader status fields, when available.
data . items [] . profiles [] . primaryPublication . author . bestsellerTier
integer nullable
The author's bestseller tier.
data . items [] . profiles [] . primaryPublication . author . primaryPublication object nullable
The author's primary publication, when there is one.
data . items [] . profiles [] . primaryPublication . author . primaryPublication . id
integer nullable
Numeric publication id.
data . items [] . profiles [] . primaryPublication . author . primaryPublication . name
string nullable
The publication's name.
data . items [] . profiles [] . primaryPublication . author . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . profiles [] . primaryPublication . author . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . profiles [] . primaryPublication . author . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . items [] . profiles [] . primaryPublication . audience object
Approximate audience figures the publication prints. These are bands, not counts.
data . items [] . profiles [] . primaryPublication . audience . paidLabel
string nullable
The band Substack displays for paid subscribers.
data . items [] . profiles [] . primaryPublication . audience . paidOrderOfMagnitude
integer nullable
The order of magnitude behind the paid band.
data . items [] . profiles [] . primaryPublication . audience . totalLabel
string nullable
The band Substack displays for all subscribers.
data . items [] . profiles [] . primaryPublication . audience . totalOrderOfMagnitude
integer nullable
The order of magnitude behind the total band.
data . items [] . profiles [] . primaryPublication . audience . freeLabel
string nullable
The band Substack displays for free subscribers.
data . items [] . profiles [] . primaryPublication . audience . freeShort
string nullable
The short free-subscriber band.
data . items [] . profiles [] . primaryPublication . audience . chatMembersLabel
string nullable
The band Substack displays for chat members.
data . items [] . profiles [] . primaryPublication . contributors array
People with a byline on the publication.
data . items [] . profiles [] . primaryPublication . contributors [] . id
integer nullable
Numeric user id.
data . items [] . profiles [] . primaryPublication . contributors [] . name
string nullable
The contributor's name.
data . items [] . profiles [] . primaryPublication . contributors [] . handle
string nullable
The contributor's handle.
data . items [] . profiles [] . primaryPublication . contributors [] . role
string nullable
The contributor's role on the publication.
data . items [] . profiles [] . primaryPublication . contributors [] . owner
boolean nullable
Whether the contributor owns the publication.
data . items [] . profiles [] . primaryPublication . contributors [] . photoUrl
string nullable
The contributor's photo URL.
data . items [] . profiles [] . primaryPublication . contributors [] . bio
string nullable
The contributor's short biography.
data . items [] . profiles [] . primaryPublication . contributors [] . badge object nullable
The contributor's badge.
data . items [] . profiles [] . primaryPublication . contributors [] . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . profiles [] . primaryPublication . contributors [] . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . profiles [] . primaryPublication . contributors [] . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . profiles [] . primaryPublication . contributors [] . badge . service
string nullable
The service the badge comes from.
data . items [] . profiles [] . primaryPublication . contributors [] . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . profiles [] . primaryPublication . contributors [] . bestsellerTier
integer nullable
The contributor's bestseller tier.
data . items [] . profiles [] . primaryPublication . sections array
The publication's sections.
data . items [] . profiles [] . primaryPublication . sections [] . id
integer nullable
Numeric section id.
data . items [] . profiles [] . primaryPublication . sections [] . name
string nullable
The section's name.
data . items [] . profiles [] . primaryPublication . sections [] . description
string nullable
The section's description.
data . items [] . profiles [] . primaryPublication . sections [] . slug
string nullable
The section's URL slug.
data . items [] . profiles [] . primaryPublication . sections [] . isPodcast
boolean nullable
Whether the section is a podcast.
data . items [] . profiles [] . primaryPublication . sections [] . isLive
boolean nullable
Whether the section is a live stream.
data . items [] . profiles [] . primaryPublication . sections [] . isDefaultOn
boolean nullable
Whether the section is on by default.
data . items [] . profiles [] . primaryPublication . sections [] . logoUrl
string nullable
The section's logo URL.
data . items [] . profiles [] . primaryPublication . sections [] . coverImageUrl
string nullable
The section's cover image URL.
data . items [] . profiles [] . primaryPublication . sections [] . hideFromNavbar
boolean nullable
Whether the section is hidden from navigation.
data . items [] . profiles [] . primaryPublication . sections [] . hidePostsFromPubListings
boolean nullable
Whether the section's posts are hidden from publication lists.
data . items [] . profiles [] . primaryPublication . links array
Links the publication shows.
data . items [] . profiles [] . primaryPublication . links [] . id
integer nullable
Numeric link id.
data . items [] . profiles [] . primaryPublication . links [] . url
string
The link.
data . items [] . profiles [] . primaryPublication . links [] . platform
string nullable
`apple_podcasts`, `spotify`, `youtube` or another label Substack uses.
data . items [] . profiles [] . primaryPublication . links [] . sectionId
integer nullable
The section the link belongs to, when it has one.
data . items [] . profiles [] . primaryPublication . plans array
The subscription plans the publication offers.
data . items [] . profiles [] . primaryPublication . plans [] . id
string nullable
The plan's id.
data . items [] . profiles [] . primaryPublication . plans [] . nickname
string nullable
The plan's display name.
data . items [] . profiles [] . primaryPublication . plans [] . amount
integer nullable
Price in the currency's minor unit.
data . items [] . profiles [] . primaryPublication . plans [] . currency
string nullable
Currency code for the price.
data . items [] . profiles [] . primaryPublication . plans [] . interval
string nullable
`month`, `year` or Substack's own value.
data . items [] . profiles [] . primaryPublication . plans [] . intervalCount
integer nullable
How many intervals one charge covers.
data . items [] . profiles [] . primaryPublication . plans [] . active
boolean nullable
Whether the plan is on sale.
data . items [] . profiles [] . primaryPublication . plans [] . founding
boolean
Whether this is a founding-member plan.
data . items [] . profiles [] . primaryPublication . podcast object
The publication's podcast, when it has one.
data . items [] . profiles [] . primaryPublication . podcast . exists
boolean nullable
Whether the publication has a podcast.
data . items [] . profiles [] . primaryPublication . podcast . hasFreeEpisodes
boolean nullable
Whether free episodes are available.
data . items [] . profiles [] . primaryPublication . podcast . hasPaidEpisodes
boolean nullable
Whether paid episodes are available.
data . items [] . profiles [] . primaryPublication . podcast . artUrl
string nullable
The podcast artwork URL.
data . items [] . profiles [] . primaryPublication . podcast . byline
string nullable
The podcast byline.
data . items [] . profiles [] . primaryPublication . podcast . description
string nullable
The podcast description.
data . items [] . profiles [] . primaryPublication . podcast . feedUrl
string nullable
The podcast feed URL.
data . items [] . profiles [] . primaryPublication . podcast . title
string nullable
The podcast title.
data . items [] . profiles [] . primaryPublication . podcast . paidEpisodeArtUrl
string nullable
Artwork for paid episodes.
data . items [] . profiles [] . publications array
Publications the reader writes for.
data . items [] . profiles [] . publications [] . role
string nullable
The person's role on the publication.
data . items [] . profiles [] . publications [] . public
boolean nullable
Whether the role is shown publicly.
data . items [] . profiles [] . publications [] . isPrimary
boolean nullable
Whether this is the person's primary publication.
data . items [] . profiles [] . publications [] . publication object
A Substack publication.
data . items [] . profiles [] . publications [] . publication . id
integer
Numeric publication id.
data . items [] . profiles [] . publications [] . publication . name
string nullable
The publication's name.
data . items [] . profiles [] . publications [] . publication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . profiles [] . publications [] . publication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . profiles [] . publications [] . publication . apexDomain
string nullable
The publication's apex domain, when it has one.
data . items [] . profiles [] . publications [] . publication . url
string nullable
The publication's canonical base URL.
data . items [] . profiles [] . publications [] . publication . host
string nullable
The host its pages are served from.
data . items [] . profiles [] . publications [] . publication . description
string nullable
The publication's description.
data . items [] . profiles [] . publications [] . publication . language
string nullable
The publication's language code.
data . items [] . profiles [] . publications [] . publication . kind
string nullable
`newsletter`, `podcast` or Substack's own type.
data . items [] . profiles [] . publications [] . publication . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . profiles [] . publications [] . publication . firstPostAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . profiles [] . publications [] . publication . hasPosts
boolean nullable
Whether the publication has posts.
data . items [] . profiles [] . publications [] . publication . isExplicit
boolean nullable
Whether the publication is marked explicit.
data . items [] . profiles [] . publications [] . publication . isInviteOnly
boolean nullable
Whether the publication is invite-only.
data . items [] . profiles [] . publications [] . publication . isFlagged
boolean nullable
Whether the publication is flagged.
data . items [] . profiles [] . publications [] . publication . noIndex
boolean nullable
Whether search engines are asked not to index it.
data . items [] . profiles [] . publications [] . publication . isOnSubstack
boolean nullable
Whether the publication is hosted by Substack.
data . items [] . profiles [] . publications [] . publication . commentsEnabled
boolean nullable
Whether comments are enabled.
data . items [] . profiles [] . publications [] . publication . notesEnabled
boolean nullable
Whether Notes are enabled.
data . items [] . profiles [] . publications [] . publication . defaultCommentSort
string nullable
The default comment order.
data . items [] . profiles [] . publications [] . publication . annualDisabled
boolean nullable
Whether annual plans are disabled.
data . items [] . profiles [] . publications [] . publication . monthlyDisabled
boolean nullable
Whether monthly plans are disabled.
data . items [] . profiles [] . publications [] . publication . paymentsState
string nullable
The publication's payments state.
data . items [] . profiles [] . publications [] . publication . freeTrialEnabled
boolean nullable
Whether a free trial is offered.
data . items [] . profiles [] . publications [] . publication . pausedUntil
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . profiles [] . publications [] . publication . emailBannerUrl
string nullable
The email banner image URL.
data . items [] . profiles [] . publications [] . publication . copyright
string nullable
The copyright line the publication prints.
data . items [] . profiles [] . publications [] . publication . logoUrl
string nullable
The publication's logo URL.
data . items [] . profiles [] . publications [] . publication . wideLogoUrl
string nullable
The publication's wide logo URL.
data . items [] . profiles [] . publications [] . publication . coverImageUrl
string nullable
The publication's cover image URL.
data . items [] . profiles [] . publications [] . publication . foundingPlanName
string nullable
The name of the founding-member plan.
data . items [] . profiles [] . publications [] . publication . hasRecommendations
boolean nullable
Whether the publication recommends others.
data . items [] . profiles [] . publications [] . publication . benefits object
The benefit lists for each subscription tier.
data . items [] . profiles [] . publications [] . publication . benefits . free array
Benefits for free subscribers.
data . items [] . profiles [] . publications [] . publication . benefits . free []
string optional
data . items [] . profiles [] . publications [] . publication . benefits . paid array
Benefits for paid subscribers.
data . items [] . profiles [] . publications [] . publication . benefits . paid []
string optional
data . items [] . profiles [] . publications [] . publication . benefits . founding array
Benefits for founding members.
data . items [] . profiles [] . publications [] . publication . benefits . founding []
string optional
data . items [] . profiles [] . publications [] . publication . author object
The publication's main author.
data . items [] . profiles [] . publications [] . publication . author . id
integer nullable
Numeric user id.
data . items [] . profiles [] . publications [] . publication . author . name
string nullable
The name shown for the author.
data . items [] . profiles [] . publications [] . publication . author . handle
string nullable
The author's handle.
data . items [] . profiles [] . publications [] . publication . author . slug
string nullable
The author's profile slug.
data . items [] . profiles [] . publications [] . publication . author . bio
string nullable
The author's short biography.
data . items [] . profiles [] . publications [] . publication . author . photoUrl
string nullable
The author's profile photo URL.
data . items [] . profiles [] . publications [] . publication . author . badge object nullable
The author's main badge, when there is one.
data . items [] . profiles [] . publications [] . publication . author . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . profiles [] . publications [] . publication . author . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . profiles [] . publications [] . publication . author . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . profiles [] . publications [] . publication . author . badge . service
string nullable
The service the badge comes from.
data . items [] . profiles [] . publications [] . publication . author . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . profiles [] . publications [] . publication . author . badges
object nullable
The author's reader status fields, when available.
data . items [] . profiles [] . publications [] . publication . author . bestsellerTier
integer nullable
The author's bestseller tier.
data . items [] . profiles [] . publications [] . publication . author . primaryPublication object nullable
The author's primary publication, when there is one.
data . items [] . profiles [] . publications [] . publication . author . primaryPublication . id
integer nullable
Numeric publication id.
data . items [] . profiles [] . publications [] . publication . author . primaryPublication . name
string nullable
The publication's name.
data . items [] . profiles [] . publications [] . publication . author . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . profiles [] . publications [] . publication . author . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . profiles [] . publications [] . publication . author . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . items [] . profiles [] . publications [] . publication . audience object
Approximate audience figures the publication prints. These are bands, not counts.
data . items [] . profiles [] . publications [] . publication . audience . paidLabel
string nullable
The band Substack displays for paid subscribers.
data . items [] . profiles [] . publications [] . publication . audience . paidOrderOfMagnitude
integer nullable
The order of magnitude behind the paid band.
data . items [] . profiles [] . publications [] . publication . audience . totalLabel
string nullable
The band Substack displays for all subscribers.
data . items [] . profiles [] . publications [] . publication . audience . totalOrderOfMagnitude
integer nullable
The order of magnitude behind the total band.
data . items [] . profiles [] . publications [] . publication . audience . freeLabel
string nullable
The band Substack displays for free subscribers.
data . items [] . profiles [] . publications [] . publication . audience . freeShort
string nullable
The short free-subscriber band.
data . items [] . profiles [] . publications [] . publication . audience . chatMembersLabel
string nullable
The band Substack displays for chat members.
data . items [] . profiles [] . publications [] . publication . contributors array
People with a byline on the publication.
data . items [] . profiles [] . publications [] . publication . contributors [] . id
integer nullable
Numeric user id.
data . items [] . profiles [] . publications [] . publication . contributors [] . name
string nullable
The contributor's name.
data . items [] . profiles [] . publications [] . publication . contributors [] . handle
string nullable
The contributor's handle.
data . items [] . profiles [] . publications [] . publication . contributors [] . role
string nullable
The contributor's role on the publication.
data . items [] . profiles [] . publications [] . publication . contributors [] . owner
boolean nullable
Whether the contributor owns the publication.
data . items [] . profiles [] . publications [] . publication . contributors [] . photoUrl
string nullable
The contributor's photo URL.
data . items [] . profiles [] . publications [] . publication . contributors [] . bio
string nullable
The contributor's short biography.
data . items [] . profiles [] . publications [] . publication . contributors [] . badge object nullable
The contributor's badge.
data . items [] . profiles [] . publications [] . publication . contributors [] . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . profiles [] . publications [] . publication . contributors [] . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . profiles [] . publications [] . publication . contributors [] . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . profiles [] . publications [] . publication . contributors [] . badge . service
string nullable
The service the badge comes from.
data . items [] . profiles [] . publications [] . publication . contributors [] . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . profiles [] . publications [] . publication . contributors [] . bestsellerTier
integer nullable
The contributor's bestseller tier.
data . items [] . profiles [] . publications [] . publication . sections array
The publication's sections.
data . items [] . profiles [] . publications [] . publication . sections [] . id
integer nullable
Numeric section id.
data . items [] . profiles [] . publications [] . publication . sections [] . name
string nullable
The section's name.
data . items [] . profiles [] . publications [] . publication . sections [] . description
string nullable
The section's description.
data . items [] . profiles [] . publications [] . publication . sections [] . slug
string nullable
The section's URL slug.
data . items [] . profiles [] . publications [] . publication . sections [] . isPodcast
boolean nullable
Whether the section is a podcast.
data . items [] . profiles [] . publications [] . publication . sections [] . isLive
boolean nullable
Whether the section is a live stream.
data . items [] . profiles [] . publications [] . publication . sections [] . isDefaultOn
boolean nullable
Whether the section is on by default.
data . items [] . profiles [] . publications [] . publication . sections [] . logoUrl
string nullable
The section's logo URL.
data . items [] . profiles [] . publications [] . publication . sections [] . coverImageUrl
string nullable
The section's cover image URL.
data . items [] . profiles [] . publications [] . publication . sections [] . hideFromNavbar
boolean nullable
Whether the section is hidden from navigation.
data . items [] . profiles [] . publications [] . publication . sections [] . hidePostsFromPubListings
boolean nullable
Whether the section's posts are hidden from publication lists.
data . items [] . profiles [] . publications [] . publication . links array
Links the publication shows.
data . items [] . profiles [] . publications [] . publication . links [] . id
integer nullable
Numeric link id.
data . items [] . profiles [] . publications [] . publication . links [] . url
string
The link.
data . items [] . profiles [] . publications [] . publication . links [] . platform
string nullable
`apple_podcasts`, `spotify`, `youtube` or another label Substack uses.
data . items [] . profiles [] . publications [] . publication . links [] . sectionId
integer nullable
The section the link belongs to, when it has one.
data . items [] . profiles [] . publications [] . publication . plans array
The subscription plans the publication offers.
data . items [] . profiles [] . publications [] . publication . plans [] . id
string nullable
The plan's id.
data . items [] . profiles [] . publications [] . publication . plans [] . nickname
string nullable
The plan's display name.
data . items [] . profiles [] . publications [] . publication . plans [] . amount
integer nullable
Price in the currency's minor unit.
data . items [] . profiles [] . publications [] . publication . plans [] . currency
string nullable
Currency code for the price.
data . items [] . profiles [] . publications [] . publication . plans [] . interval
string nullable
`month`, `year` or Substack's own value.
data . items [] . profiles [] . publications [] . publication . plans [] . intervalCount
integer nullable
How many intervals one charge covers.
data . items [] . profiles [] . publications [] . publication . plans [] . active
boolean nullable
Whether the plan is on sale.
data . items [] . profiles [] . publications [] . publication . plans [] . founding
boolean
Whether this is a founding-member plan.
data . items [] . profiles [] . publications [] . publication . podcast object
The publication's podcast, when it has one.
data . items [] . profiles [] . publications [] . publication . podcast . exists
boolean nullable
Whether the publication has a podcast.
data . items [] . profiles [] . publications [] . publication . podcast . hasFreeEpisodes
boolean nullable
Whether free episodes are available.
data . items [] . profiles [] . publications [] . publication . podcast . hasPaidEpisodes
boolean nullable
Whether paid episodes are available.
data . items [] . profiles [] . publications [] . publication . podcast . artUrl
string nullable
The podcast artwork URL.
data . items [] . profiles [] . publications [] . publication . podcast . byline
string nullable
The podcast byline.
data . items [] . profiles [] . publications [] . publication . podcast . description
string nullable
The podcast description.
data . items [] . profiles [] . publications [] . publication . podcast . feedUrl
string nullable
The podcast feed URL.
data . items [] . profiles [] . publications [] . publication . podcast . title
string nullable
The podcast title.
data . items [] . profiles [] . publications [] . publication . podcast . paidEpisodeArtUrl
string nullable
Artwork for paid episodes.
data . items [] . profiles [] . subscriptions array
Publications the reader shows publicly.
data . items [] . profiles [] . subscriptions [] . id
integer nullable
Numeric subscription id.
data . items [] . profiles [] . subscriptions [] . visibility
string nullable
Who can see the subscription.
data . items [] . profiles [] . subscriptions [] . membershipState
string nullable
The person's membership state.
data . items [] . profiles [] . subscriptions [] . type
string nullable
The subscription type.
data . items [] . profiles [] . subscriptions [] . isFounding
boolean nullable
Whether this is a founding membership.
data . items [] . profiles [] . subscriptions [] . publication object
A Substack publication.
data . items [] . profiles [] . subscriptions [] . publication . id
integer
Numeric publication id.
data . items [] . profiles [] . subscriptions [] . publication . name
string nullable
The publication's name.
data . items [] . profiles [] . subscriptions [] . publication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . profiles [] . subscriptions [] . publication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . profiles [] . subscriptions [] . publication . apexDomain
string nullable
The publication's apex domain, when it has one.
data . items [] . profiles [] . subscriptions [] . publication . url
string nullable
The publication's canonical base URL.
data . items [] . profiles [] . subscriptions [] . publication . host
string nullable
The host its pages are served from.
data . items [] . profiles [] . subscriptions [] . publication . description
string nullable
The publication's description.
data . items [] . profiles [] . subscriptions [] . publication . language
string nullable
The publication's language code.
data . items [] . profiles [] . subscriptions [] . publication . kind
string nullable
`newsletter`, `podcast` or Substack's own type.
data . items [] . profiles [] . subscriptions [] . publication . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . profiles [] . subscriptions [] . publication . firstPostAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . profiles [] . subscriptions [] . publication . hasPosts
boolean nullable
Whether the publication has posts.
data . items [] . profiles [] . subscriptions [] . publication . isExplicit
boolean nullable
Whether the publication is marked explicit.
data . items [] . profiles [] . subscriptions [] . publication . isInviteOnly
boolean nullable
Whether the publication is invite-only.
data . items [] . profiles [] . subscriptions [] . publication . isFlagged
boolean nullable
Whether the publication is flagged.
data . items [] . profiles [] . subscriptions [] . publication . noIndex
boolean nullable
Whether search engines are asked not to index it.
data . items [] . profiles [] . subscriptions [] . publication . isOnSubstack
boolean nullable
Whether the publication is hosted by Substack.
data . items [] . profiles [] . subscriptions [] . publication . commentsEnabled
boolean nullable
Whether comments are enabled.
data . items [] . profiles [] . subscriptions [] . publication . notesEnabled
boolean nullable
Whether Notes are enabled.
data . items [] . profiles [] . subscriptions [] . publication . defaultCommentSort
string nullable
The default comment order.
data . items [] . profiles [] . subscriptions [] . publication . annualDisabled
boolean nullable
Whether annual plans are disabled.
data . items [] . profiles [] . subscriptions [] . publication . monthlyDisabled
boolean nullable
Whether monthly plans are disabled.
data . items [] . profiles [] . subscriptions [] . publication . paymentsState
string nullable
The publication's payments state.
data . items [] . profiles [] . subscriptions [] . publication . freeTrialEnabled
boolean nullable
Whether a free trial is offered.
data . items [] . profiles [] . subscriptions [] . publication . pausedUntil
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . profiles [] . subscriptions [] . publication . emailBannerUrl
string nullable
The email banner image URL.
data . items [] . profiles [] . subscriptions [] . publication . copyright
string nullable
The copyright line the publication prints.
data . items [] . profiles [] . subscriptions [] . publication . logoUrl
string nullable
The publication's logo URL.
data . items [] . profiles [] . subscriptions [] . publication . wideLogoUrl
string nullable
The publication's wide logo URL.
data . items [] . profiles [] . subscriptions [] . publication . coverImageUrl
string nullable
The publication's cover image URL.
data . items [] . profiles [] . subscriptions [] . publication . foundingPlanName
string nullable
The name of the founding-member plan.
data . items [] . profiles [] . subscriptions [] . publication . hasRecommendations
boolean nullable
Whether the publication recommends others.
data . items [] . profiles [] . subscriptions [] . publication . benefits object
The benefit lists for each subscription tier.
data . items [] . profiles [] . subscriptions [] . publication . benefits . free array
Benefits for free subscribers.
data . items [] . profiles [] . subscriptions [] . publication . benefits . free []
string optional
data . items [] . profiles [] . subscriptions [] . publication . benefits . paid array
Benefits for paid subscribers.
data . items [] . profiles [] . subscriptions [] . publication . benefits . paid []
string optional
data . items [] . profiles [] . subscriptions [] . publication . benefits . founding array
Benefits for founding members.
data . items [] . profiles [] . subscriptions [] . publication . benefits . founding []
string optional
data . items [] . profiles [] . subscriptions [] . publication . author object
The publication's main author.
data . items [] . profiles [] . subscriptions [] . publication . author . id
integer nullable
Numeric user id.
data . items [] . profiles [] . subscriptions [] . publication . author . name
string nullable
The name shown for the author.
data . items [] . profiles [] . subscriptions [] . publication . author . handle
string nullable
The author's handle.
data . items [] . profiles [] . subscriptions [] . publication . author . slug
string nullable
The author's profile slug.
data . items [] . profiles [] . subscriptions [] . publication . author . bio
string nullable
The author's short biography.
data . items [] . profiles [] . subscriptions [] . publication . author . photoUrl
string nullable
The author's profile photo URL.
data . items [] . profiles [] . subscriptions [] . publication . author . badge object nullable
The author's main badge, when there is one.
data . items [] . profiles [] . subscriptions [] . publication . author . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . profiles [] . subscriptions [] . publication . author . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . profiles [] . subscriptions [] . publication . author . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . profiles [] . subscriptions [] . publication . author . badge . service
string nullable
The service the badge comes from.
data . items [] . profiles [] . subscriptions [] . publication . author . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . profiles [] . subscriptions [] . publication . author . badges
object nullable
The author's reader status fields, when available.
data . items [] . profiles [] . subscriptions [] . publication . author . bestsellerTier
integer nullable
The author's bestseller tier.
data . items [] . profiles [] . subscriptions [] . publication . author . primaryPublication object nullable
The author's primary publication, when there is one.
data . items [] . profiles [] . subscriptions [] . publication . author . primaryPublication . id
integer nullable
Numeric publication id.
data . items [] . profiles [] . subscriptions [] . publication . author . primaryPublication . name
string nullable
The publication's name.
data . items [] . profiles [] . subscriptions [] . publication . author . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . profiles [] . subscriptions [] . publication . author . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . profiles [] . subscriptions [] . publication . author . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . items [] . profiles [] . subscriptions [] . publication . audience object
Approximate audience figures the publication prints. These are bands, not counts.
data . items [] . profiles [] . subscriptions [] . publication . audience . paidLabel
string nullable
The band Substack displays for paid subscribers.
data . items [] . profiles [] . subscriptions [] . publication . audience . paidOrderOfMagnitude
integer nullable
The order of magnitude behind the paid band.
data . items [] . profiles [] . subscriptions [] . publication . audience . totalLabel
string nullable
The band Substack displays for all subscribers.
data . items [] . profiles [] . subscriptions [] . publication . audience . totalOrderOfMagnitude
integer nullable
The order of magnitude behind the total band.
data . items [] . profiles [] . subscriptions [] . publication . audience . freeLabel
string nullable
The band Substack displays for free subscribers.
data . items [] . profiles [] . subscriptions [] . publication . audience . freeShort
string nullable
The short free-subscriber band.
data . items [] . profiles [] . subscriptions [] . publication . audience . chatMembersLabel
string nullable
The band Substack displays for chat members.
data . items [] . profiles [] . subscriptions [] . publication . contributors array
People with a byline on the publication.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . id
integer nullable
Numeric user id.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . name
string nullable
The contributor's name.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . handle
string nullable
The contributor's handle.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . role
string nullable
The contributor's role on the publication.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . owner
boolean nullable
Whether the contributor owns the publication.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . photoUrl
string nullable
The contributor's photo URL.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . bio
string nullable
The contributor's short biography.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . badge object nullable
The contributor's badge.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . badge . service
string nullable
The service the badge comes from.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . profiles [] . subscriptions [] . publication . contributors [] . bestsellerTier
integer nullable
The contributor's bestseller tier.
data . items [] . profiles [] . subscriptions [] . publication . sections array
The publication's sections.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . id
integer nullable
Numeric section id.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . name
string nullable
The section's name.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . description
string nullable
The section's description.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . slug
string nullable
The section's URL slug.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . isPodcast
boolean nullable
Whether the section is a podcast.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . isLive
boolean nullable
Whether the section is a live stream.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . isDefaultOn
boolean nullable
Whether the section is on by default.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . logoUrl
string nullable
The section's logo URL.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . coverImageUrl
string nullable
The section's cover image URL.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . hideFromNavbar
boolean nullable
Whether the section is hidden from navigation.
data . items [] . profiles [] . subscriptions [] . publication . sections [] . hidePostsFromPubListings
boolean nullable
Whether the section's posts are hidden from publication lists.
data . items [] . profiles [] . subscriptions [] . publication . links array
Links the publication shows.
data . items [] . profiles [] . subscriptions [] . publication . links [] . id
integer nullable
Numeric link id.
data . items [] . profiles [] . subscriptions [] . publication . links [] . url
string
The link.
data . items [] . profiles [] . subscriptions [] . publication . links [] . platform
string nullable
`apple_podcasts`, `spotify`, `youtube` or another label Substack uses.
data . items [] . profiles [] . subscriptions [] . publication . links [] . sectionId
integer nullable
The section the link belongs to, when it has one.
data . items [] . profiles [] . subscriptions [] . publication . plans array
The subscription plans the publication offers.
data . items [] . profiles [] . subscriptions [] . publication . plans [] . id
string nullable
The plan's id.
data . items [] . profiles [] . subscriptions [] . publication . plans [] . nickname
string nullable
The plan's display name.
data . items [] . profiles [] . subscriptions [] . publication . plans [] . amount
integer nullable
Price in the currency's minor unit.
data . items [] . profiles [] . subscriptions [] . publication . plans [] . currency
string nullable
Currency code for the price.
data . items [] . profiles [] . subscriptions [] . publication . plans [] . interval
string nullable
`month`, `year` or Substack's own value.
data . items [] . profiles [] . subscriptions [] . publication . plans [] . intervalCount
integer nullable
How many intervals one charge covers.
data . items [] . profiles [] . subscriptions [] . publication . plans [] . active
boolean nullable
Whether the plan is on sale.
data . items [] . profiles [] . subscriptions [] . publication . plans [] . founding
boolean
Whether this is a founding-member plan.
data . items [] . profiles [] . subscriptions [] . publication . podcast object
The publication's podcast, when it has one.
data . items [] . profiles [] . subscriptions [] . publication . podcast . exists
boolean nullable
Whether the publication has a podcast.
data . items [] . profiles [] . subscriptions [] . publication . podcast . hasFreeEpisodes
boolean nullable
Whether free episodes are available.
data . items [] . profiles [] . subscriptions [] . publication . podcast . hasPaidEpisodes
boolean nullable
Whether paid episodes are available.
data . items [] . profiles [] . subscriptions [] . publication . podcast . artUrl
string nullable
The podcast artwork URL.
data . items [] . profiles [] . subscriptions [] . publication . podcast . byline
string nullable
The podcast byline.
data . items [] . profiles [] . subscriptions [] . publication . podcast . description
string nullable
The podcast description.
data . items [] . profiles [] . subscriptions [] . publication . podcast . feedUrl
string nullable
The podcast feed URL.
data . items [] . profiles [] . subscriptions [] . publication . podcast . title
string nullable
The podcast title.
data . items [] . profiles [] . subscriptions [] . publication . podcast . paidEpisodeArtUrl
string nullable
Artwork for paid episodes.
data . items [] . profiles [] . subscriptionCount
integer nullable
The number of public subscriptions.
data . items [] . profiles [] . subscriptionsTruncated
boolean nullable
True when Substack cut the subscription list.
data . items [] . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . parentComments array nullable
Parent notes, when the item is a reply.
data . items [] . parentComments [] . id
integer
Numeric note id.
data . items [] . parentComments [] . body
string nullable
The note's plain text.
data . items [] . parentComments [] . bodyJson
object nullable
The note's rich text document, when there is one.
data . items [] . parentComments [] . createdAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . parentComments [] . editedAt
string nullable
ISO 8601 timestamp, or null when Substack does not publish one.
data . items [] . parentComments [] . author object
The note's author.
data . items [] . parentComments [] . author . id
integer nullable
Numeric user id.
data . items [] . parentComments [] . author . name
string nullable
The name shown for the author.
data . items [] . parentComments [] . author . handle
string nullable
The author's handle.
data . items [] . parentComments [] . author . slug
string nullable
The author's profile slug.
data . items [] . parentComments [] . author . bio
string nullable
The author's short biography.
data . items [] . parentComments [] . author . photoUrl
string nullable
The author's profile photo URL.
data . items [] . parentComments [] . author . badge object nullable
The author's main badge, when there is one.
data . items [] . parentComments [] . author . badge . type
string nullable
The kind of badge, such as `bestseller`.
data . items [] . parentComments [] . author . badge . tier
integer nullable
The badge tier, when it has one.
data . items [] . parentComments [] . author . badge . handle
string nullable
The handle the badge belongs to.
data . items [] . parentComments [] . author . badge . service
string nullable
The service the badge comes from.
data . items [] . parentComments [] . author . badge . url
string nullable
A link for the badge, when it has one.
data . items [] . parentComments [] . author . badges
object nullable
The author's reader status fields, when available.
data . items [] . parentComments [] . author . bestsellerTier
integer nullable
The author's bestseller tier.
data . items [] . parentComments [] . author . primaryPublication object nullable
The author's primary publication, when there is one.
data . items [] . parentComments [] . author . primaryPublication . id
integer nullable
Numeric publication id.
data . items [] . parentComments [] . author . primaryPublication . name
string nullable
The publication's name.
data . items [] . parentComments [] . author . primaryPublication . subdomain
string nullable
The publication's Substack subdomain.
data . items [] . parentComments [] . author . primaryPublication . customDomain
string nullable
The publication's custom domain, when it has one.
data . items [] . parentComments [] . author . primaryPublication . logoUrl
string nullable
The publication's logo URL.
data . items [] . parentComments [] . reactionCount
integer nullable
The number of reactions.
data . items [] . parentComments [] . reactions
object
Emoji to reaction count.
data . items [] . parentComments [] . restackCount
integer nullable
The number of restacks.
data . items [] . parentComments [] . replyCount
integer nullable
The number of replies.
data . items [] . parentComments [] . language
string nullable
The note's language code.
data . items [] . parentComments [] . isAiGenerated
boolean nullable
Substack's own flag.
data . items [] . parentComments [] . translation
object nullable
A translation of the note, when there is one.
data . items [] . parentComments [] . replyPermission
string nullable
Who may reply to the note.
data . items [] . parentComments [] . ancestorPath
string nullable
The note's position in a thread.
data . items [] . parentComments [] . attachments array
Images, links, posts or polls attached to the note.
data . items [] . parentComments [] . attachments [] . id
string nullable
The attachment's id.
data . items [] . parentComments [] . attachments [] . type
string nullable
`image`, `link`, `post`, `poll` or `missing`.
data . items [] . parentComments [] . attachments [] . imageUrl
string nullable
The image URL, for an image attachment.
data . items [] . parentComments [] . attachments [] . imageWidth
integer nullable
The image width in pixels.
data . items [] . parentComments [] . attachments [] . imageHeight
integer nullable
The image height in pixels.
data . items [] . parentComments [] . attachments [] . explicit
boolean nullable
Whether the attachment is explicit.
data . items [] . parentComments [] . attachments [] . link object nullable
Preview metadata for a link attachment.
data . items [] . parentComments [] . attachments [] . link . url
string nullable
The link's URL.
data . items [] . parentComments [] . attachments [] . link . host
string nullable
The link's host.
data . items [] . parentComments [] . attachments [] . link . title
string nullable
The link's title.
data . items [] . parentComments [] . attachments [] . link . description
string nullable
The link's description.
data . items [] . parentComments [] . attachments [] . link . image
string nullable
The link's preview image URL.
data . items [] . parentComments [] . attachments [] . link . originalImage
string nullable
The link's original image URL.
data . items [] . parentComments [] . attachments [] . postId
integer nullable
The attached post's id.
data . items [] . parentComments [] . attachments [] . publicationId
integer nullable
The attached publication's id.
data . items [] . parentComments [] . attachments [] . reason
string nullable
Why a missing attachment was removed.
Pagination state for the current page.
Whether another page is available.
data . page . nextCursor
string nullable
Cursor to pass in the next request when more pages exist; null on the last page.
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.