1. 小红书系列插件
AI Conductor工具箱
  • 通用自媒体工具
    • 视频文件转音频
      POST
    • 音/视频转写文字
      POST
    • 音/视频转写文字_v2
      POST
    • 作品分享链接解析
      POST
    • 获取视频下载链接
      POST
    • 获取音视频时长
      POST
    • 图片永久云储存
      POST
    • 通用RSS解析器
      POST
  • 抖音系列插件
    • 获取作品详情
      POST
    • 获取作品评论
      POST
    • 获取用户视频_同步
      POST
    • 获取用户视频_同步(含详情)
      POST
    • 获取用户视频_异步_提交
      POST
    • 获取用户视频_异步_查询
      POST
    • 获取用户详情
      POST
    • 抖音用户搜索
      POST
    • 抖音视频搜索
      POST
    • 抖音视频搜索_高速
      POST
    • 作品链接转文字_v1
      POST
    • 作品链接转文字_v2
      POST
    • 获取视频OSS链接
      POST
  • Markdown转换器
    • Markdown转PNG
    • Markdown转PDF
    • Markdown转HTML
    • Markdown转XLSX
    • Markdown转Docx
    • 文档转Markdown
    • Markdown转XHS
    • Markdown转Mindmap
    • URL转Markdown
    • Markdown转TXT
  • 网页工具
    • 网页截图工具
    • 网页发布工具
  • 小红书系列插件
    • 获取笔记详情_v2
      POST
    • 获取笔记详情_v3
      POST
    • 笔记搜索(翻页)_v2
      POST
    • 获取用户详情_v2
      POST
    • 获取用户笔记(翻页)_v2
      POST
    • 获取笔记评论_v2
      POST
    • 获取用户笔记(翻页)_v3
      POST
    • 获取小红书热榜
      POST
  • 微信公众号系列插件
    • 获取历史文章
    • 获取文章数据
    • 获取授权密钥
    • 文章存为草稿
    • 上传图片素材
    • 发布文章草稿
    • 读取文章内容
    • MD 转 WXHTML
  • 图像处理
    • 智能美颜
    • 智能换脸
    • 智能变美
    • 等比缩小
  • 通用工具
    • 网络搜索
    • OCR识别
    • 必应搜索
  • 扣子工作流
    • 获取公众号历史文章
  • 消费管理
    • 查询账户余额
    • 查询消费记录
  • 图片生成工具
    • Seedream模型
  1. 小红书系列插件

获取用户笔记(翻页)_v2

POST
/api/xhs_user_notes_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_idstring是小红书用户ID,从用户主页链接 /user/profile/ 后提取
max_pagesinteger否1最大翻页数
max_secondsinteger否50最长运行时长(秒),超时自动停止
鉴权参数:api_key 通过请求头 Authorization: Bearer <api_key> 传递,不再列入请求参数表。

响应参数#

参数名类型说明
successboolean是否成功
messagestring响应消息
dataobject笔记列表数据
data.notesarray笔记列表
data.notes[].noteIdstring笔记ID
data.notes[].timeinteger发布时间(毫秒时间戳)
data.notes[].titlestring笔记标题
data.notes[].typestring笔记类型(video / normal)
data.notes[].descstring笔记描述
data.notes[].time_descstring发布时间描述(如"昨天17:41"、"05-30")
data.notes[].likesinteger点赞数
data.notes[].comments_countinteger评论数
data.notes[].collected_countinteger收藏数
data.notes[].shared_countinteger分享数
data.notes[].ip_locationstringIP属地
data.notes[].stickyboolean是否置顶
data.notes[].is_goods_noteboolean是否商品笔记
data.notes[].has_musicboolean是否含音乐
data.notes[].userobject用户信息
data.notes[].user.user_idstring用户ID
data.notes[].user.nicknamestring用户昵称
data.notes[].user.avatarstring用户头像URL
data.notes[].imagesarray图片列表
data.notes[].images[].urlstring缩略图URL
data.notes[].images[].url_size_largestring大图URL
data.notes[].images[].widthinteger图片宽度
data.notes[].images[].heightinteger图片高度
data.notes[].videoobject视频信息(仅 type=video 时存在)
data.notes[].video.durationinteger视频时长(秒)
data.notes[].video.widthinteger视频宽度
data.notes[].video.heightinteger视频高度
data.notes[].video.cover_urlstring视频封面URL
data.notes[].video.thumbnail_urlstring视频缩略图URL
data.notes[].video.streamsarray视频流列表
data.notes[].video.streams[].codecstring编码格式(h264/hevc/av1)
data.notes[].video.streams[].qualitystring画质(HD/FHD)
data.notes[].video.streams[].urlstring视频流URL
data.notes[].video.streams[].backup_urlsarray备用URL列表
data.notes[].video.streams[].widthinteger视频宽度
data.notes[].video.streams[].heightinteger视频高度
data.notes[].video.streams[].durationinteger时长(毫秒)
data.notes[].video.streams[].fpsinteger帧率
data.notes[].video.streams[].formatstring格式(mp4)
data.notes[].video.streams[].sizeinteger文件大小(字节)
billingobject计费信息
billing.service_feefloat单页服务费
billing.discount_appliedboolean是否应用折扣
billing.balance_beforefloat扣费前余额
billing.balance_afterfloat扣费后余额
billing.currencystring货币类型(CNY)
billing.pages_billedinteger实际计费页数
billing.total_service_feefloat总服务费
billing.transaction_idsarray交易ID列表

请求示例#

注意事项#

1.
按页计费,每成功获取一页数据扣费一次
2.
max_pages 控制最大翻页数,max_seconds 控制最长运行时间,两者任一达到限制即停止
3.
余额不足时自动停止翻页,已获取的数据正常返回
4.
采用后扣费模式,仅成功获取数据的页面才计费
5.
user_id 从小红书用户主页链接中提取,格式为 https://www.xiaohongshu.com/user/profile/{user_id}
6.
视频笔记(type=video)会额外返回 video 对象,包含视频流、封面、时长等信息;图文笔记(type=normal)无此字

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "user_id": "5e7e31a20000000001004b48", 
    "max_pages": 1, 
    "max_seconds": 50
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://plugin.aiconductor.fun/api/xhs_user_notes_v2' \
--header 'Authorization: Bearer {{AICONDUCTOR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "user_id": "5e7e31a20000000001004b48", 
    "max_pages": 1, 
    "max_seconds": 50
}'

返回响应

🟢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
                        }
                    ]
                }
            },
            {
   
修改于 2026-06-11 03:32:03
上一页
获取用户详情_v2
下一页
获取笔记评论_v2
Built with