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"
      ]
    }
  ]
}
Exemplo: "Número de Vídeos" em outubro, comparado a setembro.

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_count
  • 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.

    tiktok:likes
  • Comentá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:comments
  • Total 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:share
  • Total 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:views
  • Seguidores

    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.