PluggzyDocs

Threads

PublicacionesImágenesVideosProgramaciónMétricas
PublicacionesImágenesVideosProgramaciónMétricas

Publica texto, hasta 10 imágenes o un video en tu cuenta de Threads desde cualquier app de IA, al momento o a la hora que elijas.

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

Límites

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

Reglas de publicación

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

TextoobligatorioHasta 500 caracteres, en text.
Archivos multimediaOpcional: hasta 10 imágenes (image_urls) o un video (video_url), no ambos. Los archivos de tu dispositivo pasan antes por upload_media.

Límites de seguridad

Lo que mantiene tu cuenta de Threads 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 Threads, 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 Threads. 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 Threads antes de la llamada: una publicación que Threads 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 Threads. 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.
cooldownThreads 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": "Threads 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 Threads. 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.
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.
  • Threads: las cifras vienen de sus publicaciones, no de la cuenta.

Herramientas

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

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). Threads: text ≤500, up to 10 images or 1 video. 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 · 25/díaCon ritmo 2–5 sPúblico e irreversible: confirma antes el texto y los archivos
EntradaCampos de Threads · 6 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 Threads
The post's text (Instagram: the caption; YouTube and Pinterest: the description; WordPress: the article's HTML)
por defecto ""máx. 500 caracteres en Threads
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. 10 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.
SalidastructuredContent
{
  "structuredContent": {
    "url": "https://www.threads.net/@ada.martin/post/DQ3kF8sDk2L",
    "post_id": "18063215523019873",
    "published": true
  },
  "content": [
    {
      "type": "text",
      "text": "Post published."
    }
  ]
}
Mientras Threads 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ímites7 de 25 hoy
  3. Espaciada+2 s
  4. Enviada09:41:04
Publicaciones hoy: 7 de 25 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