API de TikTok: conectar la cuenta y publicar videos

28 de octubre de 2026 · Equipo Zoosial

La API de TikTok de Zoosial conecta una cuenta de TikTok con el inicio de sesión oficial (Login Kit) y te deja publicar videos con la misma llamada POST /posts que usas para otras redes. También consulta el estado de cada publicación y lista los videos públicos de la cuenta con sus métricas. Lo que sí queda fuera: TikTok no ofrece una bandeja para leer comentarios o mensajes privados, así que Zoosial no los maneja.

Qué puedes hacer

• Conectar una cuenta de TikTok: GET /connect/tiktok?profileId=….
• Publicar un video: POST /posts, con el video en mediaUrls.
• Ver las opciones de publicación que permite la cuenta: GET /accounts/:accountId/tiktok/creator-info.
• Listar los videos públicos con sus métricas: GET /accounts/:accountId/tiktok/videos?cursor=&limit=. La documentación habla de vistas, likes, comentarios y compartidos por video.
• Consultar el estado de una publicación directa: GET /accounts/:accountId/tiktok/status?publishId=.
• Recibir los avisos de TikTok sobre el estado: POST /webhooks/tiktok recibe eventos firmados (authorization.removed, video.upload.failed, video.publish.completed) y actualiza el estado de la publicación.

Cómo conectar la cuenta

TikTok se conecta por OAuth. Llama a GET /connect/tiktok?profileId=prof_… con tu API key y recibirás { authUrl }. Abre esa URL en el navegador de la persona dueña de la cuenta; al autorizar, el callback conecta la cuenta y regresa al Dashboard de Zoosial. El profileId sale de POST /profiles; no lo inventes.

Aunque POST /connect/sessions acepta platform: "tiktok", el callback de TikTok todavía aterriza en el dashboard de Zoosial, así que no lo ofrezcas como flujo white-label.

Ejemplo

Publicar un video en una cuenta de TikTok ya conectada (los identificadores son ilustrativos):

curl -X POST https://zoosial.com/posts \
  -H "Authorization: Bearer $SC_API_KEY" -H "Content-Type: application/json" \
  -d '{"platforms":[{"accountId":"acc_tt_1"}],"content":"Detrás de cámaras","mediaUrls":["https://cdn.../clip.mp4"],"publishNow":true}'

Por MCP

No hay una herramienta MCP específica de TikTok. Un agente puede usar las genéricas: list_accounts para ver las cuentas conectadas, accounts_health para saber si alguna necesita reconectarse, create_post para publicar en una cuenta de TikTok y list_posts para ver el historial. Creator-info, videos y status no tienen herramienta MCP propia. Ver Servidor MCP.

Reglas y límites

• El video debe estar en una URL pública en mediaUrls; Zoosial descarga el video y lo sube a TikTok por partes (FILE_UPLOAD), sin exigir un dominio verificado.
• Por defecto Zoosial publica en modo directo (Direct Post, permiso video.publish). Si TikTok rechaza la publicación directa (por ejemplo, una cuenta pública mientras la auditoría de Direct Post no esté vigente), el intento falla con un mensaje que lo explica; no pasa solo a borradores. Para mandar el video al inbox de borradores del creador (permiso video.upload) se envía tiktok.mode: 'draft' en el POST /posts. El estado es asíncrono.
• Las APIs oficiales usadas no dan un inbox orgánico: no se pueden leer ni moderar comentarios ni mensajes privados de TikTok por Zoosial.
• La analítica suma los videos que TikTok devuelve; no hay serie histórica que la API no entregue.
• Una cuenta de TikTok por perfil. Para otra, crea otro perfil.

Precio

La API, los webhooks y el MCP vienen incluidos en el plan gratis: $0, un perfil con hasta 3 cuentas, sin tarjeta y sin vencimiento. El plan de pago cobra por perfil: $95 MXN al mes más IVA por perfil, y el primer perfil no se cobra. Detalle en precios.

Compáralo

Si estás eligiendo entre APIs para conectar redes, revisa la comparativa de Zoosial y la guía cómo elegir una API para conectar redes sociales.

Preguntas frecuentes

← Todas las integraciones