Skip to content

TikTok reporting for agencies

Connected via TikTok Login Kit and the Display API (v2). Read-only fundamentals — follower count, likes, videos, following, plus per-video views/likes/comments/shares. Impressions, reach, watch-time, demographics, and audience-activity heatmaps live in TikTok Business API (a separate developer product) and are not surfaced today.

Kanvro client dashboard showing TikTok metrics alongside other platforms

What we pull

  • Follower count — daily snapshot
  • Total likes received — daily snapshot
  • Video uploads (cursor-paginated; full list backfilled at first connect)
  • Following count
  • Per-video metadata (video ID, caption, cover image URL, duration, share URL) — visible in the dashboard's video list

OAuth scopes we request

  • user.info.basic
  • user.info.profile
  • user.info.stats
  • video.list

No write scopes. We never post on your behalf, never message anyone, never modify your settings.

Sync frequency

Daily 06:00 SAST alongside the other platforms. Backfill of the historical video list runs once at connect time, paged via TikTok's `cursor` parameter.

What we don't include

  • Per-video play count, reach, completion rate, or watch-time breakdown — not exposed by the Login Kit + Display API surface (would require switching to TikTok Business API, a separate developer product).
  • Audience demographics (age, gender, location) — same limitation.
  • Posting-time engagement / online-followers heatmap — same limitation.
  • TikTok Ads / Spark Ads / promoted-post metrics.
  • Comment streams — TikTok does not expose third-party comment access.
  • Posting, scheduling, or video upload — Kanvro is read-only.
  • Live stream metrics.

Notes

  • TikTok's data-deletion webhook (`tiktokDataDeletion`) is wired and processes deletion requests within 30 days as TikTok and POPIA require.
  • The TikTok logos in the codebase are currently placeholders. Production deployment requires replacing with official TikTok brand assets from https://www.tiktok.com/en/brand for brand compliance — see `tasks/todo.md`.

FAQ

Why is per-video performance not available?
TikTok's Login Kit + Display API surface (which Kanvro uses today) returns view, like, comment, and share counts per video — but not impressions, reach, or watch-time. Those metrics live in TikTok's Business API, a separate developer product with its own OAuth flow and approval process. We may add that in a future release.
Does Kanvro work with personal TikTok accounts or only TikTok for Business?
Kanvro works with any TikTok account that authorises the listed scopes via Login Kit.
How do I disconnect TikTok?
Use the per-platform Disconnect button in client settings. TikTok tokens are revoked, sync stops immediately, and historical metrics follow the same 90-day retention rule as the other platforms.
Will impressions, reach, demographics, or audience-activity heatmaps ever be added?
Those metrics require switching from TikTok Login Kit + Display API to TikTok Business API — a separate developer product with its own OAuth flow, scopes, and approval process. We may add that path in a future release when there's clear demand. Email hello@kanvro.com if it would unblock an agency upgrade.

Connect TikTok in under 5 minutes.

Start free with Spark on your own brand, or book a 15-minute walkthrough.

Start Free with Spark