popkitpopkitAPI
中EN
Comments

Comment inbox

External comments received by the workspace (excluding your own replies), newest first, 30 per page, paged with nextCursor. canReply:false means that account cannot reply right now (replyBlock says whether a scope or the Facebook Page MODERATE task is missing) — do not call the reply endpoint for it.

GET/api/v1/comments
comments:readread tierread-only

Authorization & guardrails

  • Send Authorization: Bearer <credential>; credentials are issued under Settings → Integrations → Long-lived credentials, see Authentication.
  • The credential needs scope comments:read; the issuer's workspace role must also allow the action.
  • Rate limit: read tier, 60/min per credential; over the cap returns 429 with Retry-After.
  • Idempotency: read endpoint, no Idempotency-Key needed.
  • Read-only: writes nothing and sends nothing out.

Query parameters

platformenum: x · youtube · instagram · tiktok · facebook · threads · douyin · xiaohongshu · wechat_mpoptional

One platform only.

accountIdsstring[] (comma-separated or repeated)optional

Only comments under these accounts, max 20.

unrepliedOnlybooleanoptional

Unreplied only.

cursorstringoptional

nextCursor from the previous page.

Responses

Success is HTTP 200 with a { data, meta } envelope; examples per status are on the right (at the end of the page on narrow screens). Every error is { error: { code, message, params }, meta } — branch on the code, not the message; see Errors.

StatusPossible codes
400invalid_input
401unauthenticated
403forbidden / workspace_not_found
404not_found
429rate_limited
500internal

Examples

Request
curl -X GET "https://popkit.loxily.com/api/v1/comments?unrepliedOnly=true&platform=tiktok" \
  -H "Authorization: Bearer popkit_it_••••••••"
Response
OK
{
  "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"
  }
}
MCP docs