xhs_pgy_get_note_detail_by_note_url
Read-only
Fetches Pugongying commercial metrics (impressions, reads, engagement, creator collaboration rates) for a Xiaohongshu note via URL, short link, or share text. For enrolled creators only.
Instructions
根据笔记链接、短链接或分享文案获取小红书蒲公英单篇笔记商业增强详情，包括曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note_url | Yes | 小红书笔记链接、短链接或分享文案。支持小红书笔记长链接、xhslink.com / xhslink.cn / xhsurl.com / xhsurl.cn 短链接，以及包含上述链接的完整分享文案。 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | 蒲公英笔记标题 | |
| video | Yes | 视频摘要信息；视频笔记返回对象，图文笔记为 null | |
| author | Yes | 作者信息；详情页不返回小红书号 | |
| points | Yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 | |
| content | Yes | 笔记正文 | |
| note_id | Yes | note_id 是小红书笔记 ID。已有完整 note_id 时原样使用；否则可从笔记搜索、笔记详情、评论、标签页笔记列表或用户发帖列表结果复制；不得截断、缩写、脱敏、补全、格式化、重组，也不得只传前缀。 | |
| note_url | Yes | note_url 是可打开笔记内容所需的完整 URL。任何使用该返回链接的场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得修改、截断、脱敏、规范化、重组，也不得用 note_id 重新拼接链接。 | |
| note_type | Yes | 笔记类型；当前公开值固定为 image 或 video | |
| like_count | Yes | 点赞数 | |
| read_count | Yes | 笔记阅读量 | |
| image_items | Yes | 静态图片明细；不包含 Live 图视频摘要，需要 Live 视频时使用普通笔记详情接口 | |
| share_count | Yes | 分享数 | |
| update_time | Yes | 更新时间，秒级 Unix 时间戳 | |
| video_price | Yes | 创作者视频笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作 | |
| publish_time | Yes | 发布时间，秒级 Unix 时间戳 | |
| collect_count | Yes | 收藏数 | |
| comment_count | Yes | 评论数 | |
| picture_price | Yes | 创作者图文笔记合作报价，单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作 | |
| exposure_count | Yes | 笔记曝光量 | |
| cover_image_url | Yes | 统一封面图 |