TikTok Data Skill

La ruta de lectura determinista para los datos públicos de TikTok a través de UnifAPI. Este es un Data Skill: no ejecuta por sí solo un trabajo de marketing — nombra las operaciones tiktok/... concretas, las formas de respuesta y los detalles a tener en cuenta para que cualquier flujo de trabajo centrado en creadores o tendencias (listas cortas, encaje de audiencia, radar de demanda, buzz local) lea desde una receta conocida en lugar de redescubrir la superficie cada vez.

Solo lectura — ojos, no manos. Investiga datos públicos de TikTok y devuelve registros referenciados; nunca publica, comenta ni sigue, y UnifAPI nunca guarda credenciales de TikTok.

Usa el skill unifapi para obtener evidencia en vivo

Conecta una sola vez a través del skill compartido unifapi (OAuth MCP), luego llama a las operaciones de abajo. Los usuarios y vídeos de TikTok se identifican por id numérico — resuelve un @handle o una URL de vídeo a su id primero (consulta Detalles a tener en cuenta). Conserva cualquier metadato billing para que la salida pueda indicar el coste por registro.

Contrato de respuesta

Los endpoints de entidad única devuelven el objeto en data:

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

Los endpoints de lista devuelven un array en data más pagination:

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

Cuando pagination.has_more es true, pasa pagination.next_cursor como el cursor de la siguiente petición (limit establece el tamaño de página). Conserva siempre billing.

Operaciones principales

¿Necesitas un campo que no figura aquí? Usa el get_operation del skill unifapi para leer el esquema exacto antes de llamar — pero elige la operación de esta tabla, no descubras a ciegas.

Flujo de trabajo

Las recetas deterministas. Elige la que coincida con el trabajo; cada una nombra exactamente qué llamar.

1. Descubre por tema. Llama a tiktok/search/videos?q=..., tiktok/search/users?q=..., o tiktok/search/hashtags?q=... para el nicho; usa tiktok/search?q=... para un resultado mixto.
2. Resuelve un creador. Llama a tiktok/users/resolve?username=... para obtener el id numérico, luego tiktok/users/{id} para follower_count, like_count y video_count.
3. Lee la interacción. Llama a tiktok/users/{id}/videos; cada Video lleva view_count, like_count, comment_count y share_count — calcula la interacción por vídeo. Pagina vía next_cursor.
4. Lee un vídeo y su reacción. Llama a tiktok/videos/{id} (resuelve una URL con tiktok/videos/resolve?url=... primero), luego tiktok/videos/{id}/comments para el sentimiento.
5. Rastrea tendencias. Llama a tiktok/hashtags/{id} para video_count/view_count y tiktok/hashtags/{id}/videos (o tiktok/music/{id}/videos) para lo que se está propagando en una etiqueta o sonido.
6. Mapea una red. Llama a tiktok/users/{id}/followers, .../following, o .../likes para el trabajo de alcance y afinidad.
7. Referencia todo. Cada cifra se vincula al vídeo o perfil del que provino; reporta billing.records_charged (o estima cuando falte el metadato de facturación).

Notas sobre las formas

• User — username, display_name, follower_count, following_count, like_count, video_count, is_verified, is_private, region.
• Video — video_description, view_count, like_count, comment_count, share_count, duration, author, music, hashtags, create_time.
• Hashtag — name, video_count, view_count, is_commerce.
• Music — title, author, is_original.

Detalles a tener en cuenta

• Los usuarios y vídeos de TikTok se identifican por id numérico. Resuelve un @handle con tiktok/users/resolve?username=... y una URL de vídeo con tiktok/videos/resolve?url=... antes de cualquier llamada tiktok/users/{id}/... o tiktok/videos/{id}/....
• tiktok/videos/batch es un POST (ids en el cuerpo), no un GET — úsalo para hidratar muchos ids de vídeo a la vez.
• Un creador privado (is_private) limita lo que puedes leer — revélalo.
• Un saldo bajo puede truncar silenciosamente las páginas de lista: comprueba billing.truncated_due_to_balance — cuando es true, la página es parcial, así que recarga antes de confiar en cualquier recuento.

Salida

Devuelve los registros que el flujo de trabajo que llama necesita, cada uno referenciado a su vídeo o perfil, más una nota de coste de una línea (records_charged). Cuando este skill se usa directamente, un resumen compacto del creador es el predeterminado:

**@handle** — {followers} followers, {videos} videos. Recent videos: avg {views} views / {likes} likes / {comments} comments. Rising tags: {#hashtags}. Evidence: {video URLs}. Records: ~{N}.

Skills relacionados

• creator-shortlist, audience-fit-check (Influencer Marketing) — haz listas cortas y evalúa a los creadores de TikTok sobre esta ruta de lectura.
• social-listening-brief (Social Listening), treatment-demand-radar, menu-demand-radar, restaurant-local-buzz (verticales) — trabajo de tendencias y demanda que lee TikTok primero.
• unifapi — el skill de datos compartido: conecta MCP y busca los esquemas exactos con get_operation.