raw.xiaohongshu.comments小红书笔记评论
https://api.qovia.ai/v1/raw/xiaohongshu/comments一篇笔记的一级评论,按游标翻页。data 是平台返回的评论页原始字段:comments(每条含 id、content、like_count / like_view_count、sub_comment_count、sub_comments 预览、ip_location、time、pictures、user 等)、cursor、has_more、comment_count 等,不做改名、筛选或换算,评论者的 user_id 按平台原样给出。 sort 为 default(默认)时按小红书的默认顺序(置顶、热门在前),每页约 5 条;为 latest 时从新到旧,每页 10–15 条,评论者的字段与点赞数的给法和 default 不完全相同,以返回为准。 把响应里的 cursor 原样传回即可翻页(latest 的 cursor 是一段 JSON 文本,同样原样传回),has_more 为 false 时停止。回复用 raw.xiaohongshu.comment_replies 获取。没有评论或笔记不存在时返回空结果,不计费。
常见用途:口碑与评论分析、舆情监测,比如找出用户最常夸和最常抱怨的点。
- 价格
- $0.005 / 次$5 / 千次 · 固定价格
- 计费
- 成功且有结果才扣费扣费写在 meta.charged_usd
- 权限
raw:xiaohongshuAPI Key 需要这个 scope- 限速
- 不限流不按账户或接口限制每分钟请求数
请求参数
只接受下列参数,多出的参数会返回 400。
note_id笔记 ID(24 位十六进制)
格式^[0-9a-f]{24}$示例
6a14846d000000000702d0d4sort排序:default 小红书默认顺序(置顶、热门在前),latest 从新到旧
默认default可选值default · latestcursor上一页响应里的 cursor,原样传回(可能是一段 JSON 文本);第一页不传
默认格式^([0-9a-f]{24}|\{.{1,600}\})?$
响应
成功返回 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: … 开头。 |
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 调用一样计费。