获取Reddit APP评论回复(二级评论)/Fetch Reddit APP Comment Replies (Sub-comments)
Changed on[中文]
用途:
- 获取Reddit APP指定评论下的回复(二级评论/子评论)
- 当评论节点有 more.cursor 字段时,使用此接口获取该评论的子评论
参数:
- post_id: 帖子ID,格式如 "t3_XXXXXX"
- cursor: 评论游标,从评论数据的 more.cursor 字段获取,格式如 "commenttree:ex:(xxx)"
- sort_type: 排序方式,支持CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM
返回:
- 指定评论下的回复JSON数据,包含:
- 子评论列表
- 每个子评论的详细信息(内容、作者、点赞数等)
- 分页信息
使用步骤:
- 先调用 fetch_post_comments 获取帖子的一级评论
- 在返回数据中找到有子评论的节点(childCount > 0)
- 获取该节点的 more.cursor 值
- 使用该 cursor 调用本接口获取子评论
注意:
- cursor 值来自评论数据的 more.cursor 字段
- 路径示例: $.data.postInfoById.commentForest.trees[*].more.cursor
- cursor 格式类似: "commenttree:ex:(RjiJd"
[English]
Purpose:
- Fetch replies (sub-comments/second-level comments) under a specified Reddit APP comment
- Use this endpoint when a comment node has more.cursor field to get its sub-comments
Parameters:
- post_id: Post ID, format like "t3_XXXXXX"
- cursor: Comment cursor from the more.cursor field in comment data, format like "commenttree:ex:(xxx)"
- sort_type: Sort method, supports CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM
Returns:
- JSON data of replies under the specified comment, containing:
- List of sub-comments
- Detailed information for each sub-comment (content, author, upvotes, etc.)
- Pagination information
Usage Steps:
- First call fetch_post_comments to get top-level comments
- Find comment nodes with sub-comments (childCount > 0)
- Get the more.cursor value from that node
- Use that cursor to call this endpoint to fetch sub-comments
Note:
- cursor value comes from the more.cursor field in comment data
- Path example: $.data.postInfoById.commentForest.trees[*].more.cursor
- cursor format example: "commenttree:ex:(RjiJd"
[示例/Example]
post_id="t3_1qmup73" cursor="commenttree:ex:(RjiJd" sort_type="CONFIDENCE" need_format=false
Request
- Base URLhttps://api.tikhub.io (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
Query parameters
返回内容使用的语言,采用 IETF 语言标签;默认 en-US / Preferred response language as an IETF language tag; default: en-US
帖子ID/Post ID
评论游标/Comment cursor from more.cursor field
排序方式/Sort method: CONFIDENCE, NEW, TOP, HOT, CONTROVERSIAL, OLD, RANDOM
是否需要清洗数据/Whether to clean and format the data
Response
Successful Response
Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- breaking
the
queryrequest parametersort_typewas restricted to a list of enum values - breaking
for the
queryrequest parametercursor, the minLength was increased from0to13 - breaking
for the
queryrequest parameterpost_id, the minLength was increased from0to4 - breaking
added the pattern
^commenttree:to thequeryrequest parametercursor - breaking
added the pattern
^t3_[a-z0-9]{1,17}$to thequeryrequest parameterpost_id - warning
for the
queryrequest parametercursor, the maxLength was set to4096 - warning
for the
queryrequest parameterpost_id, the maxLength was set to20 - info
added the new optional
queryrequest parameterlanguage - info
added the new enum value
CONFIDENCEto thequeryrequest parametersort_type - info
added the new enum value
CONTROVERSIALto thequeryrequest parametersort_type - info
added the new enum value
HOTto thequeryrequest parametersort_type - info
added the new enum value
NEWto thequeryrequest parametersort_type - info
added the new enum value
OLDto thequeryrequest parametersort_type - info
added the new enum value
RANDOMto thequeryrequest parametersort_type - info
added the new enum value
TOPto thequeryrequest parametersort_type
- breaking