rednote/
home-recommendations

无需提供种子查询即可采集一页公开 Rednote 首页推荐,并读取标准化帖子、作者、媒体、互动指标与采集时间字段。

Rednote Home Recommendations API

无需种子输入
单页推荐流
标准化帖子
每次请求 1 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Rednote Home Recommendations

首页推荐请求无需主页、笔记 URL 或搜索词,即可获取一页公开 Rednote 推荐内容。每个可用结果会整理为标准帖子记录,包含来源身份、正文、作者、媒体、可见互动、发布时间和采集时间。

Rednote Home Recommendations API 主要特性

  • 无种子推荐请求提交空请求体或经过验证的 homefeed_recommend 类别,即可请求当前推荐页,无需虚构用户或查询条件。
  • 明确的单页上限results_limit 接受 1 到 40 的整数;省略时使用 20,公开来源实际返回数量可能更少。
  • 与 provider 解耦的帖子结构通过共享 post schema 读取可用的笔记身份、正文、作者、媒体、时间和可见指标,不依赖第三方字段名。
  • 异步存储结果提交一次任务并跟踪状态,在单次 provider 响应完成标准化后,分页读取 SocQ 已存储记录。

Rednote Home Recommendations API 参数

参数必填描述
category可选可选的非空字符串。省略时 provider mapping 会注入 homefeed_recommend;这是此处唯一记录的 backend 默认类别,不把其他字符串描述为已验证类别。
media_type可选可选枚举:all、image 或 video。当前 mapping 仅在 image 时启用 provider 图片标记;all 与 video 都映射为 false,因此 video 不保证只返回视频。
results_limit可选可选的 1 到 40 正整数,默认值为 20;它会设置 provider 单页请求数量,并在明确提交时限制存储行数。

如何使用 Rednote Home Recommendations API

只选择 backend 已验证的可选值,提交异步请求,然后读取已存储的标准结果。

  1. 使用 backend 默认值开始,或明确设置 category、media_type 和 results_limit。
  2. 将 JSON 请求体 POST 到 /v1/rednote/home-recommendations,并保存提交响应中的 data.task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或报告失败。
  4. 读取 data.results.items;只有 has_more 表示存在更多 SocQ 已存储记录时才继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/rednote/home-recommendations" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"homefeed_recommend","media_type":"all","results_limit":20}'

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

Rednote Home Recommendations API 最佳使用场景

  • 推荐页快照: 采集一页有明确上限的公开首页推荐,并用 collected_at 将每条记录关联到本次观察。
  • 编辑发现队列: 将标准化正文、作者和媒体引用送入人工审阅、分类或选题流程。
  • 可见内容审计: 在多次独立提交的推荐任务之间,比较可用媒体组合和公开互动字段。

Rednote Home Recommendations API 使用建议

  • 希望完全使用 provider 默认值时可以提交 {};公开请求校验器不要求任何字段。
  • 除非已经独立验证其他 provider 类别,否则保留 homefeed_recommend;runtime 接受非空字符串,但没有发布 category 枚举。
  • 谨慎使用 media_type=video,因为它当前与 all 映射为同一个 provider 标记;只有 image 会改变该标记。
  • results_limit 应在 1 到 40 之间,也不要假设公开来源一定返回请求的条数。
  • 不要发送 provider cursor:上游执行器只请求一次,并从同一响应的 items、notes 或 feeds 中读取结果。
  • 任务成功后,next_cursor 只用于继续读取 SocQ 已存储结果,不会再请求一页 Rednote 推荐。
  • 每个任务按固定 1.00 SocQ 积分规划预算,费用不随 limit 或实际结果数量变化。

除了 Rednote Home Recommendations API,需要其他类型的 Rednote 公开数据时,可以使用以下 API。

探索其他平台

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

Rednote Home Recommendations API — 常见问题

Rednote Home Recommendations API 是一个采集一页公开 Rednote 首页推荐的接口,返回标准化帖子记录。

不需要。三个受支持字段均为可选,空 JSON 请求体会使用 provider 的 homefeed_recommend 类别和 20 条请求数量。

公开校验器接受非空 category 字符串,但 backend 只将 homefeed_recommend 定义为稳定默认值;此页面不会根据外部 research 扩展类别。

校验器接受 video,但当前 provider 变换会把 video 与 all 映射为同一个 false 标记;只有 image 会改变标记,因此不保证只返回视频。

不会。provider 只请求一页;next_cursor 属于共享的 SocQ 任务结果读取接口,仅对已完成任务中已经存储的记录分页。

不可以。它不接受登录状态或用户身份,也不提供账号操作、内容发布或审核控制。

每个任务固定消耗 1.00 SocQ 积分,不受 results_limit 或实际返回记录数量影响。