笔记搜索(翻页)_v3

接口信息

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

方法: POST / GET

Content-Type: application/json

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

功能说明

根据关键词搜索小红书笔记，支持排序方式、笔记类型和发布时间筛选，支持自动翻页，使用 max_pages 和 max_seconds 控制翻页范围。按页计费（0.15元/页）。

比v2版本多了真实可访问笔记链接。

请求参数

参数名	类型	必填	默认值	说明
keyword	string	是		搜索关键词
max_pages	integer	否	1	最大翻页数
max_seconds	integer	否	50	最长运行时长（秒），超时自动停止
page	integer	否	1	起始页码
sort	string	否		排序方式：general(综合)/time_descending(最新)/popularity_descending(最多点赞)/comment_descending(最多评论)/collect_descending(最多收藏)
note_type	string	否		笔记类型：video(视频)/note(图文)/空(不限)
note_time	string	否		发布时间：day(一天内)/week(一周内)/halfyear(半年内)/空(不限)

鉴权参数：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	string	笔记类型（normal=图文，video=视频）
data.items[].noteInfo.notePublishTime	string	发布时间（格式：YYYY-MM-DD HH:MM:SS）
data.items[].noteInfo.noteLink	string	笔记链接（含xsec_token，可直接访问）
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[].noteInfo.desc	string	笔记描述
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

Bodyapplication/json

示例

{
    "success": true,
    "message": "搜索完成。成功获取 2 页数据，共 40 条记录。",
    "billing": {
        "service_fee": 0.15,
        "discount_applied": true,
        "balance_before": 471.0875,
        "balance_after": 470.7875,
        "currency": "CNY",
        "pages_billed": 2,
        "total_service_fee": 0.3,
        "transaction_ids": [
            1954407,
            1954408
        ]
    },
    "data": {
        "has_more": true,
        "items": [
            {
                "noteInfo": {
                    "noteId": "6a4532fd000000000d00bc00",
                    "title": "🇲🇾预算控制住了，家却越看越高级 ✨",
                    "noteType": "normal",
                    "notePublishTime": "2026-07-01 23:32:13",
                    "noteLink": "https://www.xiaohongshu.com/explore/6a4532fd000000000d00bc00?xsec_token=YByWniJTZ-j3qo_clvuP9cEH4In5e8Remy2wi3NR_xaAM=&xsec_source=pc_pgy",
                    "likeNum": 364,
                    "favNum": 397,
                    "cmtNum": 46,
                    "readNum": 0,
                    "videoUrl": "",
                    "videoDuration": 0,
                    "noteImages": [
                        {
                            "imageUrl": "https://sns-na-i27.xhscdn.com/oss-sg/notes_pre_post/1040g3mo322377abe7s304bcre0bmgpbgr4mfuqg?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=SRH_PRV&sign=47becfbf44a5e01ce82b89139e8e7ea0&t=6a53649b&origin=0",
                            "imageWidth": 1086,
                            "imageHeight": 1448
                        },
                        {
                            "imageUrl": "https://sns-na-i27.xhscdn.com/oss-sg/notes_pre_post/1040g3mo322377abe7s3g4bcre0bmgpbg6ncjlcg?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=825a48329034364b43af89a3a5cdae37&t=6a53649b&origin=0",
                            "imageWidth": 1086,
                            "imageHeight": 1448
                        },
                        {
                            "imageUrl": "https://sns-na-i27.xhscdn.com/oss-sg/notes_pre_post/1040g3mo322377abe7s404bcre0bmgpbgibt0rq0?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=2617ea1bd86488c4926439c808260f47&t=6a53649b&origin=0",
                            "imageWidth": 1448,
                            "imageHeight": 1086
                        },
                        {
                            "imageUrl": "https://sns-na-i27.xhscdn.com/oss-sg/notes_pre_post/1040g3mo322377abe7s4g4bcre0bmgpbgtkq1en0?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=b4ac6abcb7677f272666f14635a2b85c&t=6a53649b&origin=0",
                            "imageWidth": 1515,
                            "imageHeight": 1038
                        },
                        {
                            "imageUrl": "https://sns-na-i27.xhscdn.com/oss-sg/notes_pre_post/1040g3mo322377abe7s504bcre0bmgpbg2p9m2h8?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=188445e2204b659ffb57b698f73f5340&t=6a53649b&origin=0",
                            "imageWidth": 1087,
                            "imageHeight": 1447
                        }
                    ],
                    "desc": "很多人以为，想要有质感的家，就一定要花很多钱。 其实真正耐看的设计，从来不是靠昂贵材料，而是靠配色、比例、灯光和细节"
                },
                "userInfo": {
                    "nickName": "K Homie设计与装修",
                    "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/65951132286aab0001560853.jpg?imageView2/2/w/80/format/jpg",
                    "userId": "5bbcd76888aa6d00011b6570",
                    "fansNum": 0
                }
            },
            {
                "noteInfo": {
                    "noteId": "68c3c97a000000001c0103d5",
                    "title": "⚠️ KZ 长实橱柜避雷经历分享⚠️",
                    "noteType": "normal",
                    "notePublishTime": "2025-09-12 15:19:22",
                    "noteLink": "https://www.xiaohongshu.com/explore/68c3c97a000000001c0103d5?xsec_token=YBo8D62MZcwZ3lZ8LDFYH8-a4SLwzjy-u6QOEMrGhJSyU=&xsec_source=pc_pgy",
                    "likeNum": 17,
                    "favNum": 3,
                    "cmtNum": 9,
                    "readNum": 0,
                    "videoUrl": "",
                    "videoDuration": 0,
                    "noteImages": [
                        {
                            "imageUrl": "https://sns-na-i27.xhscdn.com/notes_pre_post/1040g3k831mardmqh68705nsup1ug8kd8935c7i0?imageView2/2/w/576/format/webp/q/87%7CimageMogr2/strip&redImage/frame/0&ap=5&sc=SRH_PRV&sign=326bf67e18df6d0823c658285f6eae6b&t=6a53649b&origin=0",
                            "imageWidth": 3213,
                            "imageHeight": 5712
                        },
                        {
                            "imageUrl": "https://sns-na-i27.xhscdn.com/notes_pre_post/1040g3k831mardmqh687g5nsup1ug8kd87f8jbco?imageView2/2/w/1440/format/webp&ap=5&sc=SRH_DTL&sign=fb235aeb304d

接口信息#

功能说明#

请求参数#

响应参数#

请求示例#

注意事项#

请求参数

请求示例代码

返回响应

接口信息

功能说明

请求参数

响应参数

请求示例

注意事项