Metrics

Métricas de TikTok con la API

Tu cliente conecta su cuenta de TikTok y tu producto consulta 7 métricas por el mismo endpoint que las demás plataformas. Cada métrica tiene un identificador (reference_key) que va en la llamada.

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"
      ]
    }
  ]
}
Ejemplo: "Número de vídeos" en octubre, comparado con septiembre.

Más ejemplos de llamadas a TikTok

El mismo endpoint para cada tipo de métrica. Los campos metrics y dimensions de cada ítem vienen del catálogo de la plataforma (GET /api/metrics/{integration_slug}).

Tabla

Videos destacados

Vídeos de su cuenta en el período analizado con mejor rendimiento. Puede incluir contenidos utilizados en campañas de anuncios en caso de que también aparezcan en 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

Me gusta totales

Total de me gusta acumulados de los vídeos publicados durante el período analizado. El conteo de me gusta de cada vídeo refleja el total de me gusta desde su publicación — y no los me gusta recibidos dentro del período. Puede incluir contenidos utilizados en campañas de anuncios si también aparecen en 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 en su cuenta durante el período analizado. Puede incluir contenidos utilizados en campañas de anuncios si también aparecen en TikTok Studio.

    tiktok:video_count
  • Me gusta totales

    Total de me gusta acumulados de los vídeos publicados durante el período analizado. El conteo de me gusta de cada vídeo refleja el total de me gusta desde su publicación — y no los me gusta recibidos dentro del período. Puede incluir contenidos utilizados en campañas de anuncios si también aparecen en TikTok Studio.

    tiktok:likes
  • Comentarios

    Total de comentarios acumulados de los vídeos publicados durante el período analizado. El conteo de comentarios de cada vídeo refleja el total de comentarios desde su publicación — y no los comentarios recibidos dentro del período. Puede incluir contenidos utilizados en campañas de anuncios si también aparecen en TikTok Studio.

    tiktok:comments
  • Acciones totales

    Total de compartidos acumulados de los vídeos publicados durante el período analizado. El conteo de compartidos de cada vídeo refleja el total de compartidos desde su publicación — y no los compartidos que ocurrieron dentro del período. Puede incluir contenidos utilizados en campañas de anuncios si también aparecen en TikTok Studio.

    tiktok:share
  • Total de visualizaciones

    Total de visualizaciones acumuladas de los videos publicados durante el período analizado. El conteo de visualizaciones de cada video refleja el total de visualizaciones desde su publicación — y no las visualizaciones que ocurrieron dentro del período. Puede incluir contenidos utilizados en campañas de anuncios si estos también aparecen en TikTok Studio.

    tiktok:views
  • Seguidores

    Número total de seguidores en su cuenta

    tiktok:follows

Tablas

1 métrica

  • Videos destacados

    Vídeos de su cuenta en el período analizado con mejor rendimiento. Puede incluir contenidos utilizados en campañas de anuncios en caso de que también aparezcan en TikTok Studio.

    tiktok:top_videos

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.