API de TikTok Analytics: métricas de cuenta y de videos
La API for Business de TikTok devuelve las métricas de una cuenta por día, como seguidores, vistas de video, vistas de perfil, me gusta, comentarios y compartidos, de hasta los últimos 60 días, y los totales de vida de cada video, como vistas, me gusta, comentarios y compartidos. La mayoría de las cifras llega con 24 a 48 horas de retraso y depende de que TikTok Analytics esté activado en la app.
easyCoexistence lee las métricas de TikTok con get_social_insights desde Claude, ChatGPT o tu propio código: los seguidores, las vistas y los me gusta de la cuenta por día, o las vistas, me gusta, comentarios y compartidos de un video.
Periodo más largo para las métricas diarias de una cuenta; sin fechas, la API devuelve los últimos 7 días.
Retraso habitual antes de que estén disponibles las cifras diarias y por publicación, como me gusta, vistas y compartidos.
Tiempo tras la publicación en el que deja de actualizarse el dato de una publicación.
Seguidores que necesita una cuenta para que TikTok devuelva los desgloses de edad, género y ubicación de sus seguidores.
¿Qué métricas de cuenta hay?
GET /business/get/ devuelve el perfil de la cuenta y, para las fechas pedidas, una lista de métricas con una entrada por día, en UTC:
followers_count: el total actual y el total de cada día.video_views,profile_views, likes, comments y shares: cifras diarias de los videos de la cuenta.unique_video_views,daily_new_followers,daily_lost_followersyengaged_audience: diarios, para cuentas con Advanced Access o Verified Business Accounts.audience_ages,audience_genders,audience_countriesyaudience_cities: desgloses de seguidores, para cuentas con al menos 100 seguidores.
¿Qué métricas de video hay?
GET /business/video/list/ devuelve las publicaciones públicas de la cuenta con sus totales de vida, sin el límite de 60 días: video_views, likes, comments, shares y favorites, además de alcance, tiempo total y promedio de visualización, tasa de visualización completa, nuevos seguidores y fuentes de tráfico. Devuelve hasta 20 publicaciones por página, y filters.video_ids permite elegir algunas concretas.
¿Qué tan actualizados están los datos?
Los campos del perfil, como el nombre de usuario y el total actual de seguidores, son en tiempo real. Las métricas diarias de la cuenta y las cifras de publicaciones, como vistas, me gusta, comentarios y compartidos, suelen tener 24 a 48 horas de retraso, en UTC, y el dato de una publicación deja de actualizarse 365 días después de publicada. El alcance, el tiempo de visualización y las fuentes de tráfico pueden faltar en un video que nadie ha visto, con me gusta, comentado o compartido durante más de 7 días.
¿Por qué pueden faltar métricas?
La API devuelve lo que tiene TikTok Analytics. El titular de la cuenta debe publicar al menos un video y activar Analytics en la app de TikTok, y no hay datos de antes de que Analytics estuviera activado. Algunas métricas requieren más: la audiencia alcanzada y los seguidores nuevos o perdidos solo están disponibles para cuentas con Advanced Access o Verified Business Accounts, y los desgloses de seguidores empiezan con 100 seguidores.
¿Por qué las cifras pueden diferir de la app de TikTok?
Por lo que incluyen. video_views cuenta vistas orgánicas y pagadas juntas, y shares cuenta tanto los compartidos fuera de TikTok como los envíos a amigos dentro de la app, así que puede salir más alto que el contador de compartidos del sitio web de TikTok. La cifra de me gusta de un día no resta los me gusta retirados después.
¿Cómo las lee easyCoexistence?
Con get_social_insights. Para la cuenta, pide métricas como followers_count, video_views y likes, con start_date y end_date, y devuelve las filas diarias de TikTok. Para un video, indica su item_id como object_id y devuelve vistas, me gusta, comentarios y compartidos, buscando entre los 20 videos más recientes de la cuenta; para uno más antiguo, tu propio código llama a business/video/list/ con filters.video_ids, usando el token de get_social_credentials.
Errores comunes
- Dar por definitivas las cifras de ayer. Las métricas diarias pueden tener 24 a 48 horas de retraso, así que los días recientes pueden seguir completándose.
- Pedir más de 60 días de métricas de cuenta. El límite se detiene ahí, así que guarda las cifras si necesitas un historial más largo.
- Buscar un video antiguo por object_id. get_social_insights busca entre los 20 más recientes; para publicaciones antiguas, filtra por video_ids desde tu propio código, con el token de get_social_credentials.
- Comparar los compartidos de la API con el contador del sitio web. La API también cuenta los envíos a amigos dentro de TikTok, así que su cifra es más alta.
Para otros campos de métricas de TikTok, get_social_credentials da a tu propio código el token de la cuenta. De US$ 9 a US$ 0.75 por conexión al mes, con descenso a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿La API de TikTok muestra cuántos seguidores perdió una cuenta?
Sí, como daily_lost_followers junto a daily_new_followers, para cuentas con Advanced Access o Verified Business Accounts.
¿Hasta dónde llegan las métricas de cuenta de TikTok?
60 días. Sin fechas, la API devuelve los 7 días hasta el día anterior a la petición, en UTC.
¿Cuándo deja de actualizarse el dato de un video de TikTok?
365 días después de publicado el video. Hasta entonces sus totales de vida siguen actualizándose, normalmente con 24 a 48 horas de retraso.
¿Las vistas de los videos de TikTok incluyen vistas pagadas?
Sí. La cifra video_views que devuelve TikTok cubre la actividad orgánica y pagada juntas.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el