Skip to main content
GET
使用评论 API,通过 Ayrshare 帖子 ID、社交帖子 ID、Ayrshare 评论 ID 或社交评论 ID 获取帖子的评论。 有关不同 ID 类型的更多信息,请参见评论概述。
如果使用 Ayrshare 帖子 ID,则不需要任何查询参数。

更多评论详情

  • 除 X 外,所有平台的评论数据每 10 分钟更新一次。由于 X API 的限制,X 的评论数据采用指数退避策略进行刷新,也就是说更新间隔会随时间逐渐变长。
  • 在 X 上,如果请求评论的帖子本身是一条回复,将返回该帖子的回复。自身开启一段对话的 X 帖子保持不变,仍会返回整个对话中的回复。
  • 在 Facebook 响应中,对回复的回复始终具有相同的 parent.id。
  • 要获取 LinkedIn 对评论的回复,请将查询参数 "commentId": true 和 "searchPlatformId": true 设置为真,并在路径参数中提供社交评论 ID。
  • Facebook 和 Instagram 最多返回一条帖子最近的 1,000 条评论。如需在 Enterprise 套餐上获得更高上限,请联系我们。
  • 对于仍在处理中的 TikTok 帖子(其 id 为 "pending"),get-comments 会返回一个明确的”仍在处理”错误(code: 288,HTTP 400),而不是一个通用失败。请在 tikTokPublished webhook 触发后或 /history 显示已解析的视频 id 后重试。

多平台读取与部分成功

当你使用 Ayrshare Post ID 请求评论时,该帖子可能跨越多个平台。Ayrshare 会为每个平台分派一个请求(“leg”,即分支),当部分分支成功、部分分支失败时,返回部分成功——健康平台的评论数据始终会被返回,每个失败的分支都会在顶层的 errors[] 数组中被枚举。
  • 部分平台成功,部分平台失败:响应为 HTTP 200,并附带 status: “partial”。健康的各平台数据块会像往常一样返回,同时顶层的 errors[] 数组会列出每个失败的分支,包含其 platform、status、code、message 和 id。
  • 所有平台均失败:响应 status: “error”,并包含完整的 errors[] 数组。HTTP 状态码从代表性的顶层错误码映射而来。错误码 485 映射到 HTTP 404;其他代表性错误码使用各自的映射关系。
  • 所有平台均成功:响应保持不变——HTTP 200、status: “success”,且不包含 errors[] 键。
**行为变更——请检查 errors[],不要基于 HTTP 状态码分支处理。**由于当某个分支失败时,多平台读取现在会返回 HTTP 200 而不是将整个响应折叠为错误,集成方应始终检查顶层 errors[] 数组是否存在,以此判断各平台是否有失败,而不是仅仅依赖 HTTP 状态码。

过期或不可用的 Instagram / Facebook Story 评论

当一个 Instagram 或 Facebook Story 评论分支已过期或不可用——因此其评论无法被获取时——它会以错误码 485 出现在 errors[] 中。一个具有代表性的 Instagram 消息是 “Instagram Story expired or unavailable — comments/insights cannot be retrieved.”。如果另一个平台成功,其评论仍会返回,整体响应为 HTTP 200。对于全部失败的响应,代表性错误码 485 映射到 HTTP 404;其他代表性错误码使用各自的映射关系。请匹配 code(485),而不是精确的消息文本。

示例:部分成功响应

200: 部分成功

X 计费与速率限制失败

X 的评论读取可能因你自己的 X 开发者账号而失败,最常见的原因是账号已没有剩余 API 额度,或者你触发了 X 的速率限制。这些失败会返回带类型的错误,而不是空的评论列表,因此账号问题永远不会被误认为帖子没有评论。
  • X 返回 HTTP 402(没有 API 额度):Ayrshare 返回 code: 416,HTTP 状态为 402。
  • X 返回 HTTP 429(速率限制):Ayrshare 返回 code: 364,HTTP 状态为 429。如果 X 的 429 表明账号额度已耗尽,Ayrshare 会改为返回 code: 416,因为等待并不能解决该问题。
  • 授权失败返回 code: 272,其他任何 X 失败返回 code: 219,两者的 HTTP 状态均为 400。
在多平台读取中,响应的顶层为 status: “partial”,失败的 X 分支会以 status: “error” 出现在 errors[] 中,与上文所述完全一致;单平台读取则在顶层返回错误。当 X 直接拒绝请求时,该失败不会被缓存,因此你再次请求评论时会立即重新读取。 已被删除的 X 帖子,或你的 X 凭证无法查看的 X 帖子,仍会返回空数组且不带错误。

请求头参数

路径参数

查询参数

boolean
默认值:false
如果要获取通过 Ayrshare 发布的帖子的评论并使用 Ayrshare 帖子 ID,请不要包含此字段——它默认为 false。如果要使用社交帖子 ID 或社交评论 ID(由社交网络生成的 ID)来获取评论,请将其设置为 true。
boolean
默认值:false
如果要使用社交评论 ID(由社交网络生成的评论 ID)来获取评论,请设置为 true。如果使用 Ayrshare 帖子 ID 或社交帖子 ID 获取评论,请不要包含此字段——它默认为 false。
如果使用 commentId 查询参数,还必须将 searchPlatformId 设置为 true。
string
当 searchPlatformId 或 commentId 为 true 时必填。何时使用:
  • 使用社交帖子 ID 与 "searchPlatformId": true 字段时。支持的平台:bluesky、facebook、instagram、linkedin、threads、tiktok、twitter、youtube。
  • 使用社交评论 ID 与 "searchPlatformId": true 及 "commentId": true 字段时。支持的平台:facebook、instagram、linkedin。
  • 使用 Ayrshare 帖子 ID 时,不要包含此字段——评论将从原始帖子发布到的所有平台返回。

评论 GET 请求示例