List Replies

This method works the same way as the List Comments method, so view the documentation on that method. The difference is that this method will filter to only include comments that have a parent.

GETTING THE RIGHT COMMENTS

• If you use ListComments you will get the top level comments.

• If you use List Replies you will get comments that are children of another comment.

• If you want all replies lower in the tree of comments than the current level use the includechildren property.

READ THIS - ABOUT CURSORING WITH OFFSET CURSORS

• The maximum limit value for the request depends on your account. In general, its best to use a lower limit and make multiple calls as users scroll through your application for fastest performance. However for exporting data or reporting purposes, a larger number with fewer requests is better.

• If you use a cursoring method that is offset based (likes/votescore/mostreplies) rather than time based (oldest/newest) you are not guaranteed to see all of the comments. This is because the original query runs, and returs the comments ordered by your query. But, if you then send another request with a cursor value to get the next bunch, the cursor skips over the first set of results equal to the limit size in the query and returns the next set. So if you change your limit size or the underlying data changes because people react, vote, and like things, then you may not get a perfect results set. It is recommended that you request the top N records in one shot, as long as the request isn't too large. Otherwise, use cursoring with oldest sort method to download the entire list of comments and sort it yourself.

ABOUT CURSORING

• API Method returns a cursor

• Cursor includes a "more" field indicating if there are more results that can be read at the time this call is made

• Cursor includes "cursor" field, which can be passed into subsequent calls to this method to get additionaal results

• Cursor includes "itemcount" field, which is the number of items returned by the cursor not the total number of items in the database

• All LIST methods in the API return cursors and they all work the same way

URL Arguments

• comment_conversation_id : (required) The ID of the comment conversation, URL ENCODED.

URL Parameters

• cursor : (optional) If provided, will get the next bundle of comments in the conversation resuming from where the cursor left off.

• limit : (Optional, default = 200). For cursoring, limit the number of responses for this request.

• direction: (optional) Default is forward. Must be forward or backward

• sort : (optional, defaults to "oldest") Specifies that sort should be done by...

  • oldest : Sort by when added ascending (oldest on top)

  • newest : Sort by when added ascending (newest on top)

  • likes : Sort by number of likes, descending (most liked on top)

  • votescore : Sort by net of adding upvotes and subtracting downvotes, descending

  • mostreplies : Sort by number of replies,descending

• includechildren : (optional, default is false) If false, this returns all reply nodes that are immediate children of the provided parent id. If true, it includes all replies under the parent id and all the children of those replies and so on.

• includeinactive : (optional, default is false) If true, return comments that are inactive (for example, disabled by moderation)

• filterpostedbyuserid: (optional) If provided, the list returned will be filtered to only include comments published by the specified userid.