Lexicon Garden

pub.oysters.getFeed

A page of the board's feed. Public: no authentication, and the same answer for everybody.

Repository @oysters.pub did:plc:gsvuczfwpmrqpap45iz23j43 namespace authority
Details · query
Kindquery
Authorityoysters.pub
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

cursor

string

Opaque. Pass back what the previous page returned; do not construct one.

limit

integer

How many submissions to return.

  • minimum: 1
  • maximum: 100
  • default: 25

sort

string

Ranking to page through. 'hot' is the board's own ranking; 'new' is submission order.

  • default: "hot"
  • knownValues: hot | new

tags

array

Restrict to submissions carrying any of these tags. OR, not AND. Tags outside the curated vocabulary are an error rather than an empty page, so a typo is visible.

  • maxLength: 10
itemsstring
  • maxLength: 128

Output

application/json

cursor

string

Pass to the next call. Absent when there is nothing more.

feed

requiredarray

The page, in ranking order.

itemsref
Reference

Errors

InvalidRequest

An unknown tag, an unknown sort, or a cursor that did not decode.

Similar lexicons

semantic match

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

  • us.off-the-clock.feed.getFeedSkeleton

    query

    A page of a feed's items, newest first by the feed's sort. The caller hydrates them.

  • dev.jazco.boards.getPosts

    query

    A page of a board's posts. Viewers authenticate with a space credential for the board (Authorization: Atproto-Space, audience = this appview's DID).

  • com.getorbyt.community.getFeed

    query

    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.

  • us.off-the-clock.getFeed

    query

    A feed by record key: its generator's skeleton, hydrated by collection. Needs the viewer's service-auth token for the feed generator in x-atproto-feed-authorization.

  • social.coves.feed.getDiscover

    query

    Get the public discover feed showing posts from all communities