xhs_get_note_detail_by_note_url
Retrieve detailed information of a single Xiaohongshu note using its URL, short link, or share text.
Instructions
根据笔记链接、短链接或分享文案获取单篇小红书笔记详情。 返回的 note_url 在任何使用场景都必须原样保留完整 URL,包括 xsec_token 等 query 参数;例如最终回答、展示、引用、存储、输出或传递;不得用 note_id 重新拼接链接;note_url 为 null 时不要用 note_id 合成公开链接。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note_url | Yes | 小红书笔记链接、短链接或分享文案。支持以下形式:1) 小红书笔记长链接;2) xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接;3) 包含上述任一链接的完整分享文案。 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | 笔记标题 | |
| video | Yes | 视频摘要信息;无可用视频摘要时为 null | |
| author | Yes | 作者信息;详情页不返回小红书号 | |
| content | Yes | 笔记正文 | |
| note_id | Yes | note_id 是 24 位小写十六进制稳定笔记 ID。必须原样复制搜索、详情、评论或用户发帖列表返回的完整 note_id;不得截断、缩写、脱敏、补全、格式化、重组,也不得只传前缀。 | |
| note_url | Yes | note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL,包括 xsec_token 等 query 参数;例如最终回答、展示、引用、存储、输出或传递;不得修改、截断、脱敏、规范化、重组,也不得用 note_id 重新拼接链接。无法提供可用链接时为 null;note_url 为 null 时不要用 note_id 合成公开链接。 | |
| note_type | Yes | 笔记类型;当前公开值固定为 image 或 video | |
| like_count | Yes | 点赞数 | |
| topic_tags | Yes | 笔记详情中的话题标签;无话题时为空数组 | |
| image_items | Yes | 图片结构化明细;每项都表示一张图片,Live 图会在对应项携带 live_photo 摘要 | |
| ip_location | Yes | 笔记发布时的 IP 属地;没有 IP 属地时为空字符串 | |
| share_count | Yes | 分享数 | |
| update_time | Yes | 更新时间,秒级 Unix 时间戳;没有有效更新时间时为 null | |
| publish_time | Yes | 发布时间,秒级 Unix 时间戳 | |
| collect_count | Yes | 收藏数 | |
| comment_count | Yes | 评论数 | |
| cover_image_url | Yes | 统一封面图 | |
| mentioned_users | Yes | 笔记正文中 @ 到的用户列表;无 @ 时为空数组 |