xhs_pgy_get_creator_notes_performance
Retrieve Xiaohongshu Pgy creator note performance metrics for daily or cooperation notes over the last 30 days, including note count, medians, rates, and tags.
Instructions
根据完整 user_id 获取小红书蒲公英创作者笔记表现,包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和笔记明细。 查询日常或合作笔记表现及最近明细时使用;商业汇总与成本参考使用商业概览工具,资料和报价使用创作者档案工具。 视频完播相关字段仅在 video_note_count 大于 0 时用于表现判断;图文 3 秒阅读率仅在统计范围内有图文笔记时用于表现判断;其他情况下 0 值不表示对应表现为 0%。 固定近30日、图文+视频、全流量,不支持自选日期或笔记类型;明细最多 15 篇,不是全量列表。仅 notes[] 内的 *_benchmark_rate 是相较于平台中位数的相对差异,允许负数和超过 1,不能当作排名比例;汇总层同名字段仍是平台返回的 0 到 1 对比值,计算方式未公开,不能混用。 成功返回表现字段和 points;成功调用扣减 20 积分,失败不扣费。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | Yes | 小红书用户 ID。已有完整 user_id 时原样使用,否则从用户搜索、用户信息或笔记作者信息获取;不要传昵称、小红书号、主页链接或笔记 ID。 | |
| note_scope | No | 笔记统计口径:日常笔记选 daily(默认,不是按天汇总);商单或品牌合作笔记选 cooperation。固定近30日、图文+视频、全流量;输出回显口径 | daily |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | Yes | 统计范围内最近发布的最多 15 篇笔记表现明细,不是全量列表;未知时为 null,明确为空时为 [] | |
| points | Yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 | |
| user_id | Yes | 小红书用户 ID。已有完整 user_id 时原样使用,否则从用户搜索、用户信息或笔记作者信息获取;不要传昵称、小红书号、主页链接或笔记 ID。 | |
| note_count | Yes | 统计范围内笔记数;未知时为 null | |
| note_scope | Yes | 笔记统计口径:日常笔记选 daily(默认,不是按天汇总);商单或品牌合作笔记选 cooperation。固定近30日、图文+视频、全流量;输出回显口径 | |
| like_median | Yes | 笔记点赞量中位数;未知时为 null | |
| read_median | Yes | 笔记阅读量中位数;未知时为 null | |
| content_tags | Yes | 笔记内容标签分布;返回标签不保证覆盖全部内容,占比之和不保证为 1;不要自行归一化或补齐其他类别;未知时为 null,明确为空时为 [] | |
| share_median | Yes | 笔记分享量中位数;未知时为 null | |
| collect_median | Yes | 笔记收藏量中位数;未知时为 null | |
| comment_median | Yes | 笔记评论量中位数;未知时为 null | |
| interaction_rate | Yes | 平台返回的笔记互动率,0.195 表示 19.5%;本响应未提供可确认的计算分母和完整统计口径,不可用返回计数自行复算;未知时为 null | |
| video_note_count | Yes | 统计范围内视频笔记数;未知时为 null | |
| impression_median | Yes | 笔记曝光量中位数;未知时为 null | |
| hundred_like_ratio | Yes | 获赞不少于 100 的笔记占比,0.1 表示 10%;未知时为 null | |
| image_3s_view_rate | Yes | 图文笔记 3 秒阅读率,0.195 表示 19.5%;仅在统计范围内有图文笔记时用于表现判断;否则 0 值不表示 3 秒阅读率为 0%;未知时为 null | |
| interaction_median | Yes | 平台汇总口径的笔记互动量中位数;不保证与 notes[].interaction_count 的统计口径一致,不可直接用返回的笔记明细复算;未知时为 null | |
| read_benchmark_rate | Yes | 平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null | |
| thousand_like_ratio | Yes | 获赞不少于 1000 的笔记占比,0.1 表示 10%;未知时为 null | |
| video_full_view_rate | Yes | 视频完播率,0.195 表示 19.5%;仅在 video_note_count 大于 0 时用于表现判断;否则 0 值不表示完播率为 0%;未知时为 null | |
| impression_benchmark_rate | Yes | 平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null | |
| interaction_benchmark_rate | Yes | 平台返回的指标对比值,范围 0~1;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null | |
| video_full_view_benchmark_rate | Yes | 平台返回的视频完播指标对比值,范围 0~1;仅在 video_note_count 大于 0 时用于表现判断;否则 0 值不表示表现为 0;比较对象和计算方式未公开,不得视为固定阈值、行业排名或百分位;未知时为 null |