获取用户笔记(翻页)_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[].time	integer	发布时间（毫秒时间戳）
data.notes[].title	string	笔记标题
data.notes[].type	string	笔记类型（`video` / `normal`）
data.notes[].desc	string	笔记描述
data.notes[].time_desc	string	发布时间描述（如"昨天17:41"、"05-30"）
data.notes[].likes	integer	点赞数
data.notes[].comments_count	integer	评论数
data.notes[].collected_count	integer	收藏数
data.notes[].shared_count	integer	分享数
data.notes[].ip_location	string	IP属地
data.notes[].sticky	boolean	是否置顶
data.notes[].is_goods_note	boolean	是否商品笔记
data.notes[].has_music	boolean	是否含音乐
data.notes[].user	object	用户信息
data.notes[].user.user_id	string	用户ID
data.notes[].user.nickname	string	用户昵称
data.notes[].user.avatar	string	用户头像URL
data.notes[].images	array	图片列表
data.notes[].images[].url	string	缩略图URL
data.notes[].images[].url_size_large	string	大图URL
data.notes[].images[].width	integer	图片宽度
data.notes[].images[].height	integer	图片高度
data.notes[].video	object	视频信息（仅 `type=video` 时存在）
data.notes[].video.duration	integer	视频时长（秒）
data.notes[].video.width	integer	视频宽度
data.notes[].video.height	integer	视频高度
data.notes[].video.cover_url	string	视频封面URL
data.notes[].video.thumbnail_url	string	视频缩略图URL
data.notes[].video.streams	array	视频流列表
data.notes[].video.streams[].codec	string	编码格式（h264/hevc/av1）
data.notes[].video.streams[].quality	string	画质（HD/FHD）
data.notes[].video.streams[].url	string	视频流URL
data.notes[].video.streams[].backup_urls	array	备用URL列表
data.notes[].video.streams[].width	integer	视频宽度
data.notes[].video.streams[].height	integer	视频高度
data.notes[].video.streams[].duration	integer	时长（毫秒）
data.notes[].video.streams[].fps	integer	帧率
data.notes[].video.streams[].format	string	格式（mp4）
data.notes[].video.streams[].size	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}

视频笔记（type=video）会额外返回 video 对象，包含视频流、封面、时长等信息；图文笔记（type=normal）无此字

请求示例代码

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": 421.3835,
        "balance_after": 421.0835,
        "currency": "CNY",
        "pages_billed": 2,
        "total_service_fee": 0.3,
        "transaction_ids": [
            1761390,
            1761391
        ]
    },
    "data": {
        "notes": [
            {
                "noteId": "6a29314e000000003502dc4e",
                "time": 1781084494000,
                "title": "我死后，世界开始爱我",
                "type": "video",
                "desc": "我死后，世界开始爱我#光遇[话题]# #光遇追光计划[话题]# #我的宝藏光遇[话题]# #光遇寻宝节[话题]#",
                "time_desc": "昨天17:41",
                "likes": 76,
                "comments_count": 0,
                "collected_count": 3,
                "shared_count": 0,
                "ip_location": "福建",
                "sticky": false,
                "is_goods_note": false,
                "has_music": false,
                "user": {
                    "user_id": "5e7e31a20000000001004b48",
                    "nickname": "明月",
                    "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/1040g2jo31ngo8mtp52005nju66h08iq8d5hgrg8?imageView2/2/w/80/format/jpg"
                },
                "images": [
                    {
                        "url": "https://sns-i11.rednotecdn.com/1040g2sg3217tfqh774005nju66h08iq8u1fdbb0?imageView2/2/w/576/format/heif/q/58%7CimageMogr2/strip&redImage/frame/0&ap=12&sc=USR_PRV&sign=3b19c77f977222907807506ce2af7e46&t=6a2a2c40&src=A",
                        "url_size_large": "https://sns-i11.rednotecdn.com/1040g2sg3217tfqh774005nju66h08iq8u1fdbb0?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=12&sc=USR_DTL&sign=3b19c77f977222907807506ce2af7e46&t=6a2a2c40&src=A",
                        "width": 972,
                        "height": 1296
                    }
                ],
                "video": {
                    "duration": 13,
                    "width": 1080,
                    "height": 2132,
                    "cover_url": "https://sns-i11.rednotecdn.com/110/0/01ea29313370ff2a0010000000019eb0e8a1c4_0.jpg?imageView2/2/w/1440/format/heif/q/45&redImage/frame/0&ap=12&sc=USR_DTL&sign=6c363523856d2a6bc351bb21cf776bda&t=6a2a2c40&src=A",
                    "thumbnail_url": "https://sns-i11.rednotecdn.com/frame/110/0/01ea29313370ff2a0010000000019eb0e8c4b8_0.webp?imageView2/2/w/5000/h/5000/format/heif/q/56&redImage/frame/0&ap=12&sc=USR_ORG&sign=3cfb098924a5b9ce63e4368aec8e9ff2&t=6a2a2c40&src=A",
                    "streams": [
                        {
                            "codec": "h264",
                            "quality": "HD",
                            "url": "http://sns-v8.rednotecdn.com/stream/1/110/258/01ea29313370ff2a010370019eb0e8b006_258.mp4",
                            "backup_urls": [
                                "http://sns-v10.rednotecdn.com/stream/1/110/258/01ea29313370ff2a010370019eb0e8b006_258.mp4"
                            ],
                            "width": 720,
                            "height": 1422,
                            "duration": 12400,
                            "fps": 30,
                            "format": "mp4",
                            "size": 1085370
                        },
                        {
                            "codec": "hevc",
                            "quality": "HD",
                            "url": "http://sns-v8.rednotecdn.com/stream/1/110/309/01ea29313370ff2a010370019eb0e9298c_309.mp4",
                            "backup_urls": [
                                "http://sns-v10.rednotecdn.com/stream/1/110/309/01ea29313370ff2a010370019eb0e9298c_309.mp4"
                            ],
                            "width": 720,
                            "height": 1422,
                            "duration": 12384,
                            "fps": 60,
                            "format": "mp4",
                            "size": 713965
                        },
                        {
                            "codec": "hevc",
                            "quality": "FHD",
                            "url": "http://sns-v8.rednotecdn.com/stream/1/110/301/01ea29313370ff2a010370019eb0e93fd4_301.mp4",
                            "backup_urls": [
                                "http://sns-v10.rednotecdn.com/stream/1/110/301/01ea29313370ff2a010370019eb0e93fd4_301.mp4"
                            ],
                            "width": 1080,
                            "height": 2132,
                            "duration": 12384,
                            "fps": 60,
                            "format": "mp4",
                            "size": 1067477
                        }
                    ]
                }
            },
            {

接口信息#

功能说明#

请求参数#

响应参数#

请求示例#

注意事项#

请求参数

请求示例代码

返回响应

接口信息

功能说明

请求参数

响应参数

请求示例

注意事项