Metrics
Métricas do TikTok pela API
Seu cliente conecta a conta do TikTok e seu produto consulta 7 métricas pelo mesmo endpoint das outras plataformas. Cada métrica tem um identificador (reference_key) que vai na chamada.
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"
]
}
]
}Mais exemplos de chamadas no TikTok
O mesmo endpoint para cada tipo de métrica. Os campos metrics e dimensions de cada item vêm do catálogo da plataforma (GET /api/metrics/{integration_slug}).
Tabela
Vídeos em destaque
Vídeos da sua conta no período analisado com melhor desempenho. Pode incluir conteúdos utilizados em campanhas de anúncios caso os mesmos também apareçam no 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"
]
}
]
}Número
Total de Curtidas
Total de curtidas acumuladas dos vídeos publicados durante o período analisado. A contagem de curtidas de cada vídeo reflete o total de curtidas desde sua publicação — e não as curtidas recebidas dentro do período. Pode incluir conteúdos utilizados em campanhas de anúncios caso os mesmos também apareçam no 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"
]
}
]
}Números
6 métricas
Número de Vídeos
Número de vídeos publicados na sua conta durante o período analisado. Pode incluir conteúdos utilizados em campanhas de anúncios caso os mesmos também apareçam no TikTok Studio.
tiktok:video_countTotal de Curtidas
Total de curtidas acumuladas dos vídeos publicados durante o período analisado. A contagem de curtidas de cada vídeo reflete o total de curtidas desde sua publicação — e não as curtidas recebidas dentro do período. Pode incluir conteúdos utilizados em campanhas de anúncios caso os mesmos também apareçam no TikTok Studio.
tiktok:likesComentários
Total de comentários acumulados dos vídeos publicados durante o período analisado. A contagem de comentários de cada vídeo reflete o total de comentários desde sua publicação — e não os comentários recebidos dentro do período. Pode incluir conteúdos utilizados em campanhas de anúncios caso os mesmos também apareçam no TikTok Studio.
tiktok:commentsTotal de Compartilhamentos
Total de compartilhamentos acumulados dos vídeos publicados durante o período analisado. A contagem de compartilhamentos de cada vídeo reflete o total de compartilhamentos desde sua publicação — e não os compartilhamentos que ocorreram dentro do período. Pode incluir conteúdos utilizados em campanhas de anúncios caso os mesmos também apareçam no TikTok Studio.
tiktok:shareTotal de visualizações
Total de visualizações acumuladas dos vídeos publicados durante o período analisado. A contagem de visualizações de cada vídeo reflete o total de visualizações desde sua publicação — e não as visualizações que ocorreram dentro do período. Pode incluir conteúdos utilizados em campanhas de anúncios caso os mesmos também apareçam no TikTok Studio.
tiktok:viewsSeguidores
Número total de seguidores da sua conta
tiktok:follows
Tabelas
1 métrica
Vídeos em destaque
Vídeos da sua conta no período analisado com melhor desempenho. Pode incluir conteúdos utilizados em campanhas de anúncios caso os mesmos também apareçam no TikTok Studio.
tiktok:top_videos
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
