xhs_pgy_get_creator_fans_profile
Fetch Xiaohongshu Pugongying creator fan demographics by user ID—age, gender, location, interests, and device brands—to analyze audience makeup.
Instructions
根据完整 user_id 获取小红书蒲公英创作者粉丝画像,包括年龄、性别、地域、城市、兴趣和设备品牌分布及数据日期。 查询粉丝构成时使用;粉丝规模、增长、活跃、阅读和互动情况使用创作者粉丝汇总工具;创作者资料和报价使用创作者档案工具。 使用平台默认统计范围,不支持指定日期;分布不保证完整,不能据此推算粉丝人数或补齐其他类别。 成功返回画像字段和 points;成功调用扣减 20 积分,失败不扣费。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | Yes | 小红书用户 ID。已有完整 user_id 时原样使用,否则从用户搜索、用户信息或笔记作者信息获取;不要传昵称、小红书号、主页链接或笔记 ID。 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| points | Yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 | |
| user_id | Yes | 小红书用户 ID。已有完整 user_id 时原样使用,否则从用户搜索、用户信息或笔记作者信息获取;不要传昵称、小红书号、主页链接或笔记 ID。 | |
| data_date | Yes | 平台标注的数据日期(YYYY-MM-DD),不代表查询时间或统计起止范围;未知时为 null | |
| age_distribution | Yes | 粉丝年龄分布;保留平台年龄区间标签,不推断端点含义;不保证完整,未知时为 null,明确为空时为 [] | |
| city_distribution | Yes | 平台返回的粉丝城市分布;不保证列出全部城市,不重新归一化或补其他;未知时为 null,明确为空时为 [] | |
| device_distribution | Yes | 粉丝设备品牌分布;不保证列出全部品牌,不重新归一化或补其他;未知时为 null,明确为空时为 [] | |
| gender_distribution | Yes | 粉丝性别分布;不推算缺失占比,未知时为 null | |
| region_distribution | Yes | 粉丝地域分布;标签可包含省份、中国、海外等,不统一视为省份;不保证完整,未知时为 null,明确为空时为 [] | |
| interest_distribution | Yes | 粉丝兴趣分布;不保证分类完整或互斥,不用占比之和推算其他兴趣;未知时为 null,明确为空时为 [] |