Metrics
TikTok metrics via API
Your customer connects their TikTok account and your product queries 7 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "tiktok:video_count",
"component": "number_v1",
"metrics": [
"video_count"
],
"dimensions": [
"video"
]
}
]
}More TikTok request examples
The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).
Table
Featured videos
Videos from your account during the analyzed period that performed best with your audience. May include content used in ad campaigns if they also appear in TikTok Studio.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "tiktok:top_videos",
"component": "datatable_v1",
"metrics": [
"view_count",
"like_count",
"share_count",
"comment_count",
"create_time"
],
"dimensions": [
"video"
]
}
]
}Number
Total likes
Total accumulated likes of videos published during the analyzed period. Each video's like count reflects its total lifetime likes since publication — not likes received within the period. May include content used in ad campaigns if they also appear in TikTok Studio.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "tiktok:likes",
"component": "number_v1",
"metrics": [
"like_count"
],
"dimensions": [
"video"
]
}
]
}Numbers
6 metrics
Number of Videos
Number of videos published on your account during the analyzed period. May include content used in ad campaigns if they also appear in TikTok Studio.
tiktok:video_countTotal likes
Total accumulated likes of videos published during the analyzed period. Each video's like count reflects its total lifetime likes since publication — not likes received within the period. May include content used in ad campaigns if they also appear in TikTok Studio.
tiktok:likesComments
Total accumulated comments of videos published during the analyzed period. Each video's comment count reflects its total lifetime comments since publication — not comments received within the period. May include content used in ad campaigns if they also appear in TikTok Studio.
tiktok:commentsTotal Shares
Total accumulated shares of videos published during the analyzed period. Each video's share count reflects its total lifetime shares since publication — not shares that occurred within the period. May include content used in ad campaigns if they also appear in TikTok Studio.
tiktok:shareTotal views
Total accumulated views of videos published during the analyzed period. Each video's view count reflects its total lifetime views since publication — not views that occurred within the period. May include content used in ad campaigns if they also appear in TikTok Studio.
tiktok:viewsFollows
Total number of followers on your account
tiktok:follows
Tables
1 metric
Featured videos
Videos from your account during the analyzed period that performed best with your audience. May include content used in ad campaigns if they also appear in TikTok Studio.
tiktok:top_videos
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
