Insights

TikTok analytics uses the Display API scopes user.info.stats and video.list (in addition to publish scopes).

Account stats

Live follower / following / likes / video counts for a connected TikTok account:

curl "https://api.onepostly.com/v1/connections/CONNECTION_ID/stats" \
  -H "x-api-key: op_YOUR_KEY"

{
  "connectionId": "…",
  "platform": "tiktok",
  "status": "ready",
  "stats": {
    "followerCount": 1200,
    "followingCount": 80,
    "likesCount": 5400,
    "videoCount": 42
  },
  "fetchedAt": "2026-07-18T12:00:00.000Z"
}

Requires user.info.stats. Stats are also reflected on the connection after connect.

Creator media (recent videos)

Paginated list of the creator’s public TikTok videos:

curl "https://api.onepostly.com/v1/connections/CONNECTION_ID/media?limit=10" \
  -H "x-api-key: op_YOUR_KEY"

Optional: cursor from the previous nextCursor.

Each item includes cover, share URL, and per-video metrics (likes, comments, shares, views).

Requires video.list. Private / Only-me posts may not appear in this list.

Post destination insights

Same surface as other platforms:

curl "https://api.onepostly.com/v1/posts/POST_ID/insights?destinationId=DEST_ID" \
  -H "x-api-key: op_YOUR_KEY"

Mapped metrics:

Insights need a real TikTok video id. If publish only returned a publish_id (common for private / unaudited Direct Post), status stays pending until a public video id is available.

See also

• Overview (TikTok)
• Posts (TikTok)