笔记搜索(翻页)_v2

接口信息

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

方法: POST / GET

Content-Type: application/json

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

功能说明

根据关键词搜索小红书笔记，支持自动翻页，使用 max_pages 和 max_seconds 控制翻页范围。按页计费，每页计费一次（0.15元/页）。

请求参数

参数名	类型	必填	默认值	说明
keyword	string	是		搜索关键词
max_pages	integer	否	1	最大翻页数
max_seconds	integer	否	50	最长运行时长（秒），超时自动停止

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

响应参数

参数名	类型	说明
success	boolean	是否成功
message	string	响应消息
data	object	搜索结果数据
data.has_more	boolean	是否还有更多数据
data.items	array	笔记列表
data.items[].noteInfo	object	笔记信息
data.items[].noteInfo.noteId	string	笔记ID
data.items[].noteInfo.title	string	笔记标题
data.items[].noteInfo.noteType	integer	笔记类型（1=图文，2=视频）
data.items[].noteInfo.notePublishTime	string	发布时间
data.items[].noteInfo.noteLink	string	笔记链接
data.items[].noteInfo.likeNum	integer	点赞数
data.items[].noteInfo.favNum	integer	收藏数
data.items[].noteInfo.cmtNum	integer	评论数
data.items[].noteInfo.readNum	integer	浏览数
data.items[].noteInfo.videoUrl	string	视频URL（图文笔记为空）
data.items[].noteInfo.videoDuration	integer	视频时长（秒）
data.items[].noteInfo.noteImages	array	图片列表
data.items[].noteInfo.noteImages[].imageUrl	string	图片URL
data.items[].noteInfo.noteImages[].imageWidth	integer	图片宽度
data.items[].noteInfo.noteImages[].imageHeight	integer	图片高度
data.items[].userInfo	object	用户信息
data.items[].userInfo.nickName	string	用户昵称
data.items[].userInfo.avatar	string	用户头像URL
data.items[].userInfo.userId	string	用户ID
data.items[].userInfo.fansNum	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 控制最长运行时间，两者任一达到限制即停止

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

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "success": true,
    "message": "搜索完成。成功获取 2 页数据，共 40 条记录。",
    "billing": {
        "service_fee": 0.15,
        "discount_applied": true,
        "balance_before": 781.1896,
        "balance_after": 780.8896,
        "currency": "CNY",
        "pages_billed": 2,
        "total_service_fee": 0.3,
        "transaction_ids": [
            1494938,
            1494939
        ]
    },
    "data": {
        "has_more": true,
        "items": [
            {
                "noteInfo": {
                    "noteId": "69d1a81d0000000023011158",
                    "title": "今日清明",
                    "noteType": 1,
                    "notePublishTime": "2026-04-05 08:09:01",
                    "noteLink": "https://www.xiaohongshu.com/explore/69d1a81d0000000023011158?xsec_token=QBN8j8B83XBMcwZaRTIPwhsekrNMSW_0ztP0cncF_xNCY=&xsec_source=pc_pgy",
                    "likeNum": 26979,
                    "favNum": 2748,
                    "cmtNum": 517,
                    "readNum": 991015,
                    "videoUrl": "",
                    "videoDuration": 0,
                    "noteImages": [
                        {
                            "imageWidth": 1440,
                            "imageHeight": 2400,
                            "imageUrl": "http://ci.xiaohongshu.com/1040g00831uidupj61u605p5oj0ol6up1qgflevo?imageView2/2/w/1080/format/jpg"
                        },
                        {
                            "imageUrl": "http://ci.xiaohongshu.com/1040g00831uidupj61u305p5oj0ol6up1e2kf4p8?imageView2/2/w/1080/format/jpg",
                            "imageWidth": 1440,
                            "imageHeight": 2400
                        },
                        {
                            "imageUrl": "http://ci.xiaohongshu.com/1040g00831uidupj61u6g5p5oj0ol6up1l1ht520?imageView2/2/w/1080/format/jpg",
                            "imageWidth": 1440,
                            "imageHeight": 2400
                        },
                        {
                            "imageUrl": "http://ci.xiaohongshu.com/1040g00831uidupj61u505p5oj0ol6up1pfgtkkg?imageView2/2/w/1080/format/jpg",
                            "imageWidth": 1440,
                            "imageHeight": 2400
                        },
                        {
                            "imageUrl": "http://ci.xiaohongshu.com/1040g00831uidupj61u3g5p5oj0ol6up1v4opiig?imageView2/2/w/1080/format/jpg",
                            "imageWidth": 1440,
                            "imageHeight": 2400
                        },
                        {
                            "imageWidth": 1440,
                            "imageHeight": 2400,
                            "imageUrl": "http://ci.xiaohongshu.com/1040g00831uidupj61u5g5p5oj0ol6up1a5np9tg?imageView2/2/w/1080/format/jpg"
                        }
                    ]
                },
                "userInfo": {
                    "nickName": "潇湘晨报",
                    "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31qobul3rgm005p5oj0ol6up1tu11gg8?imageView2/2/w/120/format/jpg",
                    "userId": "64b898310000000014037b21",
                    "fansNum": 262570
                }
            },
            {
                "noteInfo": {
                    "noteId": "69d398c90000000022028eac",
                    "title": "🔥不愧是人民日报认证🔥14天骨盆回正\n每天5分钟，坚持2周\n分享4个动作，每个撑一分钟即可\n有效改善骨盆前倾，小腹突出，纠正假胯宽。\n每天睡前花4分钟练完，坚持2周，就能看到变化。\n#骨盆前倾[话题]# #瑜伽[话题]# #居家瑜伽日常[话题]# #居家锻炼[话题]# #睡前运动[话题]# #体态调整[话题]# #零基础瑜伽入门[话题]#",
                    "noteType": 2,
                    "notePublishTime": "2026-04-06 19:28:09",
                    "noteLink": "https://www.xiaohongshu.com/explore/69d398c90000000022028eac?xsec_token=QBir8iIpKQHwGsyJmQqHkTEyBPWYDZsTQeM39AZgdhWrI=&xsec_source=pc_pgy",
                    "likeNum": 104159,
                    "favNum": 177785,
                    "cmtNum": 626,
                    "readNum": 4844974,
                    "videoUrl": "http://v.xiaohongshu.com/stream/1/110/258/01e9d39894521c03010370019d628cf3dc_258.mp4?sign=feeaf431ec8fcb78d6acf57bb17b0b69&t=69ea4200",
                    "videoDuration": 19,
                    "noteImages": [
                        {
                            "imageUrl": "http://ci.xiaohongshu.com/1040g00831ukajdvhii0049cgorkuogngvjk9268?imageView2/2/w/1080/format/jpg",
                            "imageWidth": 1080,
                            "imageHeight": 1920
                        }
                    ]
                },
                "userInfo": {
                    "nickName": "方新爱瑜伽",
                    "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31tngti27nq0049cgorkuogngdb5t848?imageView2/2/w/120/format/jpg",
                    "userId": "58e829ec5e87e74119e242f0",
                    "fansNum": 18161
                }
            },

接口信息#

功能说明#

请求参数#

响应参数#

请求示例#

注意事项#

请求参数

请求示例代码

返回响应

接口信息

功能说明

请求参数

响应参数

请求示例

注意事项