Get TikTok Insights
GET/api/tiktok-posting/insights
Summarises TikTok post performance for a date range: totals, the daily total views, one row per post published in the range, and one row per product with its TikTok Shop units sold in the same range.
tiktok-posts:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Views per post are TikTok's lifetime totals as of the range's last day, for posts published within the range. units_sold counts TikTok Shop order lines of the posted products ordered within the range (quantity minus cancelled and returned-before-shipping units, draft orders excluded) — only the chosen store's TikTok Shop channels when store_id is given. When no TikTok Shop channel exists, tiktok_shop_connected is false and every units_sold / views_per_unit is null.
followers / followers_change are present only when an account granted follower stats.
Scope: tiktok-posts:read. Permission: tiktok_posts.view.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.