Lexicon Garden

social.coves.community.comment.getComments

Get comments for a post with threading and sorting support. Supports hot/top/new sorting, configurable nesting depth, and pagination.

Repository @coves.social did:web:coves.social namespace authority
Details · query
Kindquery
Authoritycomment.community.coves.social
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

cursor

string

Pagination cursor from previous response

  • maxLength: 500

depth

integer

Maximum reply nesting depth to return. 0 returns only top-level comments.

  • minimum: 0
  • maximum: 100
  • default: 10

limit

integer

Maximum number of top-level comments to return per page

  • minimum: 1
  • maximum: 100
  • default: 50

parentRkey

string · record-key

Record key of a comment within the post. When provided, the response contains only the subtree rooted at that comment: the comment itself as the sole top-level entry, with its descendants nested beneath it. depth is relative to this comment (0 returns only the comment itself), and limit/cursor paginate its direct replies.

post

requiredstring · at-uri

AT-URI of the post to get comments for

sort

string

Sort order: hot (trending), top (highest score), new (most recent)

  • maxLength: 64
  • default: "hot"
  • knownValues: hot | top | new

timeframe

string

Timeframe for 'top' sort. Ignored for other sort types.

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

Output

application/json

comments

requiredarray

Top-level comments with nested replies up to requested depth

cursor

string

Pagination cursor for fetching next page of top-level comments

  • maxLength: 500

post

requiredref

The post these comments belong to

Reference

Errors

NotFound

Post not found

ParentNotFound

No comment with the given parentRkey exists within the post

InvalidRequest

Invalid parameters (malformed URI, invalid sort/timeframe combination, etc.)

Similar lexicons

semantic match

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

  • so.sprk.feed.getPostThread

    query

    Get posts in a thread. Does not require auth, but additional metadata and filtering will be applied for authed requests.

  • app.didpic.feed.getPostThread

    query

    A post and a page of its top-level comments.

  • social.grain.unspecced.getCommentThread

    query not from the namespace authority

    Get comments for a subject (gallery or story), sorted oldest-first with author profiles.

  • town.delve.unspecced.getPostThreadV2

    query not from the namespace authority

    (NOTE: this endpoint is under development and WILL change without notice. Don't use it until it is moved out of `unspecced` or your application WILL break) Get posts in a thread. It is based in an anchor post at any depth of the tree, and returns posts above it (recursively resolving the parent, without further branching to their replies) and below it (recursive replies, with branching to their replies). Does not require auth, but additional metadata and filtering will be applied for authed requ

  • ai.newnal.trustsquare.getComments

    query

    List root comments of a Square with a few inline replies each.