Rednote Note Detail
Rednote 笔记是将正文和媒体与作者身份、话题引用、发布时间及可见互动联系起来的公开内容对象。这些字段适合补全已知链接、审核选定内容，并比较不同观察时点的笔记表现。
主要特性
- 带 token 的笔记查询仅在已接受主机名、笔记详情路径和非空 xsec_token 共同构成完整来源标识时，解析一个已知公开笔记 URL。
- 笔记与作者信息返回标准化笔记标识、来源 URL、正文、时间，以及可获得的作者 ID、username、显示名称、主页、头像和账号标记。
- 媒体与互动快照保留可获得的媒体地址、预览图、尺寸、时长、话题引用，以及点赞、评论、分享和观看数量，并标明采集时间。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 必填的非空 URL，主机名必须为 xiaohongshu.com、xhslink.com 或其子域；路径必须包含 /explore/{note_id} 或 /discovery/item/{note_id}，查询参数必须含非空 xsec_token。 |
如何使用
提供当前可用且带 token 的笔记 URL，提交异步请求，并在完成后读取单条标准化帖子记录。
- 复制当前公开笔记 URL，确认主机名、笔记详情路径和查询字符串中的非空 xsec_token 均符合要求。
- 将 url POST 到 /v1/rednote/note-detail，并保存提交响应中的 data.task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或报告失败。
- 成功后读取 data.results.items。来源只执行一次详情查询；next_cursor 只对 SocQ 已存储记录分页。
REDNOTE_NOTE_URL=''
# 在引号内粘贴当前带 xsec_token 的公开笔记 URL
curl -X POST "https://api.socq.ai/v1/rednote/note-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\"}"
# 轮询 GET /v1/tasks/{task_id}
# 从 data.results.items 读取标准化帖子最佳使用场景
- 补全已知笔记目录： 将符合要求的笔记 URL 转换为标准化身份、正文、作者、发布时间和来源字段，补充已有内容索引。
- 审核选定笔记内容： 结合正文、作者信息、媒体引用和话题字段，检查一组范围明确的单条公开笔记。
- 比较互动观察值： 在多次独立查询中，将可见的点赞、评论、分享和观看数量与 collected_at 配对，进行分时点比较。
使用建议
- 使用完整笔记 URL，并保留主机名、/explore/ 或 /discovery/item/ 路径以及 xsec_token 查询参数；裸 note ID 无法通过校验。
- 将 xsec_token 保留在 URL 查询字符串中，因为请求只接受 url，单独提交 token 字段会被拒绝。
- 复用其它 SocQ Rednote 笔记结果中的 URL 时，先确认 xsec_token 仍然存在；Note Detail 无法重建缺失的 token。
- 每个任务只提交一个 URL；这个详情接口不提供批量字段、results_limit 或来源 cursor 输入。
- 仅把 next_cursor 用于已存储结果分页；来源只执行一次详情查询，通常最多生成一条记录。
- 存储时允许作者、媒体、话题、时间和互动字段为空，并将可见计数与 collected_at 配对，避免把缺失值误判为零。