股吧回帖实时数据查询 API

## 股吧回帖实时数据查询 API 该接口提供股吧（东方财富股吧）用户针对帖子的回帖（评论）数据，涵盖回帖内容、作者、回复时间、点赞数、IP属地等关键信息。数据支持按股吧代码、股票代码、回复时间等条件筛选，适用于舆情深度分析、用户互动研究及市场情绪追踪。 ### 📌 状态 已正式启用。 ### 📥 数据来源 通过 **API 接口** 定时遍历获取股吧帖子的回帖数据。 ### 🔄 更新频率 - **遍历策略**：仅针对 发帖时间在最近 7 天内 的帖子进行回帖数据抓取。 - **遍历周期**：每 12 小时 执行一次全量遍历，获取上述帖子的全部回帖。 - **遍历起点**：每次遍历会从 当前时间往前推 7 天 的时间点开始，依次抓取该时间段内所有帖子的回帖。例如，4月7日12:00 的遍历，会抓取发帖时间在 4月1日12:00 至 4月7日12:00 之间的所有帖子的回帖； 4月7日24:00 的遍历，则抓取发帖时间在 4月1日24:00 至 4月7日24:00 之间的帖子的回帖。 - **更新机制（Upsert）**：每次遍历获取的回帖数据，会按 reply_id 唯一键与数据库中已有记录进行比较：如果该回帖已存在，则更新其内容（如点赞数、回帖内容、修改时间等）；如果该回帖不存在（新回帖），则插入新记录。如果某条回帖在原平台被删除，下次遍历将无法抓取到它，但数据库中已存储的该回帖不会主动删除（保留历史快照）。 - **设计理由**：绝大多数互动（回帖）发生在帖子发布后的一周内，超过 7 天的帖子回帖增量极少，忽略不计以节约资源。Upsert 方式既能同步状态变化（点赞数、内容修改），又能保留已删除回帖的历史痕迹，便于舆情回溯分析。 ### ⭐ 核心特点 - **聚焦时效性**：专注于最近 7 天发布的热帖回帖，覆盖绝大部分互动流量，避免无效历史数据抓取。 - **Upsert 更新**：每次遍历增量更新回帖信息（新增 + 更新），不删除已有数据，保留历史删除记录。 - **字段同步**：回帖的点赞数、内容修改等变化会在下次遍历时同步更新。 ### 🎯 适用场景 - 帖子级互动热度追踪与回帖情绪分析 - 用户行为研究（如认证用户 vs 普通用户） - 地域分布分析（基于回帖 IP 属地） - 突发事件后 7 天内的舆论发酵监测 *** ### 错误码说明 | 错误码 | 返回message | 含义 | | ---- | ---- | ---- | | 0 | success | 成功 | | 40001 | Missing valid token in request | 请求中缺少Token | | 40002 | Invalid token | Token无效 | | 50001 | Too Many Requests: API call frequency limit exceeded | 请求过多：超出 API 调用频率限制 | | 50002 | Unknown error | 未知错误 | ### 注意事项 1. 时间窗口限制：接口仅采集发帖时间在最近 7 天内的帖子的回帖数据。超过 7 天的帖子，无论是否有新回帖，均不再遍历更新。 2. 遍历周期与 Upsert 机制：回帖数据每 12 小时 遍历一次。每次遍历会重新抓取目标帖子下的所有回帖，并与数据库进行 Upsert（存在则更新，不存在则插入）。 3. 回帖与主帖关系：每条回帖均关联其所属的主帖 ID（post_id）。如需获取主帖内容，请调用股吧发帖数据接口。 4. 时间戳说明：reply_time 为原平台记录的回复时间（UTC 格式）。crawler_time 为接口本次遍历抓取该回帖的时间。由于覆盖更新，同一回帖的 crawler_time 会随着每次遍历而更新。 5. 后续扩展：如需获取超过 7 天的旧帖回帖，或有其他要求，请联系数据团队定制方案。 ### 更新历史 | 版本 | 日期 | 变更说明 | | ---- | ---- | ---- | | v1.0.0 | 2026/4/2 | 初始版本发布 |