获取用户笔记(翻页)_v2

接口信息

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

方法: POST / GET

Content-Type: application/json

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

功能说明

根据用户ID获取小红书用户笔记列表，支持自动翻页，使用 max_pages 和 max_seconds 控制翻页范围。按页计费，每页计费一次（0.15元/页）。

请求参数

参数名	类型	必填	默认值	说明
user_id	string	是		小红书用户ID，从用户主页链接 `/user/profile/` 后提取
max_pages	integer	否	1	最大翻页数
max_seconds	integer	否	50	最长运行时长（秒），超时自动停止

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

响应参数

参数名	类型	说明
success	boolean	是否成功
message	string	响应消息
data	object	笔记列表数据
data.notes	array	笔记列表
data.notes[].noteId	string	笔记ID
data.notes[].title	string	笔记标题
data.notes[].type	string	笔记类型（video/normal）
data.notes[].time	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 控制最长运行时间，两者任一达到限制即停止

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

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

user_id 从小红书用户主页链接中提取，格式为 https://www.xiaohongshu.com/user/profile/{user_id}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "success": true,
    "message": "用户笔记获取完成。成功获取 1 页数据，共 20 条记录。",
    "billing": {
        "service_fee": 0.15,
        "discount_applied": true,
        "balance_before": 780.7396,
        "balance_after": 780.5896,
        "currency": "CNY",
        "pages_billed": 1,
        "total_service_fee": 0.15,
        "transaction_ids": [
            1494944
        ]
    },
    "data": {
        "notes": [
            {
                "noteId": "69e7440a000000002301291d",
                "time": 1776763914000,
                "title": "光遇狂欢季季卡与非季卡物品展示，大家会入手季卡吗？#光遇[话",
                "type": "video"
            },
            {
                "noteId": "69e5ea99000000001b00102d",
                "time": 1776675481000,
                "title": "新季节动作转场来啦#光遇[话题]# #光遇追光计划[话题]#",
                "type": "video"
            },
            {
                "noteId": "69e493b9000000002302099c",
                "time": 1776587705000,
                "title": "绊爱穿搭展示！最后一套萌炸了！#光遇[话题]# #光遇追光计",
                "type": "video"
            },
            {
                "noteId": "69e338c3000000001d01e381",
                "time": 1776498883000,
                "title": "光遇绊爱联动新物品展示#光遇[话题]# #光遇追光计划[话题",
                "type": "video"
            },
            {
                "noteId": "69e20a490000000023011052",
                "time": 1776421449000,
                "title": "光遇绊爱全景演唱会！这还是我认识的光遇吗！还有新物品！#光遇",
                "type": "video"
            },
            {
                "noteId": "69e09b870000000023021f0a",
                "time": 1776327559000,
                "title": "我们这次是真的分手了#光遇[话题]# #光遇追光计划[话题]",
                "type": "video"
            },
            {
                "noteId": "69df56c60000000021005209",
                "time": 1776244422000,
                "title": "武士裤真的要复刻了！#光遇[话题]# #光遇追光计划[话题]",
                "type": "video"
            },
            {
                "noteId": "69de28f800000000230240ef",
                "time": 1776167160000,
                "title": "备注了什么呀#光遇[话题]# #光遇追光计划[话题]# #光",
                "type": "video"
            },
            {
                "noteId": "69dca467000000001d019efd",
                "time": 1776067688000,
                "title": "光遇红娘来了 （f：@Sky白昼 ）#光遇[话题]# #光遇",
                "type": "video"
            },
            {
                "noteId": "69d4883b00000000210061f4",
                "time": 1775536187000,
                "title": "光之子们哈喽#光遇[话题]# #光遇追光计划[话题]# #光",
                "type": "video"
            },
            {
                "noteId": "69d080660000000023013215",
                "time": 1775272038000,
                "title": "宝宝说她新学了一个哄人方式#光遇[话题]# #光遇追光计划[",
                "type": "video"
            },
            {
                "noteId": "69c793630000000023026c07",
                "time": 1774687075000,
                "title": "当我的崽崽问我凭什么教育她，于是我拿出了我的…#光遇[话题]",
                "type": "video"
            },
            {
                "noteId": "69c63f7d0000000023021938",
                "time": 1774600061000,
                "title": "光遇狂欢季物品展示#光遇[话题]# #光遇追光计划[话题]#",
                "type": "normal"
            },
            {
                "noteId": "69c4fd7e0000000023011182",
                "time": 1774517630000,
                "title": "早说你喜欢呀#光遇[话题]# #光遇追光计划[话题]# #光",
                "type": "video"
            },
            {
                "noteId": "69c4fab7000000001d018540",
                "time": 1774516919000,
                "title": "光遇的腿控福利#光遇[话题]# #光遇追光计划[话题]# #",
                "type": "video"
            },
            {
                "noteId": "69c25428000000001d01b556",
                "time": 1774343209000,
                "title": "当我没文化又想撩时#光遇[话题]# #光遇追光计划[话题]#",
                "type": "video"
            },
            {
                "noteId": "69bfaa76000000002200d4c1",
                "time": 1774168694000,
                "title": "家崽们做完每日任务可以先不急着提交#光遇[话题]# #光遇追",
                "type": "video"
            },
            {
                "noteId": "69b682f3000000001d01c046",
                "time": 1773568755000,
                "title": "新季节无翼有可能坠机？小金人位置改动，依旧有坠机风险！#光遇",
                "type": "video"
            },
            {
                "noteId": "69b294480000000022032375",
                "time": 1773311048000,
                "title": "发型和裤子是代币！寻宝节新物品获取方式来啦！#光遇[话题]#",
                "type": "video"
            },
            {
                "noteId": "69afe9060000000022031ea1",
                "time": 1773136134000,
                "title": "子弹要飞多久才会变成和平的白鸽#光遇[话题]# #光遇追光计",
                "type": "video"
            }
        ]
    }
}

接口信息#

功能说明#

请求参数#

响应参数#

请求示例#

注意事项#

请求参数

请求示例代码

返回响应

接口信息

功能说明

请求参数

响应参数

请求示例

注意事项