获取笔记详情_v3

接口信息

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

方法: POST / GET

Content-Type: application/json

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

功能说明

根据笔记ID获取小红书笔记详情，包括标题、描述、用户信息、图片列表、互动数据、标签等。按次计费。

请求参数

参数名	类型	必填	默认值	说明
note_id	string	是		笔记ID，从小红书链接 `/explore/` 后提取，如 `6915bf1300000000070380e4`

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

响应参数

参数名	类型	说明
success	boolean	是否成功
message	string	响应消息
note_data	object	笔记详情数据
note_data.note_id	string	笔记ID
note_data.type	string	笔记类型（normal/video等）
note_data.title	string	笔记标题
note_data.desc	string	笔记描述
note_data.time	integer	发布时间（毫秒时间戳）
note_data.video	string	视频信息（图文笔记为空）
note_data.user	object	用户信息
note_data.user.user_id	string	用户ID
note_data.user.nickname	string	用户昵称
note_data.user.avatar	string	用户头像URL
note_data.image_list	array	图片列表
note_data.image_list[].url	string	图片URL
note_data.image_list[].width	integer	图片宽度
note_data.image_list[].height	integer	图片高度
note_data.image_list[].live_photo	boolean	是否为Live Photo
note_data.interact_info	object	互动数据
note_data.interact_info.liked_count	string	点赞数
note_data.interact_info.collected_count	string	收藏数
note_data.interact_info.comment_count	string	评论数
note_data.interact_info.share_count	string	分享数
note_data.tag_list	array	标签列表
note_data.tag_list[].id	string	标签ID
note_data.tag_list[].name	string	标签名称
note_data.tag_list[].type	string	标签类型
billing	object	计费信息
billing.service_fee	float	服务费
billing.discount_applied	boolean	是否应用折扣
billing.balance_before	float	扣费前余额
billing.balance_after	float	扣费后余额
billing.currency	string	货币类型（CNY）
billing.transaction_id	string	交易ID

请求示例

注意事项

note_id 从小红书链接中提取，链接格式为 https://www.xiaohongshu.com/explore/{note_id}

笔记可能因被隐藏、删除或设置访问权限而无法获取，此时返回失败信息且不扣费

采用后扣费模式，仅笔记详情获取成功时才扣费

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

成功示例成功示例

{
    "success": true,
    "message": "笔记详情获取成功",
    "note_data": {
        "note_id": "6915bf1300000000070380e4",
        "type": "video",
        "title": "不开玩笑，这样炖的牛肉真的很好吃‼️",
        "desc": "#牛肉[话题]# #做菜我是认真的[话题]# #超级下饭的[话题]# #红烧牛肉面[话题]# #这样做饭也太省事了吧[话题]# #冬天就是要吃肉[话题]#",
        "user": {
            "user_id": "5f9452c20000000001006fdf",
            "nickname": "",
            "avatar": "https://sns-avatar-qc.xhscdn.com/avatar/0dd6f7e91ce0bea602fbc47515b7c72f.jpg"
        },
        "image_list": [
            {
                "url_default": "",
                "url_pre": "",
                "width": 1080,
                "height": 1440,
                "live_photo": false
            }
        ],
        "interact_info": {
            "liked_count": "2175",
            "collected_count": "1659",
            "comment_count": "95",
            "share_count": "277"
        },
        "tag_list": [
            {
                "id": "5bff89fc88e98b00013ed2fd",
                "name": "牛肉",
                "type": "topic"
            },
            {
                "id": "5f9a6ded0000000001000e06",
                "name": "做菜我是认真的",
                "type": "topic"
            },
            {
                "id": "611f4fd3000000000101cf60",
                "name": "超级下饭的",
                "type": "topic"
            },
            {
                "id": "5a543d097642f15cd547eb1e",
                "name": "红烧牛肉面",
                "type": "topic"
            },
            {
                "id": "64e56d0d000000000f00e298",
                "name": "这样做饭也太省事了吧",
                "type": "topic"
            },
            {
                "id": "617c07140000000001003cb0",
                "name": "冬天就是要吃肉",
                "type": "topic"
            }
        ],
        "time": 1763032851000,
        "video": {
            "capa": {
                "duration": 208
            },
            "consumer": {},
            "image": {
                "first_frame_fileid": "110/0/01e915bdd2649dc60010000000019a7cf26c48_0.jpg",
                "thumbnail_fileid": "frame/110/0/01e915bdd2649dc60010000000019a7cf3e522_0.webp"
            },
            "media": {
                "stream": {
                    "av1": [],
                    "h264": [
                        {
                            "audio_bitrate": 64041,
                            "audio_channels": 2,
                            "audio_codec": "aac",
                            "audio_duration": 208815,
                            "avg_bitrate": 2414129,
                            "backup_urls": [
                                "http://sns-bak-v8.xhscdn.com/stream/79/110/259/01e915bdd2649dc6010370039a7cf444ad_259.mp4"
                            ],
                            "default_stream": 0,
                            "duration": 208816,
                            "format": "mp4",
                            "fps": 30,
                            "hdr_type": 0,
                            "height": 1280,
                            "master_url": "http://sns-video-alos.xhscdn.com/stream/79/110/259/01e915bdd2649dc6010370039a7cf444ad_259.mp4?sign=ef9a2a4040ba1209e315ee4ae78591ee&t=69e8447e",
                            "psnr": 0,
                            "quality_type": "HD",
                            "rotate": 0,
                            "size": 63013615,
                            "ssim": 0,
                            "stream_desc": "MINI_APP_259",
                            "stream_type": 259,
                            "video_bitrate": 2343742,
                            "video_codec": "h264",
                            "video_duration": 208800,
                            "vmaf": -1,
                            "volume": 0,
                            "weight": 62,
                            "width": 720
                        }
                    ],
                    "h265": [
                        {
                            "audio_bitrate": 128072,
                            "audio_channels": 2,
                            "audio_codec": "aac",
                            "audio_duration": 208815,
                            "avg_bitrate": 2026043,
                            "backup_urls": [
                                "http://sns-bak-v8.xhscdn.com/stream/79/110/114/01e915bdd2649dc64f0370019a7cf8e00d_114.mp4"
                            ],
                            "default_stream": 0,
                            "duration": 208816,
                            "format": "mp4",
                            "fps": 30,
                            "hdr_type": 0,
                            "height": 1280,
                            "master_url": "http://sns-video-alos.xhscdn.com/stream/79/110/114/01e915bdd2649dc64f0370019a7cf8e00d_114.mp4?sign=81030765a6a1d1553ea75461ede0eea5&t=69e8447e",
                            "psnr": 37.694000244140625,
                            "quality_type": "HD",
                            "rotate": 0,
                            "size": 52883783,
                            "ssim": 0,
                            "stream_desc": "X265_MP4_WEB_114_h5",
                            "stream_type": 114,
                            "video_bitrate": 1891483,
                            "video_codec": "hevc",
                            "video_duration": 208800,
                            "vmaf": -1,
                            "volume": 0,
                            "weight": 62,
                            "width": 720
                        }
                    ],
                    "h266": []
                },
                "video": {
                    "biz_id": "281780362091135204",
                    "biz_name": 110,
                    "drm_type": 0,
                    "duration": 209,
                    "hdr_type": 0,
                    "md5": "81f96657aaaabf9a4ab2d4df9337868b",
                    "stream_types": [
                        114,
                        259
                    ]
                },
                "video_id": 137665168634322374
            }
        }
    },
    "billing": {
        "service_fee": 0.15,
        "discount_applied": true,
        "balance_before": 781.4896,
        "balance_after": 781.3396,
        "currency": "CNY",
        "transaction_id": 1494936
    }
}

接口信息#

功能说明#

请求参数#

响应参数#

请求示例#

注意事项#

请求参数

请求示例代码

返回响应

接口信息

功能说明

请求参数

响应参数

请求示例

注意事项