Accounts

Get Account Stats

Returns live audience counts, such as followers and likes, for TikTok, Instagram, Facebook and Bluesky accounts. A count the platform does not report is null.

GET
/v1/accounts/{id}/stats

Authorization

Bearer
headerAuthorizationBearer <op_>

Workspace API key, sent as Authorization: Bearer op_... Keys are created in the dashboard.

Path Parameters

id*string
Length1 <= length

Response Body

Account stats

application/json
  1. response
accountId*string
platform*|

The platform id. New platforms can be added, so handle a value you do not know.

followerCount*|

Followers. Null when the platform does not report it.

followingCount*|

Accounts this account follows. Null when the platform does not report it.

likesCount*|

TikTok: likes across the account's videos. Facebook: people who like the Page. Null on other platforms.

videoCount*|

Published posts. Videos on TikTok, media on Instagram and posts on Bluesky. Null on other platforms.

fetchedAt*string
Formatdate-time
Example Request
import { Configuration, AccountsApi } from "@onepostly/sdk";const accountsApi = new AccountsApi(  new Configuration({ accessToken: process.env.ONEPOSTLY_API_KEY }));const response = await accountsApi.getAccountStats({  id: "acc_YOUR_INSTAGRAM_ACCOUNT_ID",});console.log(response);
Example Response
{  "accountId": "acc_YOUR_INSTAGRAM_ACCOUNT_ID",  "platform": "instagram",  "followerCount": 12480,  "followingCount": 318,  "likesCount": null,  "videoCount": 642,  "fetchedAt": "2027-03-15T10:00:00.000Z"}