social.coves.feed.getFeed

Get a page of hydrated posts for a feed surface. Without feed, the AppView's default ordering for the scope is used; with feed, the named generator orders the posts.

Repository @coves.social did:web:coves.social namespace authority
Details · query
Kindquery
Authorityfeed.coves.social
Commit rev3n2v225sxsc26
Indexed

Query

query · GET

Parameters

query string

community

string

Community for scope=community (DID, handle, name@origin, or bare local name)

  • maxLength: 320

cursor

string
  • maxLength: 500

feed

string · at-uri

AT-URI of a social.coves.feed.generator record. Omit to use the default ordering for the scope.

limit

integer
  • minimum: 1
  • maximum: 50
  • default: 15

scope

requiredstring

Which feed surface the request is for: all communities, the viewer's home feed, or one community

  • maxLength: 64
  • knownValues: all | home | community

timeframe

string

Timeframe for feeds ranked by top score

  • maxLength: 64
  • default: "day"
  • knownValues: hour | day | week | month | year | all

Output

application/json
Reference

Errors

UnknownFeed

The feed URI does not name a known feed generator.

UnsupportedFeedScope

The feed generator does not support the requested scope.

InvalidCursor

The cursor is malformed or expired; restart from the first page.

CommunityNotFound

The community for scope=community does not exist.

AmbiguousCommunity

The name@origin community identifier matches more than one community; address it by DID or handle instead.

DiscoverUnavailable

The all-communities feed is temporarily unavailable; retry later.

#output

object

A page of feed posts

Properties

cursor

string
  • maxLength: 500

feed

requiredarray

reqId

string

Request ID for this response, from the feed generator or assigned by the AppView. Clients send it back with interactions on items from this response.

  • maxLength: 100

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Get an ordered page of post URIs from a feed generator. Served by the generator's service and called by the AppView, which hydrates the posts.

  • A Community's native feed skeleton, served from projected com.getorbyt.community.post links. Clients hydrate post URIs through their authenticated Bluesky AppView. Removed posts are only included for their author and Community moderators.

  • Get the public discover feed showing posts from all communities

  • Full-text search over visible posts, across every community or restricted to one. Results honour the same admission, deletion and viewer-block rules as social.coves.feed.getDiscover and social.coves.feed.getCommunity.

  • Get a feed of posts. Use the 'feed' parameter to select which feed: 'following' for posts from followed accounts, 'global' for all posts, or an at-uri for a custom feed generator.