xhs_pgy_get_creator_metrics_trend
Fetch Xiaohongshu Pugongying creator exposure, read, engagement median, and estimated cost date trends and overview by full user ID to track metrics over time; choose daily or cooperation scope.
Instructions
根据完整 user_id 获取小红书蒲公英创作者曝光、阅读、互动中位数及预估成本的日期趋势和概览。 观察指标随时间变化时使用;中位数按 note_scope 选择日常或合作笔记,固定图文+视频、近30日、全流量,不支持自选日期。合作口径包含进店指标,日常口径的进店字段为 null;输出回显口径,不能混用。 返回指标不是每日新增量或累计总量,不可跨日期求和;可能缺少日期,不补零。 成本估算口径见字段说明,不代表实际成交成本;按图文/视频拆分的成本及商业汇总使用商业概览工具,逐篇表现使用笔记表现工具。 成功直接返回业务字段和 points;成功调用扣减 20 积分,失败不扣费。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | Yes | 小红书用户 ID。已有完整 user_id 时原样使用,否则从用户搜索、用户信息或笔记作者信息获取;不要传昵称、小红书号、主页链接或笔记 ID。 | |
| note_scope | No | 笔记统计口径:日常笔记趋势选 daily(默认,不是按天汇总);合作笔记或进店趋势选 cooperation。输出回显口径,不可混用;成本估算依据见各字段说明 | daily |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | 平台返回的日期序列;中位数按 note_scope 选择日常或合作笔记,固定图文+视频、近30日、全流量,成本口径见各字段说明;可能缺少日期,不补零、不插值;未知时为 null,明确为空时为 [] | |
| points | Yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 | |
| summary | Yes | 平台提供的概览指标及其日期,不是趋势各点之和;缺失时为 null | |
| user_id | Yes | 小红书用户 ID。已有完整 user_id 时原样使用,否则从用户搜索、用户信息或笔记作者信息获取;不要传昵称、小红书号、主页链接或笔记 ID。 | |
| note_scope | Yes | 笔记统计口径:日常笔记趋势选 daily(默认,不是按天汇总);合作笔记或进店趋势选 cooperation。输出回显口径,不可混用;成本估算依据见各字段说明 |