raw.xiaohongshu.comments_v4

小红书笔记评论 V4

实时Beta

GEThttps://api.qovia.ai/v1/raw/xiaohongshu/comments_v4

一篇笔记的一级评论（原样 JSON 返回）：comments（评论内容、点赞数、回复数、时间、图片、评论者）、comment_count、cursor、has_more 等。 sort 为 default（默认）按默认顺序，latest 从新到旧。只返回第一页，没有翻页参数，返回里的 cursor / has_more 仅供参考。只对有数据的结果计费，空结果和出错都不计费。

常见用途：口碑与评论分析、舆情监测，比如找出用户最常夸和最常抱怨的点。

价格: $0.01691 / 次$16.91 / 千次 · 固定价格
计费: 成功且有结果才扣费扣费写在 meta.charged_usd
权限: raw:xiaohongshuAPI Key 需要这个 scope
限速: 仅账户限流账户每分钟上限

请求参数

作为查询参数发送

只接受下列参数，多出的参数会返回 400。

note_idstring必填

笔记 ID（24 位十六进制）

格式^[0-9a-f]{24}$

示例6a14846d000000000702d0d4

sortstring · enum

排序：default 小红书默认顺序（置顶、热门在前），latest 从新到旧

默认default可选值default · latest

curl 'https://api.qovia.ai/v1/raw/xiaohongshu/comments_v4?note_id=6a14846d000000000702d0d4' \
  -H "Authorization: Bearer $QOVIA_KEY"

把 $QOVIA_KEY 换成你的 API Key

示例响应200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "comment_count": 1127,
    "comments": [
      {
        "at_users": [],
        "score": 10000000,
        "status": 4,
        "sub_comments": [
          {
            "id": "6a44aea50000000015011aca",
            "at_users": [],
            "time": 1782886054,
            "show_tags": [],
            "show_tags_v2": [],
            "share_strategy": 0,
            "note_id": "6a428d8a00000000110176a2",
            "content": "Plq是啥",
            "liked": false,
            "friend_liked_msg": "",
            "translation_strategy": 10,
            "collected": false,
            "comment_type": 0,
            "hidden": false,
            "status": 0,
            "user": {
              "nickname": "JeansQueen",
              "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo31jo5tr1i34dg49q0r784jt4aie9v8b8?imageView2/2/w/120/format/jpg",
              "red_id": "49392603669",
              "level": {
                "image": ""
              },
              "additional_tags": {},
              "ai_agent": false,
              "current_user": "false",
              "userid": "a6ccbf41167047c48072721a5d391"
            },
            "show_type": "common",
            "like_count": 90,
            "score": -90,
            "target_comment": {
              "status": 4,
              "user": {
                "nickname": "Sophia",
                "red_id": "1260070946",
                "ai_agent": false,
                "userid": "a8566799df62d46dfdd49c994ea8d",
                "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/120/format/jpg",
                "level": {
                  "image": ""
                },
                "additional_tags": {},
                "current_user": "false"
              },
              "id": "6a447ae20000000009017269"
            },
            "biz_label": {
              "group_invite": "false",
              "rich_text": "unknown",
              "product_review": false
            },
            "downvoted": false
          }
        ],
        "time": 1782872802,
        "user": {
          "red_id": "1260070946",
          "level": {
            "image": ""
          },
          "current_user": "false",
          "userid": "a8566799df62d46dfdd49c994ea8d",
          "nickname": "Sophia",
          "additional_tags": {},
          "ai_agent": false,
          "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/1040g2jo322ahdedbn06g5pardl325giktld5t4g?imageView2/2/w/120/format/jpg"
        },
        "show_tags": [],
        "sub_comment_cursor": "{\"cursor\":\"6a44aea50000000015011aca\",\"index\":1}",
        "id": "6a447ae20000000009017269",
        "note_id": "6a428d8a00000000110176a2",
        "content": "po主的标准是无植脂末/果葡糖浆，我一周喝两杯，所以对我来说少许添加剂可以接受，不用抛开剂量谈毒性。\n每天一杯的朋友请注意，最健康零添加的是plq提名的纯美式/拿铁/澳瑞白/卡布奇诺\n关注血糖的朋友尽量不要选择果味美式和燕麦奶，升糖快",
        "liked": false,
        "downvoted": false,
        "show_type": "common",
        "comment_type": 0,
        "track_id": "interaction-service.local",
        "show_tags_v2": [
          {
            "style_id": "red",
            "pos": "cmt_bottom",
            "type": "user_top",
            "text": "置顶评论"
          },
          {
            "type": "is_author",
            "text": "作者",
            "style_id": "red",
            "pos": "post_name"
          }
        ],
        "biz_label": {
          "product_review": false,
          "group_invite": "false",
          "rich_text": "unknown"
        },
        "translation_strategy": 10,
        "collected": false,
        "like_count": 699,
        "hidden": false,
        "sub_comment_count": 22,
        "friend_liked_msg": "",
        "share_strategy": 0
      },
      {
        "comment_type": 0,
        "track_id": "interaction-service.local",
        "share_strategy": 0,
        "content": "黑巧美式呢",
        "hidden": false,
        "sub_comments": [],
        "user": {
          "current_user": "false",
          "nickname": "不舍🍊",
          "images": "https://sns-avatar-qc-ae.rednotecdn.com/avatar/61187a2cf6510d7dd88effe7.jpg?imageView2/2/w/120/format/jpg",
          "userid": "ad5071f9ceeaac01ac1b0d51d925f",
          "red_id": "605062852",
          "level": {
            "image": ""
          },
          "additional_tags": {},
          "ai_agent": false
        },
        "show_tags": [],
        "ip_location": "安徽",
        "show_type": "common",
        "collected": false,
        "id": "6ae00b7100000000130167c6",
        "note_id": "6a428d8a00000000110176a2",
        "like_count": 0,
        "status": 0,
        "friend_liked_msg": "",
        "biz_label": {
          "rich_text": "unknown",
          "product_review": false,
          "group_invite": "false"
        },
        "liked": false,
        "score": 0,
        "sub_comment_count": 0,
        "show_tags_v2": [],
        "translation_strategy": 10,
        "downvoted": false,
        "at_users": [],
        "time": 1793067889
      }
    ],
    "has_more": true,
    "all_sort_strategies": [
      {
        "type": "default",
        "optional_name": "默认",
        "suffix_name": ""
      },
      {
        "type": "latest_v2",
        "optional_name": "最新",
        "suffix_name": ""
      }
    ],
    "user_id": "655b6d46000000000802c254",
    "comment_count_l1": 513,
    "cursor": "{\"contextId\":\"ebf99b7decdd4544bf46e53f06fdd808\",\"cursor\":\"6acd02850000000007034b16\",\"index\":2,\"pageArea\":\"ALL\"}",
    "page_context": "{\"highlight\":[\"科技黄油糖浆\"],\"exposed_l1_ids\":\"6a447ae20000000009017269,6ae00b7100000000130167c6,6ada8271000000000b01a411,6ad9f367000000001303ec4b,6ad95e0a000000000a01e607,6ad8397a000000000f02d46a,6ad8319700000000020100e2,6ad7a451000000000a01ddd5,6ad6cf700000000002028cfd,6ad62337000000000f0323a1,6ad27cba000000001103a8b0,6ad0805300000000080271b3,6ad06c4f0000000008033de3,6acf0b8b0000000008002cef,6acd02850000000007034b16\"}",
    "current_sort_strategy": "latest_v2"
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.016910",
    "balance_usd": "9.983090",
    "empty": false
  }
}

目录示例，不是实时数据

响应

成功返回 HTTP 200 和统一信封：request_id、data（本接口的数据，见示例）、meta（扣费信息）。结果为空时同样是 200，meta.empty 为 true，不扣费，data 可能为空结构或 null。

响应结构详解

错误码

这个接口可能返回的错误码
code	HTTP	计费	说明
`scope_denied`	403	不扣费	这个 API Key 没有该接口需要的权限（scope）。
`endpoint_unavailable`	503	不扣费	接口暂不可用（尚未接入数据源，或价格未配置），没有执行。
`invalid_params`	400	不扣费	参数没有通过校验：缺少必填、类型或格式不对、数组超过允许的条数、有多余参数，或 POST 请求体不是 JSON 对象。单个参数的错误以参数名开头（`item_id: …`），缺少必填或多出参数以 `params: …` 开头。
`rate_limited`可重试	429	不扣费	超过账户每分钟请求上限（滑动 60 秒窗口），按 `Retry-After` 等待。
`too_many_unbilled`可重试	429	不扣费	最近 10 分钟打到数据源的请求里，空结果、不存在或被拒的有至少 50 次且占 80% 以上，放慢后再试。
`insufficient_balance`	402	不扣费	余额不足以支付这次调用，请先充值。
`upstream_busy`可重试	503	已退款	数据源繁忙或在冷却，已退款，按 `Retry-After` 重试。
`upstream_timeout`	504	已退款	数据源超时，已退款。
`upstream_error`	502 / 503	已退款	数据源返回失败，已退款。
`upstream_rejected`	400	已退款	数据源拒绝了这组参数（格式合法但不被接受），已退款。
`not_found`	404	已退款	数据源里没有这条数据（已删除或 ID 不存在），已退款。
`reservation_expired`	504	已退款	处理时间过长，已自动退款，没有返回数据。

任何请求还可能返回认证错误：401 invalid_api_key、403 account_disabled、429 too_many_auth_failures。

全部错误码

在浏览器里直接调用

需要登录并充值；调试台调用和 API 调用一样计费。

在调试台试用创建 API Key

请求参数

响应

错误码

小红书的其他接口