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"
]
}
]
}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_countMe 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:likesComentarios
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:commentsAcciones 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:shareTotal 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:viewsSeguidores
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.
