Rednote 公开数据 API
获取公开账号和笔记，搜索笔记或用户，采集评论与嵌套回复，并记录一页首页推荐。
可用的 Rednote API
八个 API 覆盖账号、笔记、评论、回复、搜索和推荐场景。
可以获取哪些 Rednote 数据？
Rednote API 返回来自公开来源的标准化账号、帖子和评论记录。
账号与用户笔记
通过受支持的账号 URL 或 user_id 获取一个公开账号，或采集一页用户笔记。
笔记详情与发现
查询一个带 token 的笔记 URL，使用受支持筛选条件搜索笔记，或采集一页首页推荐。
用户搜索
通过一个非空 query 搜索固定来源第一页的公开账号。
评论与回复
采集一页笔记公开评论，或通过已知 comment_id 采集一页嵌套回复。
Rednote API 契约概览
每个接口都只执行有边界的来源请求，并拒绝未声明参数。
| API 分组 | 起始输入 | 来源边界 |
|---|---|---|
| 账号与用户笔记 | url 或 user_id | 一个账号或一个来源页，不接受 results_limit |
| 笔记详情 | 包含笔记路径与 xsec_token 的受支持 URL | 最多一条笔记记录 |
| 搜索 | 非空 query 和受支持的选填枚举 | 固定来源第一页，不接受 results_limit |
| 评论与回复 | 受支持笔记 URL；回复还需要 comment_id | 一个来源响应页 |
| 首页推荐 | 所有字段均可选 | 一页结果，results_limit 为 1–40，默认 20 |
Rednote API 如何工作
八个接口都使用异步提交、轮询和读取已存储结果的流程。
1. 选择接口
根据公开数据任务选择账号、笔记、搜索、评论、回复或推荐接口。
2. 提交有效参数
只 POST 已声明字段，并保存返回的 task_id。
3. 读取标准化结果
轮询任务至终态，再读取 data.results.items；next_cursor 只用于已存储结果分页。
使用 SocQ API key 鉴权，并提交 query 与受支持的选填筛选条件。每个成功的 Rednote 任务固定消耗 1 积分。
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"旅行攻略","sort_by":"general","media_type":"all"}'
# 轮询 GET /v1/tasks/{task_id}
# 成功后读取 data.results.items常见 Rednote API 使用场景
创作者与内容研究
把公开账号身份与一页用户笔记结合起来。
主题发现
通过采集时间对比笔记搜索、用户搜索和首页推荐快照。
讨论分析
把一条公开笔记的评论和指定评论的嵌套回复读取为标准化记录。
限制与公开数据政策
这些接口通过有边界的来源请求读取公开数据，不提供账号操作或私有访问。
- 受支持 URL 主机为 xiaohongshu.com、xhslink.com 及其子域；Note Detail 还要求 /explore/{id} 或 /discovery/item/{id} 路径以及非空 xsec_token。
- user_id 和 comment_id 接受 1–256 个 ASCII 字母、数字、冒号、下划线或连字符。
- Search Notes 的 sort_by、media_type 和 published_within 只能使用列出的枚举值；Search Users 只接受 query。
- 只有 Home Recommendations 接受 results_limit，范围为 1–40，默认值为 20。
- 每个成功的 Rednote 任务固定消耗 1 积分。
Rednote API 常见问题
Rednote API 是什么？
Rednote API 是一组获取公开账号、笔记、评论、嵌套回复、搜索结果和首页推荐并返回标准化记录的接口。
哪个接口接受 results_limit？
只有 Home Recommendations 接受 1–40 的整数 results_limit；其他 Rednote 接口会拒绝该字段。
Note Detail 接受任意 Rednote URL 吗？
不接受。URL 必须使用受支持主机，路径包含 /explore/{id} 或 /discovery/item/{id}，并带有非空 xsec_token。
Rednote 请求如何计费？
每个成功任务固定消耗 1 SocQ 积分。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Pinterest API
获取公开 Pinterest 账号数据、解析指定 Pin、采集选定账号的 Pin，或按关键词搜索，用于创作者、内容和视觉趋势研究。
Threads API
获取公开 Threads 账号、解析指定帖子，或采集选定账号的帖子，并返回标准化身份、内容、媒体、互动和时间字段。
Bluesky API
获取公开 Bluesky 账号、解析指定帖子 URL，或采集一页账号帖子，并返回标准化身份、内容、媒体、时间和可见互动字段。
Snapchat API
将一个已知公开 Snapchat Spotlight 获取为标准化记录，并返回可用的创作者、说明文字、媒体、音频、时间、时长和互动字段。
Twitch API
将一个已知公开 Twitch username 解析为标准化主页记录，或采集其公开视频清单，用于创作者研究、目录补全、比较和快照监测。
Apple App Store API
通过已知商店链接采集公开 Apple App Store 应用详情、分类榜单和评价，并返回标准化应用与评价记录。