PluggzyDocs

TikTok

PublicacionesVideosCarruseles de fotosProgramaciónMétricas
PublicacionesVideosCarruseles de fotosProgramaciónMétricas

Publica videos y carruseles de fotos en tu cuenta de TikTok desde cualquier app de IA, al momento o a la hora que elijas. TikTok exige tu visto bueno sobre el texto y los archivos finales, así que tu asistente siempre te muestra la publicación antes de que salga.

Conectar TikTok
Conexión con
tu inicio de sesión de TikTok, en tu navegador
Herramientas
6 herramientas de publicación compartidas
Bandeja de entrada
no disponible en TikTok
10 / díapublicaciones, al momento o programadas
2–5 sentre acciones, al azar
2200caracteres de descripción
1 o 35un video, o hasta 35 imágenes

Límites

AcciónPor díaPor minutoSeparación mín.RitmoHerramientas
Lecturasopciones de publicación y listas de cuentas300030——post_optionsget_insights
Publicaciones10230 s2–5 screate_post
Publicaciones programadaslistar y cancelar————list_scheduled_postscancel_scheduled_post
Lecturas3000/día
opciones de publicación y listas de cuentas
30/min · sin ritmo
post_optionsget_insights
Publicaciones10/día
2/min · separación mín. 30 s · ritmo 2–5 s
create_post
Publicaciones programadas—
listar y cancelar
list_scheduled_postscancel_scheduled_post
  • Por cada cuenta de TikTok conectada, compartidos por todas las apps de IA y claves de API que la usan.
  • Los límites diarios se reinician a las 00:00 UTC; los semanales, el lunes a las 00:00 UTC.
  • Listar y cancelar publicaciones programadas se hace en Pluggzy y no consume ninguna llamada a TikTok.

Reglas de publicación

Lo que TikTok acepta, comprobado antes de enviar nada, para que una publicación incorrecta no cueste nada.

DescripciónobligatorioHasta 2200 caracteres, en text.
Archivos multimediaobligatorioObligatorio: hasta 35 imágenes (image_urls) o un video (video_url), no ambos. Los archivos de tu dispositivo pasan antes por upload_media.
privacy_levelobligatorioWho can watch; one of the levels post_options lists for the accountPUBLIC_TO_EVERYONEMUTUAL_FOLLOW_FRIENDSFOLLOWER_OF_CREATORSELF_ONLY
allow_commentobligatorioAllow comments
allow_duetAllow duets
allow_stitchAllow stitches
user_confirmedobligatorioTrue only once the user has seen the final caption and media and agreed to publish them (TikTok's legal requirement)

Límites de seguridad

Lo que mantiene tu cuenta de TikTok en buen estado. Se aplican a todas las apps de IA y claves de API de esta cuenta, y no se pueden desactivar.

Ritmo2–5 s
Separación aleatoria entre acciones de TikTok, en todas las apps y claves de esta cuenta.
Sin publicaciones duplicadas10 min
La misma publicación en la misma cuenta en menos de 10 minutos devuelve la primera respuesta en lugar de publicar dos veces.
Pausa si la red pone freno5 min
Tras una respuesta de límite de uso, la cuenta descansa al menos 5 minutos, 30 si lo pidió el propio TikTok. Mientras tanto, cada llamada recibe el tiempo que falta.
Ventana de programación1 año
publish_at debe ser al menos un minuto en el futuro, y como máximo un año. Los enlaces deben seguir funcionando hasta entonces; los archivos subidos se guardan con la publicación.
La pausa propia de TikTokComprobada
TikTok puede impedir que una cuenta publique durante un tiempo. post_options lo indica (can_post_more) antes de que lo intentes.
Consentimiento registradoObligatorio
user_confirmed: true en cada publicación y programación de TikTok. Sin él, la publicación se rechaza antes de llegar a TikTok.

Cuando se alcanza un límite

Nada se pone en cola ni se reintenta a tus espaldas: la herramienta responde con un error que tu app de IA puede leer, explicarte y reintentar en el momento justo.

invalid_postLa publicación incumple una regla de TikTok. El mensaje dice cuál.
gapDemasiado pronto después de la última acción. Espera retry_after_seconds.
limitSe agotó el límite diario o semanal. Indica cuándo se reinicia.
cooldownTikTok puso freno; la cuenta está descansando.
permissionEsta app no tiene permiso para hacer eso. Vuelve a conectarla y permítelo.
Ejemplo de rechazo
isError
{
  "error": "TikTok actions are spaced 2–5 s apart, at random, to look human. Wait 2s.",
  "code": "gap",
  "retry_after_seconds": 2
}

Analíticas

Lo que get_insights lee en TikTok. Pregunta con tus propias palabras; tu app de IA elige el informe.

Resumenoverview predeterminadoVistas, alcance, interacción y seguidores en los últimos days, con los términos de cada red más un resumen común a todas. Sin account, todas las cuentas con analíticas lado a lado.
Seguidoresfollowers El número de seguidores día a día (suscriptores en YouTube), con los seguidores ganados y perdidos.
Audienciaaudience Seguidores por país y ciudad, y por edad y género cuando la red lo reporta.
Mejores publicacionestop_posts Tus mejores publicaciones del periodo, ordenadas por interacción o por sort (vistas, alcance, me gusta, comentarios, compartidos, fecha). Sin account, en todas las cuentas con analíticas.
Mejor hora para publicartiming Los días de la semana y franjas horarias que mejor funcionan para tus publicaciones (en UTC), con qué frecuencia publicas frente a la interacción que recibes y lo rápido que llegan a su pico. Instagram: cuándo están conectados tus seguidores.
Una publicaciónpost Las cifras de una publicación, por el post_id de list_posts, de las mejores publicaciones o de create_post. details: true añade su curva día a día y los datos extra de la red.

Herramientas

TikTok no tiene herramientas propias: usa las herramientas de publicación compartidas, que funcionan en todos los canales de publicación. Esta página muestra solo los campos que lee TikTok.

6 herramientas · 3 de lectura · 3 de escritura
Publicar3

Publish a post on one connected account, right away or at publish_at (then it's scheduled: returns a scheduled_post_id for list_scheduled_posts and cancel_scheduled_post). TikTok: text ≤2200, up to 35 images or 1 video (required). TikTok needs privacy_level, allow_comment (and allow_duet, allow_stitch for a video) and user_confirmed: true, meaning the user saw the final caption and media and agreed to publish (TikTok's legal requirement). Call post_options first for an account you haven't posted to in this conversation. Media: media_ids from upload_media (files the user has, or one you made), or public https links (image_urls, video_url); for a scheduled post, links must keep working until publish_at, uploads are kept with the post. Public and irreversible: confirm the account, final text, media, audience and time (with the user's time zone) with the user first.

Permiso Send messages & postsLímite Publicaciones · 10/díaCon ritmo 2–5 sPúblico e irreversible: confirma antes el texto y los archivos
EntradaCampos de TikTok · 11 de 36
accountstring
account_id of the account to post from (list_accounts). Needed only when several accounts that can post are connected.
textstringobligatorio en TikTok
The post's text (Instagram: the caption; YouTube and Pinterest: the description; WordPress: the article's HTML)
por defecto ""máx. 2200 caracteres en TikTok
media_idsstring[]
media_id values from upload_media, in order (images, or one video). Instead of image_urls and video_url
1–35
image_urlsstring[]
Public https links to the images, in order
máx. 35 elementos
video_urlstring
Public https link to one video
publish_atstring
Schedule it: ISO 8601 date and time with a UTC offset, like 2026-11-03T09:30:00+01:00, at least a minute ahead, at most a year. Leave it out to publish now.
privacy_levelenumobligatorio en TikTok
Who can watch; one of the levels post_options lists for the account
PUBLIC_TO_EVERYONEMUTUAL_FOLLOW_FRIENDSFOLLOWER_OF_CREATORSELF_ONLY
allow_commentbooleanobligatorio en TikTok
Allow comments
allow_duetboolean
Allow duets
allow_stitchboolean
Allow stitches
user_confirmedbooleanobligatorio en TikTok
True only once the user has seen the final caption and media and agreed to publish them (TikTok's legal requirement)
SalidastructuredContent
{
  "structuredContent": {
    "url": "https://www.threads.net/@ada.martin/post/DQ3kF8sDk2L",
    "post_id": "18063215523019873",
    "published": true
  },
  "content": [
    {
      "type": "text",
      "text": "Post published."
    }
  ]
}
Mientras TikTok sigue procesando
{
  "published": false,
  "status": "publishing",
  "post_id": "6914b2c8e4a1f0d3c2b5a7e9"
}
Qué hizo el filtroEjemplo09:41:02 → 09:41:04
  1. Recibida09:41:02
  2. Dentro de los límites3 de 10 hoy
  3. Espaciada+2 s
  4. Enviada09:41:04
Publicaciones hoy: 3 de 10 usados · se reinicia a las 00:00 UTC
El contenido de texto empieza con “Post published.” · Puede rechazar coninvalid_postgaplimitcooldownpermission
Publicaciones programadas2
Analíticas1
Generado desde pluggzy.com/api/docs · 42 herramientas¿Algo no está claro? Escribe a soporte · Estado del servicio