API referenceTikTok Business

GET /api/v1/accounts/{id}/tiktok-business/insights

Stored daily account insights (synced from /business/get/ every TIKTOK_BUSINESS_INSIGHTS_SYNC_HOURS): daily video views, profile views, likes, comments, shares, new/lost followers..., their totals over the window and the follower counts. Read-only, no platform call

GET
/api/v1/accounts/{id}/tiktok-business/insights

Authorization

BearerAuth
headerAuthorizationBearer <token>

API key sk_...

Path Parameters

id*string

Account id

Query Parameters

fromDate?string

YYYY-MM-DD (default: 30 days before toDate)

toDate?string

YYYY-MM-DD (default: today)

Response Body

TikTokBusinessInsights

application/json
  1. response
accountId?string
platform?string
dateRange?
lastSyncedAt?string|null
totals?
daily?array<>
followers?array<>
note?string
Example Request
curl -X GET 'https://example.com/api/v1/accounts/string/tiktok-business/insights'
Example Response
{  "accountId": "string",  "platform": "string",  "dateRange": {    "fromDate": "string",    "toDate": "string"  },  "lastSyncedAt": "string",  "totals": {},  "daily": [    {      "date": "string",      "metrics": {}    }  ],  "followers": [    {      "date": "string",      "followers": 0,      "following": 0    }  ],  "note": "string"}

GET /api/v1/accounts/{id}/tiktok-business/permissions GET

Re-reads the permissions the account granted to its token (/tt_user/token_info/get/), stores them as the account's scopes and lists what is missing: missingPermissions (permission and the features it blocks), notGranted (every scope Postgale requests but the token lacks). TikTok Business permissions come from the scopes configured on the TikTok for Business app and the account owner's consent

POST /api/v1/accounts/{id}/tiktok-business/insights POST

Syncs the account's insights from TikTok now (daily metrics, followers, latest posts' metrics), then returns the stored insights like GET