popkitpopkitAPI
中EN
Workspace & accounts

Connected accounts

Social accounts connected to this workspace: platform, handle, followers, authorization status (active / expiring / expired), whether popkit can publish for it, and groups. Expired accounts must be re-authorized by a user in the app.

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

Authorization & guardrails

  • Send Authorization: Bearer <credential>; credentials are issued under Settings → Integrations → Long-lived credentials, see Authentication.
  • The credential needs scope accounts: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.

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/accounts" \
  -H "Authorization: Bearer popkit_it_••••••••"
Response
OK
{
  "data": {
    "accounts": [
      {
        "id": "acc_01J8XQ5M9V2R",
        "platform": "x",
        "handle": "@popkit",
        "displayName": "popkit",
        "avatar": "https://…/avatar.jpg",
        "followers": 12480,
        "status": "active",
        "connectedAt": "2026-07-03T02:11:09.000Z",
        "lastSyncedAt": "2026-09-20T01:00:12.000Z",
        "canPublish": true,
        "isManual": false,
        "profileUrl": "https://x.com/popkit",
        "subscriptionType": null,
        "groupIds": [
          "grp_01J8…"
        ]
      },
      {
        "id": "acc_01J8YB7N4T8K",
        "platform": "douyin",
        "handle": "popkit官方",
        "displayName": "popkit官方",
        "avatar": null,
        "followers": 0,
        "status": "active",
        "connectedAt": "2026-09-04T06:30:00.000Z",
        "lastSyncedAt": null,
        "canPublish": false,
        "isManual": true,
        "profileUrl": null,
        "subscriptionType": null,
        "groupIds": []
      }
    ],
    "groups": [
      {
        "id": "grp_01J8…",
        "name": "品牌号",
        "count": 1
      }
    ],
    "byPlatform": {
      "x": 1,
      "douyin": 1
    },
    "deepLink": "https://popkit.loxily.com/accounts"
  },
  "meta": {
    "requestId": "6a1d0c9e-2b7f-4e3a-8c5d-1f0e9b8a7c62"
  }
}
MCP docs