rednote/
search-users

通过一个文本查询搜索公开 Rednote 账号,并从 provider 的固定单页结果中返回标准化身份、简介、账号标记和可见受众指标记录。

Rednote Search Users API

文本查询
单个来源页
标准化账号
每次请求 1 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Rednote Search Users

公开 Rednote 账号搜索可以针对一个文本查询返回匹配用户的身份、简介、账号状态和可见受众或内容数量。标准化账号记录会保留来源中实际可用的字段,并附带 collected_at,便于追溯发现结果和开展对比。

Rednote Search Users API 主要特性

  • 单查询账号发现提交一个非空 query,将其映射为 provider 固定第一页的 keyword,不提供来源页控制或额外筛选。
  • 标准化公开身份用固定账号结构返回可用的 ID、用户名、显示名称、简介、公开 URL、头像、封面、网站、认证和隐私字段。
  • 可见账号快照将可用的粉丝数、关注数和帖子数与 collected_at 一起保留,使每个返回值都对应明确的观察时间。

Rednote Search Users API 参数

参数必填描述
query必填必填且非空的字符串,会映射为 provider keyword。此 endpoint 不提供枚举、results_limit、provider cursor、排序或媒体筛选字段。

如何使用 Rednote Search Users API

提交一个账号搜索词,跟踪异步任务,并读取已存储的标准化账号记录。

  1. 选择一个非空词语,用于表示需要发现的公开账号、创作者名称、品牌或主题。
  2. 将 query 发送到 /v1/rednote/search-users,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或报告失败。
  4. 读取 data.results.items;如果存储结果响应的 has_more 为 true,则继续使用其 next_cursor。
curl -X POST "https://api.socq.ai/v1/rednote/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"摄影"}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items;next_cursor 只用于已存储结果分页

Rednote Search Users API 最佳使用场景

  • 建立创作者候选清单: 通过名称或主题词发现公开账号,再根据可用的身份和简介字段筛选候选对象。
  • 补全账号目录: 为发现清单补充标准化 ID、用户名、显示名称、简介、图片、URL、网站和账号标记。
  • 比较公开账号信号: 将可用粉丝数、关注数和帖子数作为采集时点快照使用,而不把它们理解为私有分析或实时总数。

Rednote Search Users API 使用建议

  • 只提交 query;此 endpoint 会拒绝 results_limit、cursor、page、sort、filter、media_type 和其他额外字段。
  • 将 provider 调用理解为固定第一页;共享任务结果中的 next_cursor 用于已存储 SocQ 记录分页,不会继续读取 Rednote 来源页。
  • 当公开响应缺少字段时,应允许 ID、用户名、名称、简介、图片、网站、账号标记和单项指标为空。
  • 将 collected_at 与可见计数一起保存,并为每个成功任务预留固定 1.00 SocQ 积分;费用不随账号结果数变化。

探索其他平台

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

Rednote Search Users API — 常见问题

Rednote Search Users API 是一个通过单个文本查询发现公开 Rednote 账号的接口,返回标准化账号记录。

它只接受一个必填且非空的 query 字符串,不提供枚举、results_limit、provider cursor、排序或筛选字段。

不可以。provider 输入固定为 page 1;共享任务结果中的 next_cursor 和 has_more 只描述已存储 SocQ 记录的分页。

账号 schema 可以在来源可用时包含身份、用户名、显示名称、简介、公开 URL、头像、封面、网站、认证和隐私标记、位置、可见粉丝数、关注数和帖子数,以及采集上下文。

每个成功任务固定消耗 1.00 SocQ 积分,不受结果数或可选字段可用性影响。