获取笔记评论_v2

接口信息

URL: http://plugin.aiconductor.fun/api/xhs_note_comment_v2

方法: POST / GET

Content-Type: application/json

鉴权: 请求头 Authorization: Bearer <api_key>（兼容 body/query 中 api_key 参数）

功能说明

根据笔记ID获取小红书笔记一级评论，支持自动翻页和排序方式切换，使用 max_pages 和 max_seconds 控制翻页范围。按页计费（0.15元/页）。

请求参数

参数名	类型	必填	默认值	说明
note_id	string	是		小红书笔记ID，从笔记链接 `/explore/` 后提取
max_pages	integer	否	1	最大翻页数
max_seconds	integer	否	50	最长运行时长（秒），超时自动停止
sort_type	integer	否	1	排序方式：1=默认，2=最新，3=最多点赞

鉴权参数：api_key 通过请求头 Authorization: Bearer <api_key> 传递，不再列入请求参数表。

响应参数

参数名	类型	说明
success	boolean	是否成功
message	string	响应消息
data	object	评论数据
data.note_id	string	笔记ID
data.sort_type	integer	排序方式
data.comment_count	integer	评论总数
data.comment_count_l1	integer	一级评论总数
data.comments	array	评论列表
data.comments[].id	string	评论ID
data.comments[].content	string	评论内容
data.comments[].like_count	integer	点赞数
data.comments[].time	integer	评论时间（秒级时间戳）
data.comments[].sub_comment_count	integer	二级评论数
data.comments[].score	integer	评论热度分
data.comments[].ip_location	string	评论用户IP属地
data.comments[].hidden	boolean	是否被折叠
data.comments[].liked	boolean	当前用户是否已点赞
data.comments[].collected	boolean	是否被收藏
data.comments[].downvoted	boolean	是否被踩
data.comments[].status	integer	评论状态（0=正常）
data.comments[].comment_type	integer	评论类型
data.comments[].show_type	string	展示类型
data.comments[].user	object	评论用户信息
data.comments[].user.userid	string	用户ID
data.comments[].user.nickname	string	用户昵称
data.comments[].user.images	string	用户头像URL
data.comments[].user.red_id	string	小红书号
data.comments[].user.ai_agent	boolean	是否AI账号
data.comments[].user.current_user	string	是否为当前登录用户
data.comments[].user.level	object	用户等级信息
data.comments[].user.level.image	string	等级图标URL
data.comments[].user.additional_tags	object	用户附加标签
data.comments[].show_tags_v2	array	评论标签（如"置顶评论"、"作者"、"首评"等）
data.comments[].show_tags_v2[].type	string	标签类型
data.comments[].show_tags_v2[].text	string	标签文本
data.comments[].show_tags_v2[].style_id	string	标签样式
data.comments[].show_tags_v2[].pos	string	标签位置
data.comments[].show_tags	array	旧版标签
data.comments[].sub_comments	array	二级评论列表（结构同一级评论）
data.comments[].sub_comments[].id	string	子评论ID
data.comments[].sub_comments[].content	string	子评论内容
data.comments[].sub_comments[].like_count	integer	子评论点赞数
data.comments[].sub_comments[].time	integer	子评论时间
data.comments[].sub_comments[].user	object	子评论用户信息
data.comments[].sub_comments[].target_comment	object	子评论回复的目标评论
data.comments[].sub_comments[].target_comment.id	string	目标评论ID
data.comments[].sub_comments[].target_comment.status	integer	目标评论状态
data.comments[].sub_comments[].target_comment.user	object	目标评论用户
data.comments[].sub_comment_cursor	string	子评论翻页游标
data.comments[].track_id	string	追踪ID
data.comments[].friend_liked_msg	string	好友点赞提示
data.comments[].note_id	string	所属笔记ID
data.comments[].share_strategy	integer	分享策略
data.comments[].translation_strategy	integer	翻译策略
data.comments[].biz_label	object	业务标签
data.comments[].biz_label.product_review	boolean	是否商品评价
data.comments[].biz_label.group_invite	string	群邀请信息
data.comments[].biz_label.rich_text	string	富文本信息
data.comments[].at_users	array	@的用户列表
data.cursor	string	翻页游标
data.has_more	boolean	是否还有更多数据
data.pages_fetched	integer	实际获取页数
data.total_comments_fetched	integer	实际获取评论数
billing	object	计费信息
billing.service_fee	float	单页服务费
billing.discount_applied	boolean	是否应用折扣
billing.balance_before	float	扣费前余额
billing.balance_after	float	扣费后余额
billing.currency	string	货币类型（CNY）
billing.pages_billed	integer	实际计费页数
billing.total_service_fee	float	总服务费
billing.transaction_ids	array	交易ID列表

请求示例

注意事项

按页计费，每成功获取一页数据扣费一次

max_pages 控制最大翻页数，max_seconds 控制最长运行时间，两者任一达到限制即停止

余额不足时自动停止翻页，已获取的数据正常返回

采用后扣费模式，仅成功获取数据的页面才计费

note_id 从小红书笔记链接中提取，格式为 https://www.xiaohongshu.com/explore/{note_id}

sort_type 取值：1=默认排序，2=最新排序，3=最多点赞排序

每页最多返回15条一级评论，二级评论（sub_comments）仅返回首条预览

application/json

Bodyapplication/json

示例

{
    "success": true,
    "message": "笔记评论获取完成。成功获取 2 页数据，共 16 条评论。",
    "billing": {
        "service_fee": 0.15,
        "discount_applied": true,
        "balance_before": 359.5486,
        "balance_after": 359.2486,
        "currency": "CNY",
        "pages_billed": 2,
        "total_service_fee": 0.3,
        "transaction_ids": [
            1829973,
            1829975
        ]
    },
    "data": {
        "note_id": "69d4168d00000000230074a3",
        "sort_type": 3,
        "comment_count": 382,
        "comment_count_l1": 189,
        "comments": [
            {
                "like_count": 51,
                "score": 10000000,
                "biz_label": {
                    "product_review": false,
                    "group_invite": "false",
                    "rich_text": "unknown"
                },
                "sub_comment_cursor": "{\"cursor\":\"69d99ef3000000002a032f64\",\"index\":1}",
                "downvoted": false,
                "id": "69d792180000000009005602",
                "note_id": "69d4168d00000000230074a3",
                "content": "谢谢大家 把评论区差评怼的全部自己删评了 好爽[doge]",
                "collected": false,
                "translation_strategy": 10,
                "show_type": "common",
                "track_id": "interaction-service.local",
                "show_tags_v2": [
                    {
                        "type": "user_top",
                        "text": "置顶评论",
                        "style_id": "red",
                        "pos": "cmt_bottom"
                    },
                    {
                        "pos": "post_name",
                        "type": "is_author",
                        "text": "作者",
                        "style_id": "red"
                    }
                ],
                "sub_comments": [
                    {
                        "comment_type": 0,
                        "target_comment": {
                            "id": "69d792180000000009005602",
                            "status": 4,
                            "user": {
                                "current_user": "false",
                                "userid": "aee0c4b5f8c845336423a09fb45ed",
                                "nickname": "奈美",
                                "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31vafitat2a004a5tgi0ra6cdtpg4dj0?imageView2/2/w/120/format/jpg",
                                "red_id": "946547493",
                                "level": {
                                    "image": ""
                                },
                                "additional_tags": {},
                                "ai_agent": false
                            }
                        },
                        "id": "69d99ef3000000002a032f64",
                        "note_id": "69d4168d00000000230074a3",
                        "at_users": [],
                        "user": {
                            "nickname": "西北电焊王",
                            "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo320anrvm0mg005qc80949g9sgq2eaiao?imageView2/2/w/120/format/jpg",
                            "red_id": "27748798042",
                            "level": {
                                "image": ""
                            },
                            "additional_tags": {},
                            "ai_agent": false,
                            "current_user": "false",
                            "userid": "ac04cffada48cfed7238f8f42fb13"
                        },
                        "show_tags": [],
                        "show_type": "common",
                        "content": "宝宝很美",
                        "like_count": 2,
                        "status": 0,
                        "share_strategy": 0,
                        "liked": false,
                        "score": -2,
                        "time": 1775869683,
                        "friend_liked_msg": "",
                        "hidden": false,
                        "show_tags_v2": [],
                        "biz_label": {
                            "product_review": false,
                            "group_invite": "false",
                            "rich_text": "unknown"
                        },
                        "translation_strategy": 10,
                        "downvoted": false,
                        "collected": false
                    }
                ],
                "time": 1775735321,
                "user": {
                    "ai_agent": false,
                    "current_user": "false",
                    "userid": "aee0c4b5f8c845336423a09fb45ed",
                    "nickname": "奈美",
                    "images": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31vafitat2a004a5tgi0ra6cdtpg4dj0?imageView2/2/w/120/format/jpg",

接口信息

功能说明

请求参数

响应参数

请求示例

注意事项

请求参数

请求示例代码

返回响应

获取笔记评论_v2

接口信息#

功能说明#

请求参数#

响应参数#

请求示例#

注意事项#

请求参数

请求示例代码

返回响应

接口信息

功能说明

请求参数

响应参数

请求示例

注意事项