小红书 API
用 REST 接口读取小红书的笔记、评论、用户资料和关键词搜索：共 11 个已上线接口，同一个 API Key，同一个 JSON 外层。下面是完整的接口列表和一个真实的请求与返回示例。
新账号有 50 次试用调用，之后按成功调用从预充值余额扣费，详见 定价。
小红书 API 的 11 个接口
每个接口的参数、返回字段和代码示例见 API 参考。
- 小红书笔记详情
GET /v1/raw/xiaohongshu/note一篇小红书笔记，data 是平台返回的笔记原始字段，不做改名、筛选或换算：note_id、title、desc（正文，含平台的 [话题] 标记）、type（normal 图文 / video 视频）、user、interact_info（点赞/评论/收藏/分享数，平台以字符串给出的精确值）、tag_list、image_list、ip_location、time（Unix 秒）等，视频笔记另有 video。 笔记不存在或已删除时返回空结果，不计费。必填参数：note_id - 小红书笔记评论
GET /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 获取。没有评论或笔记不存在时返回空结果，不计费。必填参数：note_id - 小红书评论回复
GET /v1/raw/xiaohongshu/comment_replies一条一级评论下的回复（二级评论），从旧到新，每页约 5 条。data 是平台返回的回复页原始字段：comments（每条含 id、content、like_count、time、user、target_comment 等）、cursor、has_more 等，不做改名、筛选或换算。 comment_id 是 raw.xiaohongshu.comments 返回的评论 id。把响应里的 cursor（一段 JSON 文本）原样传回即可翻页，has_more 为 false 时停止。没有回复时返回空结果，不计费。必填参数：note_id, comment_id - 小红书用户详情
GET /v1/raw/xiaohongshu/user小红书用户主页，data 是平台返回的用户资料原始字段，不做改名、筛选或换算：userid、red_id（小红书号）、nickname、fans、follows、interactions、note_num_stat、gender、ip_location、desc、imageb 等。 用户不存在时返回 404，不计费。必填参数：user_id - 小红书用户笔记列表
GET /v1/raw/xiaohongshu/user_notes一个用户发布的笔记，置顶笔记在前，其余从新到旧，每页约 20 篇。data 是平台返回的笔记列表原始字段：notes（每篇含 id、title、desc、type、likes、comments_count、collected_count、share_count、create_time、images_list、video_info_v2、user、cursor、sticky 等）、has_more，不做改名、筛选或换算。 翻页：把最后一篇笔记的 cursor 传回（它就是该篇笔记的 id），has_more 为 false 时停止。没有笔记或用户不存在时返回空结果，不计费。必填参数：user_id - 小红书笔记搜索
GET /v1/raw/xiaohongshu/search按关键词搜索小红书笔记，每页 20 条。data 是平台返回的搜索结果原始字段：items（每项含 model_type 和 note；note 里有 id、xsec_token、title、desc、type、liked_count、comments_count、collected_count、shared_count、timestamp、images_list、video_info_v2、user 等）及平台的其他字段，不做改名、筛选或换算；非笔记类的结果项（model_type 不是 note）也原样保留，只有笔记按条计费。 可按综合、最新、最多点赞、最多评论或最多收藏排序，按笔记类型和发布时间筛选。用 page 翻页；响应不含 has_more，翻到没有结果（空结果，不计费）为止。必填参数：keyword - 小红书笔记详情 V4
GET /v1/raw/xiaohongshu/note_v4一篇小红书笔记（按图文笔记取数，原样 JSON 返回）：note_list（笔记 ID、标题、正文、点赞/评论/收藏/分享数、话题、发布时间、IP 属地、图片）和 user（作者）。不返回视频链接和时长。 只对有数据的结果计费，空结果和出错都不计费。必填参数：note_id - 小红书笔记评论 V4
GET /v1/raw/xiaohongshu/comments_v4一篇笔记的一级评论（原样 JSON 返回）：comments（评论内容、点赞数、回复数、时间、图片、评论者）、comment_count、cursor、has_more 等。 sort 为 default（默认）按默认顺序，latest 从新到旧。 只返回第一页，没有翻页参数，返回里的 cursor / has_more 仅供参考。 只对有数据的结果计费，空结果和出错都不计费。必填参数：note_id - 小红书用户详情 V4
GET /v1/raw/xiaohongshu/user_v4小红书用户主页（原样 JSON 返回）：昵称、小红书号、粉丝数、关注数、获赞与收藏、认证、IP 属地、简介和头像等。 只对有数据的结果计费，空结果和出错都不计费。必填参数：user_id - 小红书用户笔记列表 V3
GET /v1/raw/xiaohongshu/user_notes_v3一个用户发布的笔记（原样 JSON 返回）：notes（标题、点赞等互动数、封面和图片）、has_more、tags 等。 支持翻页：把 notes 里最后一篇笔记的 cursor 传回，has_more 表示后面是否还有。只对有数据的结果计费，空结果和出错都不计费。必填参数：user_id - 小红书笔记搜索 V4
GET /v1/raw/xiaohongshu/search_v4按关键词搜索小红书笔记（原样 JSON 返回）：items（每条含笔记卡片：标题、作者、互动数、封面和图片）等。 只返回第一页（约 20 条），没有翻页参数。 可按综合、最新、最多点赞、最多评论或最多收藏排序，按笔记类型筛选，发布时间只支持不限、一天内、一周内。 只对有数据的结果计费，空结果和出错都不计费。必填参数：keyword
请求与返回示例
小红书笔记详情（GET /v1/raw/xiaohongshu/note）。示例取自接口目录，不是实时数据；完整返回还带 request_id 和 meta。
curl 'https://api.qovia.ai/v1/raw/xiaohongshu/note?note_id=6a14846d000000000702d0d4' \ -H "Authorization: Bearer $QOVIA_KEY"
{
"data": {
"at_user_list": [],
"desc": "高三后期。\n教室里最常见的饮料已经不是矿泉水了。\n⸻\n是咖啡。\n⸻\n以前上课。\n桌角摆着的是农夫山泉。\n或者可口可乐。\n…",
"image_list": [
{
"file_id": "notes_pre_post/1040g3k8320jnafonm8805pg9fsr1hjdj6tlakno",
"height": 1274,
"info_list": [],
"live_photo": false,
"stream": {},
"trace_id": "notes_pre_post/1040g3k8320jnafonm8805pg9fsr1hjdj6tlakno",
"url": "http://sns-na-i27.xhscdn.com/notes_pre_post/1040g3k8320jnafonm8805pg9fsr1hjdj6tlakno?imageView2/2/w/1080/format/webp",
"width": 1125
}
],
"interact_info": {
"collected": false,
"collected_count": "1153",
"comment_count": "1072",
"followed": false,
"liked": false,
"liked_count": "11045",
"nice_count": "11045",
"relation": "none",
"share_count": "359",
"sticky": false
},
"ip_location": "山东",
"last_update_time": 1790824361,
"note_id": "6a14846d000000000702d0d4",
"share_info": {
"un_share": false
},
"tag_list": [
{
"id": "5c50fb9b000000001c001a21",
"link": "xhsdiscover://topic/v2/5c50fb9b4b25ed000140fa85?page_source=note_feed.click_new_big&source=normal&pre_source=tab_feed&topic_name=%E6%99%9A%E8%87%AA%E4%B9%A0",
"name": "晚自习",
"type": "topic"
},
{
"id": "5acc344be39faf54a1cbced9",
"link": "xhsdiscover://topic/v2/5acc349cec9d13037b5bb162?page_source=note_feed.click_new_big&source=normal&pre_source=tab_feed&topic_name=%E9%AB%98%E8%80%83%E5%80%92%E8%AE%A1%E6%97%B6",
"name": "高考倒计时",
"type": "topic"
},
{
"id": "68216a510000000012019969",
"link": "xhsdiscover://topic/v2/68216a520063000000000001?page_source=note_feed.click_new_big&source=normal&pre_source=tab_feed&topic_name=%E6%88%91%E7%9A%84%E9%AB%98%E4%B8%89%E8%AE%B0%E5%BF%86",
"name": "我的高三记忆",
"type": "topic"
}
],
"time": 1779729517,
"title": "高三后期，班里开始靠咖啡续命了",
"type": "normal",
"user": {
"avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo3203ufh702q005pg9fsr1hjdj3nunboo?imageView2/2/w/80/format/jpg",
"nick_name": "说***吗",
"red_official_verify_type": 0,
"user_id": "66097f36000000000600cdb3"
}
}
}让 AI 工具直接用小红书数据
Qovia 同时是一个 MCP 服务。在 Claude Code 里运行下面这条命令，查找和查看接口不需要 Key；调用接口时按 MCP 文档 配置你的 API Key。Cursor 和 VS Code 的配置也在那里。
claude mcp add --transport http qovia https://api.qovia.ai/mcp常见问题
怎么调用小红书 API？
向 https://api.qovia.ai 发 GET 请求，例如 /v1/raw/xiaohongshu/…，在请求头里带上 Authorization: Bearer 加你的 API Key。成功时返回 HTTP 200 和 request_id、data、meta 三个字段。本页列出了全部 11 个接口，每个接口的参数见 API 参考。
小红书有官方开放的数据 API 吗？
小红书没有面向开发者公开开放的笔记、评论数据接口，官方开放平台主要服务商家和合作伙伴。Qovia 把小红书的公开笔记、评论、用户和搜索数据做成了统一的 REST 接口，拿 API Key 就能调用。
能拿到小红书的哪些数据？
笔记详情（标题、正文、点赞/评论/收藏/分享数、话题、发布时间、IP 属地、图片和视频）、笔记评论（默认或按最新排序）、评论回复、用户详情、用户的笔记列表，以及按关键词搜索笔记。品牌投放用的蒲公英博主数据在「小红书蒲公英」页面。
需要提供小红书账号或 cookie 吗？
不需要。你只需要一个 Qovia 的 API Key，不用自己维护账号、cookie、代理或签名算法。
怎么计费？
预充值，按次计费，只对返回了数据的成功调用扣费；空结果、报错和超时都不扣费，每次返回里都写着这次扣了多少（meta.charged_usd）。每个接口的单价见 API 参考。
能接到 Claude、Cursor 这类 AI 工具里吗？
可以。Qovia 同时是一个 MCP Server（https://api.qovia.ai/mcp），在 Claude Code、Cursor、VS Code 里配置好 API Key 后，就能直接让 AI 找接口、拉数据、做总结。
使用这些数据要注意什么？
Qovia 提供的是数据接口服务，不拥有也不转售底层内容。拿到的数据请按适用法律和小红书的平台规则使用，详见服务条款。