Skip to content
Live Agent Pro Docs
Platforms & Stats

TikTok Connections

Connect a host's TikTok account to pull their audience counts — what it does and does not fetch.

A host can authorize Live Agent Pro to read their TikTok profile. This is the only automatic data feed in the product.

What it fetches — and what it does not #

A connection pulls four numbers: total followers, accounts the host follows, total likes, and video count. It also refreshes the host's TikTok display name and avatar.

It does not fetch diamonds, live minutes, valid live days, battles, live views, or peak viewers. TikTok's API does not expose LIVE earnings or air time to us, so those reach Live Agent Pro by CSV import, or by hand, on TikTok exactly as they do on Bigo. See Platform Stats for the full breakdown.

The four numbers it does fetch are lifetime running totals, not a week's activity. The host's TikTok platform record shows the last pulled value of each count, and each day's pull is kept as one entry for that day. A pull does not add a row to the host's stats.

How it connects #

The host authorizes Live Agent Pro through TikTok's own OAuth consent screen — your agency never handles the host's password. Authorizing creates a stored connection holding the host's token, one per host per platform. The host can revoke it from TikTok at any time, which stops the pull.

When it runs #

Every night, and on demand. Every working connection is pulled once a night. For fresh counts in between, open the host's TikTok platform record and press Sync now.

Last synced on the host's TikTok record shows when their counts were last pulled. If no pull has worked for 48 hours, the record's Status reads Not syncing since with the date of the last one that did, unless it reads Stopped working (below). Each of your agency's admins who can see such a host then gets a notice in the app with the number of those hosts this has newly happened to and a link to the list of every host not syncing; an admin who can see none of them gets no notice, and a host is counted again only after its pulls have worked and then failed again. Try Reconnect TikTok and ask the host to approve it again on TikTok, and contact support if that does not help. The host's last counts are kept.

When TikTok says outright that the host's authorization is no longer valid, usually the record's Status also reads Stopped working with the date, your agency's admins who can see the host get a notice in the app, and it is not pulled again until it is reconnected.

Availability #

TikTok's API requires the platform to approve the integration and requires each host to grant it individually. A connection can fail to be created, or a pull can fail, for a reason on TikTok's side (the integration's approval status, or a host's revoked or expired grant) or on ours. Until TikTok connections are set up for Live Agent Pro, or while the app's TikTok key is missing, the Connect TikTok button is replaced by a short note, Sync now is not shown, and the notices about counts not updating say TikTok isn't available at the moment instead of suggesting Reconnect TikTok. Once they are, there is nothing to pull until a host has authorized.