PluggzyDocs

YouTube

VideosProgramaciónMétricas
VideosProgramaciónMétricas

Sube videos y Shorts a tu canal de YouTube desde cualquier app de IA, con título, descripción, etiquetas y visibilidad, al momento o a la hora que elijas.

Conectar YouTube
Conexión con
tu inicio de sesión de Google, en tu navegador
Herramientas
6 herramientas de publicación compartidas
Bandeja de entrada
no disponible en YouTube
6 / díapublicaciones, al momento o programadas
2–5 sentre acciones, al azar
5000caracteres de texto
1video por publicación

Límites

AcciónPor díaPor minutoSeparación mín.RitmoHerramientas
Lecturasopciones de publicación y listas de cuentas300030——post_optionsget_insights
Publicaciones6230 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
Publicaciones6/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 YouTube 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 YouTube.

Reglas de publicación

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

DescripciónobligatorioHasta 5000 caracteres, en text.
TítuloobligatorioObligatorio, hasta 100 caracteres, en title.
Archivos multimediaobligatorioObligatorio: un video (video_url), no ambos. Los archivos de tu dispositivo pasan antes por upload_media.
visibilityPublic (default), private or unlistedpublicprivateunlisted
tagsVideo tags (each ≤100 characters, ≤500 in all).
made_for_kidsThe video is made for children (default false; true turns comments off for good)
thumbnail_urlPublic https link to a custom thumbnail (JPEG or PNG, ≤2 MB).

Límites de seguridad

Lo que mantiene tu cuenta de YouTube 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 YouTube, 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 YouTube. 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.
Comprobado primeroGratis
El texto, el título y los archivos se revisan según las reglas de YouTube antes de la llamada: una publicación que YouTube rechazaría no cuesta nada.
Límite por cuenta10 / min
Como máximo 10 llamadas por minuto por cuenta en total, sin contar lecturas, además del límite por minuto de cada acción.

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 YouTube. 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.
cooldownYouTube 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": "YouTube 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 YouTube. 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

YouTube 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 YouTube.

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). YouTube: text ≤5000, 1 video (required), a title ≤100. YouTube needs a video and a title. 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 · 6/díaCon ritmo 2–5 sPúblico e irreversible: confirma antes el texto y los archivos
EntradaCampos de YouTube · 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 YouTube
The post's text (Instagram: the caption; YouTube and Pinterest: the description; WordPress: the article's HTML)
por defecto ""máx. 5000 caracteres en YouTube
titlestringobligatorio en YouTube
YouTube video, Pinterest pin or WordPress article title; other networks have none
máx. 100 caracteres en YouTube
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. 0 elementos
video_urlstring
Public https link to one video
visibilityenum
Public (default), private or unlisted
anyonerelations_onlypublicprivateunlisted
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.
tagsstring[]
Video tags (each ≤100 characters, ≤500 in all).
máx. 500 elementos
made_for_kidsboolean
The video is made for children (default false; true turns comments off for good)
thumbnail_urlstring
Public https link to a custom thumbnail (JPEG or PNG, ≤2 MB).
https://
SalidastructuredContent
{
  "structuredContent": {
    "url": "https://www.threads.net/@ada.martin/post/DQ3kF8sDk2L",
    "post_id": "18063215523019873",
    "published": true
  },
  "content": [
    {
      "type": "text",
      "text": "Post published."
    }
  ]
}
Mientras YouTube 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ímites2 de 6 hoy
  3. Espaciada+2 s
  4. Enviada09:41:04
Publicaciones hoy: 2 de 6 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