Skip to main content

app.bsky.unspecced.getAtmosphereTimelineV2

#main​

Get the requesting account's Atmosphere activity timeline, pre-grouped for rendering. Requires auth.

Parameters​

PropertyTypeKnown ValuesRequiredDescription
cursorstring-❌-

Output​

  • Encoding: application/json
PropertyTypeKnown ValuesRequiredDescription
cursorstring-❌-
feedarray of union
#activityItem
#activityActorGroup
#activitySubjectGroup
-✅Activities and activity groups, sorted newest first by indexedAt. Groups and relatedActivity only contain activities from the same page of results. Activities by actors unavailable to the viewer are omitted before grouping. Clients should ignore entry types they do not recognize.
relatedViewsarray of union
app.bsky.actor.defs#profileViewBasic
-✅Reusable views referenced by feed entries. Views shared across entries appear once to avoid duplication. Always includes the profile of the actor of every activityItem and activityActorGroup, plus the profiles of at most the newest 3 distinct actors in each activitySubjectGroup and in each collection of an activityItem's relatedActivity. Ex: for a subject group of 12 recommendations, only the profiles of the 3 newest recommenders are included; clients can fetch the rest with app.bsky.actor.getProfiles.

#activityItem​

A single activity with its hydrated subject. An activity that creates content, such as publishing an article, is always a standalone item when other activities on the same page target that content; those activities are attached as relatedActivity. Activities whose subject is unavailable to the viewer are omitted from the timeline.

PropertyTypeKnown ValuesRequiredDescription
refcom.atproto.repo.strongRef-✅-
collectionstring (nsid)-✅The collection of the activity record. Ex: site.standard.graph.recommend.
indexedAtstring (datetime)-✅When the activity was indexed. Determines the item's position in the feed, even when relatedActivity contains newer activities.
actorstring (did)-✅-
subject#activitySubject-✅-
relatedActivityarray of #activityItemRelatedActivity-❌All available activities on the same page that target content created by this activity, newest first. Ex: recommendations of a newly published article. Only present on activities that create content. Activities targeting content created on an earlier page appear as their own feed entries instead.

#activityItemRelatedActivity​

PropertyTypeKnown ValuesRequiredDescription
refcom.atproto.repo.strongRef-✅-
collectionstring (nsid)-✅-
indexedAtstring (datetime)-✅-
actorstring (did)-✅-

#activitySubject​

The hydrated content an activity targets. For activities that create content, such as publishing an article, the subject is the created record itself.

PropertyTypeKnown ValuesRequiredDescription
refcom.atproto.repo.strongRef-✅-
viewunion of
app.bsky.embed.external#viewArticle
app.bsky.embed.external#viewArticlePublication
app.bsky.embed.external#viewGallery
app.bsky.embed.external#viewLivestream
-✅-
bskyPostRefcom.atproto.repo.strongRef-❌-
bskyPostViewapp.bsky.feed.defs#postView-❌-

#activityActorGroup​

Activities by one actor in one collection close together in time, such as several articles published by the same author. Activities that create content with relatedActivity are never grouped. Positioned in the feed at its newest activity.

PropertyTypeKnown ValuesRequiredDescription
collectionstring (nsid)-✅-
indexedAtstring (datetime)-✅When the group's newest activity was indexed.
actorstring (did)-✅-
subjectsarray of #activitySubject-✅Hydrated subjects of the group's activities, newest first. Currently only the newest subject is included; clients can hydrate the rest from the subject URIs in activities.
activitiesarray of #activityActorGroupItem-✅All activities in the group, newest first.

#activityActorGroupItem​

PropertyTypeKnown ValuesRequiredDescription
refcom.atproto.repo.strongRef-✅-
indexedAtstring (datetime)-✅-
subjectstring (at-uri)-✅The content the activity targets. Matches ref.uri for activities that create content.

#activitySubjectGroup​

Activities by at least two actors in one collection targeting the same subject, such as several recommendations of an article published on an earlier page. Positioned in the feed at its newest activity.

PropertyTypeKnown ValuesRequiredDescription
collectionstring (nsid)-✅-
indexedAtstring (datetime)-✅When the group's newest activity was indexed.
subject#activitySubject-✅-
activitiesarray of #activitySubjectGroupItem-✅All activities in the group, newest first.

#activitySubjectGroupItem​

PropertyTypeKnown ValuesRequiredDescription
refcom.atproto.repo.strongRef-✅-
indexedAtstring (datetime)-✅-
actorstring (did)-✅-