API de Threads: publicar y leer con la API oficial
Sí, Threads tiene una API oficial, y es la más amable de las que publica Meta. Publicas en dos llamadas, puedes leer tus posts, respuestas e insights, y para tu propio perfil no hay ningún app review que superar. El tope es de 250 posts publicados y 1.000 respuestas por cada 24 horas. Todo lo que viene a continuación sale de la documentación de Threads de Meta, consultada el 10 de septiembre de 2026.
Lo que la Threads API puede hacer hoy
Según la introducción a la Threads API, la API cubre cuatro tareas: crear y publicar contenido en nombre de un usuario, mostrar los posts de ese usuario dentro de tu app, gestionar respuestas y borrar posts. El índice de la documentación también lista perfiles, menciones, insights, webhooks, búsqueda por palabras clave y etiquetado de ubicación.
Las llamadas van a graph.threads.com o graph.threads.net, con un access token. Los scopes son granulares, así que pide solo lo que uses:
| Operación | Scopes necesarios |
|---|---|
| Leer un perfil y sus posts | threads_basic |
| Publicar un post o una respuesta | threads_basic, threads_content_publish |
| Ocultar, aprobar o moderar respuestas | threads_basic, threads_content_publish, threads_manage_replies |
| Borrar un post | threads_basic, threads_delete |
| Leer insights | threads_basic, threads_manage_insights |
| Etiquetar y buscar ubicaciones | threads_basic, threads_location_tagging |
Compáralo con Instagram, donde publicar exige una cuenta profesional vinculada a una página de Facebook más App Review, y entenderás por qué Threads es donde le digo a la gente que pruebe primero su código de publicación.
API de publicación de Threads: el flujo de publicación en dos pasos
La misma forma que en Instagram. Crea un contenedor de medios y luego publícalo, como se describe en la guía de publicaciones.
# 1. create the container
curl -X POST "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads" \
-d "media_type=TEXT" \
-d "text=Shipping notes for the week" \
-d "access_token=<TOKEN>"
# -> { "id": "17890000000000000" }
# 2. publish it
curl -X POST "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publish" \
-d "creation_id=17890000000000000" \
-d "access_token=<TOKEN>"
media_type acepta TEXT, IMAGE o VIDEO, con image_url o video_url para medios. Las publicaciones de texto tienen un límite de 500 caracteres, y los emojis cuentan como su número de bytes UTF-8, así que una publicación con muchos emojis se queda sin espacio antes de lo que sugiere el recuento de caracteres.
El paso que la gente se salta es la espera. El consejo de la propia Meta: «espera una media de 30 segundos antes de publicar un contenedor de medios de Threads para dar a nuestro servidor tiempo suficiente para procesar del todo la subida». Si publicas demasiado pronto un vídeo, obtienes un error, no un post. Mete el retraso en el código, o consulta el estado del contenedor antes del paso 2.
Carruseles, respuestas y quién puede contestar
Un carrusel es el mismo flujo con una capa extra: crea cada contenedor hijo con is_carousel_item=true, crea un contenedor padre de tipo CAROUSEL que liste los hijos, y luego publica el padre. Mínimo dos hijos, máximo 20, y puedes mezclar imágenes y vídeos. Un carrusel cuenta como una sola publicación en tu límite de peticiones.
Las respuestas usan los mismos endpoints de publicación con un reply_to_id, y tienen su propio presupuesto, separado del de los posts.
La moderación es donde la Threads API va de verdad por delante de la de Instagram. Según la documentación de gestión de respuestas:
reply_controlse define al crear la publicación y aceptaeveryone,accounts_you_follow,mentioned_only,parent_post_author_onlyofollowers_only.enable_reply_approvals=trueen el contenedor retiene las respuestas para aprobarlas en lugar de publicarlas.POST /<THREADS_REPLY_ID>/manage_replyoculta o vuelve a mostrar una respuesta de primer nivel y todo lo que cuelga de ella.POST /<THREADS_REPLY_ID>/manage_pending_replyaprueba o rechaza una que esté esperando en la cola, yGET /<threads-media-id>/pending_replieslos lista.
Si estás construyendo cualquier tipo de respuesta automática, lee esa lista dos veces. Poder retener respuestas para aprobarlas es lo que hace que una cuenta automatizada sea viable.
Rate limits: los números que dan forma a tu cola
Las tres son ventanas móviles de 24 horas, por perfil de Threads, según la introducción de la API:
| Operación | Límite por 24 horas |
|---|---|
| Posts publicados | 250 |
| Respuestas | 1,000 |
| Borrados | 100 |
| Búsquedas de ubicaciones | 500 |
Encima hay además una fórmula de volumen de llamadas: 4800 por el número de impresiones, con un mínimo de 10 impresiones. Un perfil recién creado y sin alcance se queda por tanto con un presupuesto de llamadas pequeño, lo que sorprende a quien hace pruebas con una cuenta vacía.
Puesto al lado de sus hermanos, consultado el mismo día: Instagram permite 100 posts publicados por API cada 24 horas, y Facebook Pages usa 4800 llamadas por el número de usuarios que interactúan. Threads es la más generosa de las tres en volumen de publicación. La tabla completa entre plataformas está en nuestro referencia de límites de peticiones de las APIs de redes sociales, y el panorama completo está en la guía de APIs de redes sociales 2026.
Insights: lo que puedes medir de verdad
Dos endpoints, ambos necesitan threads_manage_insights, según la documentación de insights.
Por post, GET /<threads-media-id>/insights devuelve views, likes, replies, reposts, quotes y shares.
Por cuenta, GET /<threads-user-id>/threads_insights devuelve views como serie temporal, y likes, replies, reposts, quotes, clicks, followers_count y follower_demographics como totales. Ten en cuenta que la métrica replies cuenta la métrica solo cuenta las respuestas de primer nivel, así que será más baja que la suma de las respuestas de cada publicación.
Un límite duro: el timestamp más antiguo que acepta la API es 1712991600, el 13 de abril de 2024. Cualquier rango que empiece antes se rechaza, así que un job de backfill tiene que acotar su fecha de inicio.
Novedades de la Threads API: qué hay en la documentación en septiembre de 2026
La Threads API salió en 2024 con publicación más lecturas básicas. Leyendo la documentación hoy, cuatro cosas van más allá de aquella primera versión: moderación de respuestas con aprobaciones pendientes, búsqueda por palabra clave, webhooks y etiquetado de ubicación con su propio scope threads_location_tagging y un tope de 500 búsquedas al día.
Para la mayoría de los proyectos, lo que más importa son los webhooks. Hacer polling GET /<threads-media-id>/pending_replies de forma programada consume tu presupuesto de llamadas según esa fórmula de impresiones; suscribirte no.
¿Necesitas una integración con Threads, o una capa por encima?
Siendo sinceros: si Threads es la única red que te importa, hazlo directo. Es la integración más barata de toda esta categoría. Sin review, dos endpoints para publicar, scopes granulares, documentación decente. Estarás publicando en una tarde.
El argumento a favor de una capa es el mismo de siempre: también quieres Instagram, LinkedIn, X, TikTok y YouTube, y no quieres seis almacenes de tokens, seis pipelines de medios y tres app reviews. PlugKit publica en Threads, con las mismas restricciones que fija Meta: solo texto hasta 500 caracteres, una imagen o un vídeo, o un carrusel de 2 a 20. La guía de publicación tiene el detalle plataforma por plataforma.
Para ver qué cambia una capa cuando quien llama es un agente, y no un cron, mira la guía de configuración de Hermes Agent y el hub /social-media-api/. PlugKit cuesta 29 $ al mes por 5 cuentas conectadas, cancela cuando quieras.
Preguntas frecuentes
¿Threads tiene una API oficial?
Sí. Meta lanzó la Threads API en 2024 y ahora cubre publicación, lectura de tus propias publicaciones y tu perfil, respuestas y moderación, insights, webhooks, búsqueda por palabras clave y etiquetado de ubicación. Funciona con graph.threads.com o graph.threads.net con tokens de acceso OAuth y scopes granulares.
¿Cuántos posts puedo publicar al día con la Threads API?
250 posts publicados en una ventana móvil de 24 horas, por perfil de Threads. Las respuestas tienen un presupuesto aparte de 1.000 por cada 24 horas y los borrados están limitados a 100. Un carrusel cuenta como un post, no como un post por imagen.
¿La Threads API es gratis?
Meta no cobra por las llamadas a la Threads API. El coste está en los límites: los topes de posts, respuestas y borrados de arriba, más un presupuesto de llamadas de 4800 por tu número de impresiones con un mínimo de 10 impresiones, así que un perfil sin audiencia se queda con un margen pequeño.
¿Necesito app review para publicar en Threads con la API?
No para tu propio perfil. Publicar necesita los scopes threads_basic y threads_content_publish, que puedes autorizar tú mismo. La revisión de la app entra en juego cuando tu app actúa en nombre de perfiles de otras personas, que es la misma regla que en el resto de la plataforma de Meta.
¿Puedo programar posts de Threads con la API?
En el lado de Meta, no. La API publica cuando llamas a threads_publish, así que tu propio scheduler guarda la cola y dispara en el minuto justo, o usas un servicio que la guarde por ti. Acuérdate de los 30 segundos de espera recomendados entre crear el contenedor y publicarlo.
Un solo plug para cada plataforma que toca tu agente
29 $ al mes por 5 cuentas conectadas, cancela cuando quieras. Todas las funciones en todos los planes.
Consigue tu clave de API →