Rednote User Profile
公开 Rednote 主页可能提供账号标识、Rednote 号、显示名称、简介、主页图片、网站、账号标记以及可见粉丝数、关注数和帖子数。标准化记录会将可用的身份字段和时间点信号保存在一起，用于账号匹配、选定主页比较和重复快照分析。
主要特性
- 两种查询路径与明确优先级可通过受支持的 Rednote URL 或公开 user_id 解析一个主页；同时提供两者时，来源查询使用显式 user_id。
- 一致的公开身份记录标准化可用的账号 ID、来源 URL、Rednote 号、显示名称、简介、头像、封面图、网站、认证标记和隐私标记。
- 带采集时间的可见账号信号将可用的粉丝数、关注数和帖子数与 collected_at 一同返回，使每条结果保持为时间点观察值，而非实时总数。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填（至少一项） | url 与 user_id 至少填写一个。解析后的 hostname 必须为 xiaohongshu.com、xhslink.com 或两者的子域名；同时填写 user_id 时，user_id 优先。 |
user_id | 必填（至少一项） | user_id 与 url 至少填写一个。可使用 1 至 256 个 ASCII 字母、数字、冒号、下划线或连字符；同时填写 url 时，这个显式标识优先。 |
如何使用
提交一种受支持的账号标识，跟踪异步任务，再从已存储结果页读取标准化账号。
- 准备当前公开 user_id，或解析后 hostname 为 xiaohongshu.com、xhslink.com 或两者子域名的 URL。
- 向 /v1/rednote/user-profile 提交 user_id、url 或两者；同时提供时 user_id 优先。保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或报告失败。
- 从 data.results.items 读取账号；只有已存储结果读取器返回 has_more 为 true 时才使用 next_cursor。
REDNOTE_USER_ID=''
# 运行前粘贴当前公开的 Rednote 账号标识。
curl -X POST "https://api.socq.ai/v1/rednote/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"user_id\":\"$REDNOTE_USER_ID\"}"
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；仅在 has_more 为 true 时继续使用 next_cursor最佳使用场景
- 已知账号记录补全： 将已有公开 Rednote 账号标识转换为一致的身份记录，补充可用主页文本、图片、网站和账号标记。
- 主页快照比较： 使用稳定结果 ID、collected_at 以及采集时可用的粉丝数、关注数和帖子数，比较选定账号或多次采集结果。
使用建议
- 至少提供一个输入。同时填写 url 和 user_id 时，backend 使用显式 user_id，不会把 URL 发送给来源查询。
- 已知公开账号标识时优先使用 user_id，避免依赖分享链接或账号 URL 的路径结构。
- 提交前用 ^[A-Za-z0-9:_-]{1,256}$ 校验 user_id，并要求 URL 解析后的 hostname 匹配 xiaohongshu.com、xhslink.com 或其子域名。
- 不要添加 results_limit 或来源 cursor。该 endpoint 只发起一次详情请求，next_cursor 仅属于 SocQ 已存储结果读取器。
- 允许简介、主页图片、网站、账号标记和每项指标为空；保留 null，不要把缺失字段转换为空字符串或零。
- 已有 Rednote 账号结果中的规范化 id 可作为 user_id 复用。它与返回的 username 不同，后者代表来源提供的 Rednote 号。