social.smallbury.feed.list

lexicon.pds.smallbury.social

Documentation

Authenticated home feed: root shouts from followed authors, root Smallbury posts from mutually trusted authors, plus all indexed comments on those roots. Includes trust-record revision hints so the client can refresh cached trust records from PDS when needed.

main query

Authenticated home feed: root shouts from followed authors, root Smallbury posts from mutually trusted authors, plus all indexed comments on those roots. Includes trust-record revision hints so the client can refresh cached trust records from PDS when needed.

Parameters

cursor string Optional

No description available.

limit integer Optional

No description available.

Output

Encodingapplication/json
Schema#feedPage
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
View raw schema
{
  "type": "query",
  "output": {
    "schema": {
      "ref": "#feedPage",
      "type": "ref"
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1
      },
      "cursor": {
        "type": "string"
      }
    }
  },
  "description": "Authenticated home feed: root shouts from followed authors, root Smallbury posts from mutually trusted authors, plus all indexed comments on those roots. Includes trust-record revision hints so the client can refresh cached trust records from PDS when needed."
}
feedPage object

No description available.

Properties

cursor string Optional

No description available.

posts array of ref#feedPost Required

No description available.

trustRevisions array of ref#trustRevision Optional

Trust-record revision hints for the viewer, feed authors, and mutual contacts relevant to this page. Client compares trustRecordCid to cache and fetches full records from PDS on mismatch.

View raw schema
{
  "type": "object",
  "required": [
    "posts"
  ],
  "properties": {
    "posts": {
      "type": "array",
      "items": {
        "ref": "#feedPost",
        "type": "ref"
      }
    },
    "cursor": {
      "type": "string"
    },
    "trustRevisions": {
      "type": "array",
      "items": {
        "ref": "#trustRevision",
        "type": "ref"
      },
      "description": "Trust-record revision hints for the viewer, feed authors, and mutual contacts relevant to this page. Client compares trustRecordCid to cache and fetches full records from PDS on mismatch."
    }
  }
}
feedPost object

Post row returned by AppView (cleartext metadata; private posts may include ciphertext from the repo).

Properties

cid string cid Optional

A content identifier (CID) referencing immutable data.

createdAt string datetime Optional

An RFC 3339 formatted timestamp.

creatorDid string did Optional

A decentralized identifier (DID).

reactionCounts array of ref#reactionCount Optional

Aggregated cleartext emoji reactions indexed by AppView, for public posts only. Encrypted post reactions are not included.

uri string at-uri Optional

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

viewerReactions array of ref#viewerReaction Optional

Cleartext reactions the authenticated viewer has on this post, with repo record URIs for removal.

View raw schema
{
  "type": "object",
  "properties": {
    "cid": {
      "type": "string",
      "format": "cid"
    },
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "createdAt": {
      "type": "string",
      "format": "datetime"
    },
    "creatorDid": {
      "type": "string",
      "format": "did"
    },
    "reactionCounts": {
      "type": "array",
      "items": {
        "ref": "#reactionCount",
        "type": "ref"
      },
      "description": "Aggregated cleartext emoji reactions indexed by AppView, for public posts only. Encrypted post reactions are not included."
    },
    "viewerReactions": {
      "type": "array",
      "items": {
        "ref": "#viewerReaction",
        "type": "ref"
      },
      "description": "Cleartext reactions the authenticated viewer has on this post, with repo record URIs for removal."
    }
  },
  "description": "Post row returned by AppView (cleartext metadata; private posts may include ciphertext from the repo)."
}
reactionCount object

No description available.

Properties

count integer Required

No description available.

minimum: 1
emoji string Required

No description available.

maxLength: 32 bytesmaxGraphemes: 1 graphemes
View raw schema
{
  "type": "object",
  "required": [
    "emoji",
    "count"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 1
    },
    "emoji": {
      "type": "string",
      "maxLength": 32,
      "maxGraphemes": 1
    }
  }
}
trustRevision object

No description available.

Properties

did string did Required

Actor whose social.smallbury.actor.trust record changed.

trustRecordCid string cid Required

CID of the trust record commit; primary cache invalidation key.

trustRecordUpdatedAt string datetime Optional

Optional updatedAt from the record; secondary hint only.

View raw schema
{
  "type": "object",
  "required": [
    "did",
    "trustRecordCid"
  ],
  "properties": {
    "did": {
      "type": "string",
      "format": "did",
      "description": "Actor whose social.smallbury.actor.trust record changed."
    },
    "trustRecordCid": {
      "type": "string",
      "format": "cid",
      "description": "CID of the trust record commit; primary cache invalidation key."
    },
    "trustRecordUpdatedAt": {
      "type": "string",
      "format": "datetime",
      "description": "Optional updatedAt from the record; secondary hint only."
    }
  }
}
viewerReaction object

No description available.

Properties

emoji string Required

No description available.

maxLength: 32 bytesmaxGraphemes: 1 graphemes
uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema
{
  "type": "object",
  "required": [
    "emoji",
    "uri"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "emoji": {
      "type": "string",
      "maxLength": 32,
      "maxGraphemes": 1
    }
  }
}

Lexicon Garden

@