MultiPost Docs

Accounts

List/get accounts, refresh login status

All endpoints require a Bearer Token. Base URL is http://127.0.0.1:19528.

List accounts#

GET /v1/accounts

Optional query params:

ParamDescription
platformFilter by platform, e.g. weibo, xiaohongshu
groupIdFilter by account group
curl 'http://127.0.0.1:19528/v1/accounts?platform=weibo' \
  -H "Authorization: Bearer $MULTIPOST_DESKTOP_TOKEN"

200

{
  "accounts": [
    {
      "id": "a1b2c3d4",
      "platform": "weibo",
      "username": "weibo_user",
      "displayName": "My Weibo",
      "remark": "Main",
      "avatar": "https://…",
      "isLoggedIn": true,
      "isDefault": true,
      "createdAt": 1733900000000,
      "updatedAt": 1733900000000
    }
  ]
}

Account objects never include sensitive fields such as the proxy password. The id is the accountId you use when creating publish tasks.

Get one account#

GET /v1/accounts/{id}

Returns 404 when the account does not exist:

{ "error": { "code": "account_not_found", "message": "Account not found: a1b2c3d4" } }

Refresh login status#

Re-opens the account session, visits the platform and updates login state, nickname and avatar. This loads a real page and usually takes a few seconds.

POST /v1/accounts/{id}/refresh

200 — returns the refreshed account object (same shape as above).

Platforms#

List all supported platforms and their supported content types, useful for validation before creating a publish task.

GET /v1/platforms

200

{
  "platforms": [
    { "id": "weibo", "name": "Weibo", "supportedContentTypes": ["DYNAMIC", "ARTICLE", "VIDEO"] }
  ]
}
PreviousOverview & Getting StartedNextPublish