rednote/
user-profile

通过受支持的账号 URL 或 user_id 获取一个公开 Rednote 主页,返回标准化身份、主页图片、账号标记、可见计数和采集时间。

Rednote User Profile API

URL 或 user_id
单条标准化账号
每任务固定 1 credit
每次请求 1 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Rednote User Profile

公开 Rednote 主页可能提供账号标识、Rednote 号、显示名称、简介、主页图片、网站、账号标记以及可见粉丝数、关注数和帖子数。标准化记录会将可用的身份字段和时间点信号保存在一起,用于账号匹配、选定主页比较和重复快照分析。

Rednote User Profile API 主要特性

  • 两种查询路径与明确优先级可通过受支持的 Rednote URL 或公开 user_id 解析一个主页;同时提供两者时,来源查询使用显式 user_id。
  • 一致的公开身份记录标准化可用的账号 ID、来源 URL、Rednote 号、显示名称、简介、头像、封面图、网站、认证标记和隐私标记。
  • 带采集时间的可见账号信号将可用的粉丝数、关注数和帖子数与 collected_at 一同返回,使每条结果保持为时间点观察值,而非实时总数。

Rednote User Profile API 参数

参数必填描述
url必填(至少一项)url 与 user_id 至少填写一个。解析后的 hostname 必须为 xiaohongshu.com、xhslink.com 或两者的子域名;同时填写 user_id 时,user_id 优先。
user_id必填(至少一项)user_id 与 url 至少填写一个。可使用 1 至 256 个 ASCII 字母、数字、冒号、下划线或连字符;同时填写 url 时,这个显式标识优先。

如何使用 Rednote User Profile API

提交一种受支持的账号标识,跟踪异步任务,再从已存储结果页读取标准化账号。

  1. 准备当前公开 user_id,或解析后 hostname 为 xiaohongshu.com、xhslink.com 或两者子域名的 URL。
  2. 向 /v1/rednote/user-profile 提交 user_id、url 或两者;同时提供时 user_id 优先。保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或报告失败。
  4. 从 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 User Profile API 最佳使用场景

  • 已知账号记录补全: 将已有公开 Rednote 账号标识转换为一致的身份记录,补充可用主页文本、图片、网站和账号标记。
  • 主页快照比较: 使用稳定结果 ID、collected_at 以及采集时可用的粉丝数、关注数和帖子数,比较选定账号或多次采集结果。

Rednote User Profile API 使用建议

  • 至少提供一个输入。同时填写 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 号。

探索其他平台

还可以将 Rednote 数据与其他已支持社交平台的公开数据结合使用。

Rednote User Profile API — 常见问题

Rednote User Profile API 是一个通过受支持账号 URL 或 user_id 获取至多一个公开 Rednote 主页的接口,返回标准化账号记录。

已知 user_id 时优先使用它。可以同时提交两个字段,但显式 user_id 优先,URL 不会被转发到来源查询。

URL 必须解析到 xiaohongshu.com、xhslink.com 或其子域名。user_id 必须由 1 至 256 个 ASCII 字母、数字、冒号、下划线或连字符组成。

结果可包含 ID、来源 URL、Rednote 号、显示名称、简介、头像、封面图、网站、认证与隐私标记、粉丝数、关注数、帖子数和采集时间;单项字段可能为 null。

不是。user_id 是可接受的查询标识,规范化结果另有自己的 id;username 保存来源提供的 Rednote 号,调用方不应在未核实来源值时直接用它代替 user_id。

不会。每个任务只发起一次主页详情请求,最多存储一个账号;通用任务结果仍会为读取 SocQ 已存储记录提供 items、next_cursor 和 has_more。

每个成功的 Rednote User Profile 任务固定消耗 1.00 个 SocQ credit,不按字段数或已存储结果数计价。