评论互动

评论收件箱

工作区收到的外部评论(不含我方自己的回复),最新的在前,每页 30 条,用 nextCursor 翻页。每条带 canReply:false 表示该账号当前回不了(replyBlock 说明是缺 scope 还是 Facebook 主页缺 MODERATE 任务),别对它调回复端点。

GET/api/v1/comments

comments:read读档限流只读

鉴权与护栏

请求头 Authorization: Bearer <长期凭证>,凭证在设置页「接入外部系统 → 长期凭证」签发,见鉴权与权限。
凭证需带 scope comments:read;签发者在工作区里的角色也要允许该动作。
限流:读档,每分钟 60 次(按凭证计),超出回 429 并带 Retry-After。
幂等:读端点,无需 Idempotency-Key。
只读端点:不写库、不外发。

查询参数

platformenum: x · youtube · instagram · tiktok · facebook · threads · douyin · xiaohongshu · wechat_mp可选

只看某个平台。

accountIdsstring[] (comma-separated or repeated)可选

只看这几个我方账号名下的评论,最多 20 个。

unrepliedOnlyboolean可选

只看未回复的。

cursorstring可选

上一页返回的 nextCursor。

响应

成功返回 HTTP 200,信封为 { data, meta };右侧(窄屏在本页末尾)给出了各状态码的示例。所有错误都是 { error: { code, message, params }, meta },按机器码处理而不是按 message 匹配,码表见错误码。

状态码	可能的错误码
400	`invalid_input`
401	`unauthenticated`
403	`forbidden` / `workspace_not_found`
404	`not_found`
429	`rate_limited`
500	`internal`

示例

请求

curl -X GET "https://popkit.loxily.com/api/v1/comments?unrepliedOnly=true&platform=tiktok" \
  -H "Authorization: Bearer popkit_it_••••••••"

响应

成功

{
  "data": {
    "items": [
      {
        "id": "cmt_01J8ZQ7H2K4W",
        "platform": "tiktok",
        "accountHandle": "@popkit",
        "author": {
          "handle": "@creator_amy",
          "displayName": "Amy"
        },
        "text": "这个功能什么时候支持小红书?",
        "likeCount": 12,
        "commentedAt": "2026-09-20T07:41:20.000Z",
        "repliedAt": null,
        "canReply": true,
        "replyBlock": null,
        "post": {
          "id": "pst_01J8ZK3R7QW6M2",
          "title": "新功能上线",
          "permalink": "https://www.tiktok.com/@popkit/video/73…"
        },
        "deepLink": "https://popkit.loxily.com/engagement?comment=cmt_01J8ZQ7H2K4W"
      }
    ],
    "nextCursor": null,
    "deepLink": "https://popkit.loxily.com/engagement"
  },
  "meta": {
    "requestId": "6a1d0c9e-2b7f-4e3a-8c5d-1f0e9b8a7c75"
  }
}