Skip to main content

app.bsky.feed.defs

#postView​

PropertyTypeKnown ValuesRequiredDescription
uristring (at-uri)-✅-
cidstring (cid)-✅-
authorapp.bsky.actor.defs#profileViewBasic-✅-
recordunknown-✅-
embedunion of
app.bsky.embed.images#view
app.bsky.embed.video#view
app.bsky.embed.gallery#view
app.bsky.embed.external#view
app.bsky.embed.record#view
app.bsky.embed.recordWithMedia#view
-❌-
bookmarkCountinteger-❌-
replyCountinteger-❌-
repostCountinteger-❌-
likeCountinteger-❌-
quoteCountinteger-❌-
viewCountinteger-❌Approximate number of times the post has been viewed. Only included in authenticated responses to the post's author when eligible to see the count. Counts less than 100 are omitted.
indexedAtstring (datetime)-✅-
viewer#viewerState-❌-
labelsarray of com.atproto.label.defs#label-❌-
threadgate#threadgateView-❌-
debugunknown-❌Debug information for internal development

#viewerState​

Metadata about the requesting account's relationship with the subject content. Only has meaningful content for authed requests.

PropertyTypeKnown ValuesRequiredDescription
repoststring (at-uri)-❌-
likestring (at-uri)-❌-
bookmarkedboolean-❌-
threadMutedboolean-❌-
replyDisabledboolean-❌-
embeddingDisabledboolean-❌-
pinnedboolean-❌-
knownLikers#knownLikers-❌-

#knownLikers​

The post's likers whom you also follow

PropertyTypeKnown ValuesRequiredDescription
countinteger-✅-
actorsarray of app.bsky.actor.defs#profileViewBasic-✅-

#threadContext​

Metadata about this post within the context of the thread it is in.

PropertyTypeKnown ValuesRequiredDescription
rootAuthorLikestring (at-uri)-❌-

#feedViewPost​

PropertyTypeKnown ValuesRequiredDescription
post#postView-✅-
reply#replyRef-❌-
opThreadPostIndexinteger-❌The 1-indexed position of this post within the contiguous OP thread. Only present when this post is part of the OP thread.
opThreadPostCountinteger-❌The total number of posts in the contiguous OP thread that this post belongs to. Only present when this post is part of the OP thread.
reasonunion of
#reasonRepost
#reasonPin
-❌-
feedContextstring-❌Context provided by feed generator that may be passed back alongside interactions.
reqIdstring-❌Unique identifier per request that may be passed back alongside interactions.

#replyRef​

PropertyTypeKnown ValuesRequiredDescription
rootunion of
#postView
#notFoundPost
#blockedPost
-✅-
parentunion of
#postView
#notFoundPost
#blockedPost
-✅-
grandparentAuthorapp.bsky.actor.defs#profileViewBasic-❌-

#reasonRepost​

PropertyTypeKnown ValuesRequiredDescription
byapp.bsky.actor.defs#profileViewBasic-✅-
uristring (at-uri)-❌-
cidstring (cid)-❌-
indexedAtstring (datetime)-✅-

#reasonPin​

#threadViewPost​

PropertyTypeKnown ValuesRequiredDescription
post#postView-✅-
parentunion of
#threadViewPost
#notFoundPost
#blockedPost
-❌-
repliesarray of union
#threadViewPost
#notFoundPost
#blockedPost
-❌-
threadContext#threadContext-❌-

#notFoundPost​

PropertyTypeKnown ValuesRequiredDescription
uristring (at-uri)-✅-
notFoundboolean-✅-

#blockedPost​

PropertyTypeKnown ValuesRequiredDescription
uristring (at-uri)-✅-
blockedboolean-✅-
author#blockedAuthor-✅-

#blockedAuthor​

PropertyTypeKnown ValuesRequiredDescription
didstring (did)-✅-
viewerapp.bsky.actor.defs#viewerState-❌-

#generatorView​

PropertyTypeKnown ValuesRequiredDescription
uristring (at-uri)-✅-
cidstring (cid)-✅-
didstring (did)-✅-
creatorapp.bsky.actor.defs#profileView-✅-
displayNamestring-✅-
descriptionstring-❌-
descriptionFacetsarray of app.bsky.richtext.facet-❌-
avatarstring (uri)-❌-
likeCountinteger-❌-
acceptsInteractionsboolean-❌-
labelsarray of com.atproto.label.defs#label-❌-
viewer#generatorViewerState-❌-
contentModestringapp.bsky.feed.defs#contentModeUnspecified
app.bsky.feed.defs#contentModeVideo
❌-
indexedAtstring (datetime)-✅-

#generatorViewerState​

PropertyTypeKnown ValuesRequiredDescription
likestring (at-uri)-❌-

#skeletonFeedPost​

PropertyTypeKnown ValuesRequiredDescription
poststring (at-uri)-✅-
reasonunion of
#skeletonReasonRepost
#skeletonReasonPin
-❌-
feedContextstring-❌Context that will be passed through to client and may be passed to feed generator back alongside interactions.

#skeletonReasonRepost​

PropertyTypeKnown ValuesRequiredDescription
repoststring (at-uri)-✅-

#skeletonReasonPin​

#threadgateView​

PropertyTypeKnown ValuesRequiredDescription
uristring (at-uri)-❌-
cidstring (cid)-❌-
recordunknown-❌-
listsarray of app.bsky.graph.defs#listViewBasic-❌-

#interaction​

PropertyTypeKnown ValuesRequiredDescription
itemstring (at-uri)-❌-
eventstringapp.bsky.feed.defs#requestLess
app.bsky.feed.defs#requestMore
app.bsky.feed.defs#clickthroughItem
app.bsky.feed.defs#clickthroughAuthor
app.bsky.feed.defs#clickthroughReposter
app.bsky.feed.defs#clickthroughEmbed
app.bsky.feed.defs#interactionSeen
app.bsky.feed.defs#interactionLike
app.bsky.feed.defs#interactionRepost
app.bsky.feed.defs#interactionReply
app.bsky.feed.defs#interactionQuote
app.bsky.feed.defs#interactionShare
❌-
feedContextstring-❌Context on a feed item that was originally supplied by the feed generator on getFeedSkeleton.
reqIdstring-❌Unique identifier per request that may be passed back alongside interactions.

#requestLess​

TOKEN: Request that less content like the given feed item be shown in the feed

#requestMore​

TOKEN: Request that more content like the given feed item be shown in the feed

#clickthroughItem​

TOKEN: User clicked through to the feed item

#clickthroughAuthor​

TOKEN: User clicked through to the author of the feed item

#clickthroughReposter​

TOKEN: User clicked through to the reposter of the feed item

#clickthroughEmbed​

TOKEN: User clicked through to the embedded content of the feed item

#contentModeUnspecified​

TOKEN: Declares the feed generator returns any types of posts.

#contentModeVideo​

TOKEN: Declares the feed generator returns posts containing app.bsky.embed.video embeds.

#interactionSeen​

TOKEN: Feed item was seen by user

#interactionLike​

TOKEN: User liked the feed item

#interactionRepost​

TOKEN: User reposted the feed item

#interactionReply​

TOKEN: User replied to the feed item

#interactionQuote​

TOKEN: User quoted the feed item

#interactionShare​

TOKEN: User shared the feed item