Rednote Search Users
公开 Rednote 账号搜索可以针对一个文本查询返回匹配用户的身份、简介、账号状态和可见受众或内容数量。标准化账号记录会保留来源中实际可用的字段，并附带 collected_at，便于追溯发现结果和开展对比。
主要特性
- 单查询账号发现提交一个非空 query，将其映射为 provider 固定第一页的 keyword，不提供来源页控制或额外筛选。
- 标准化公开身份用固定账号结构返回可用的 ID、用户名、显示名称、简介、公开 URL、头像、封面、网站、认证和隐私字段。
- 可见账号快照将可用的粉丝数、关注数和帖子数与 collected_at 一起保留，使每个返回值都对应明确的观察时间。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
query | 必填 | 必填且非空的字符串，会映射为 provider keyword。此 endpoint 不提供枚举、results_limit、provider cursor、排序或媒体筛选字段。 |
如何使用
提交一个账号搜索词，跟踪异步任务，并读取已存储的标准化账号记录。
- 选择一个非空词语，用于表示需要发现的公开账号、创作者名称、品牌或主题。
- 将 query 发送到 /v1/rednote/search-users，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或报告失败。
- 读取 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 只用于已存储结果分页最佳使用场景
- 建立创作者候选清单： 通过名称或主题词发现公开账号，再根据可用的身份和简介字段筛选候选对象。
- 补全账号目录： 为发现清单补充标准化 ID、用户名、显示名称、简介、图片、URL、网站和账号标记。
- 比较公开账号信号： 将可用粉丝数、关注数和帖子数作为采集时点快照使用，而不把它们理解为私有分析或实时总数。
使用建议
- 只提交 query；此 endpoint 会拒绝 results_limit、cursor、page、sort、filter、media_type 和其他额外字段。
- 将 provider 调用理解为固定第一页；共享任务结果中的 next_cursor 用于已存储 SocQ 记录分页，不会继续读取 Rednote 来源页。
- 当公开响应缺少字段时，应允许 ID、用户名、名称、简介、图片、网站、账号标记和单项指标为空。
- 将 collected_at 与可见计数一起保存，并为每个成功任务预留固定 1.00 SocQ 积分；费用不随账号结果数变化。