API de Threads: publicar y leer con la API oficial
Sí, Threads tiene una API oficial, y es la más amigable que ofrece Meta. Publicas en dos llamadas, puedes leer tus publicaciones, respuestas y estadísticas, y para tu propio perfil no hay revisión de la app. El tope es de 250 publicaciones y 1.000 respuestas 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 descripción general de la API de Threads, la API cubre cuatro tareas: crear y publicar contenido en nombre de un usuario, mostrar las publicaciones de ese usuario dentro de tu aplicación, gestionar respuestas y eliminar publicaciones. El índice de la documentación también incluye perfiles, menciones, estadísticas, webhooks, búsqueda por palabras clave y etiquetado de ubicación.
Las llamadas van a graph.threads.com o graph.threads.net, con un token de acceso. Los permisos son granulares, así que pide solo los 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
El mismo esquema que Instagram. Crea un contenedor de medios y luego publícalo, tal y 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 el contenido multimedia. Las publicaciones de texto están limitadas a 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 se pueden mezclar imágenes y vídeos. Un carrusel cuenta como una sola publicación en tu límite de frecuencia.
Las respuestas usan los mismos endpoints de publicación con un reply_to_id, y tienen su propio presupuesto, independiente del de las publicaciones.
La moderación es donde la API de Threads va realmente 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 su aprobación 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 respuesta en espera en la cola, yGET /<threads-media-id>/pending_replieslas 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 junto a sus hermanas, comprobadas el mismo día: Instagram permite 100 publicaciones por API cada 24 horas, y Facebook Pages usa 4800 llamadas multiplicadas 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 nuestra referencia de límites de frecuencia de las APIs de redes sociales, y el panorama general, en la guía de APIs de redes sociales de 2026.
Insights: lo que puedes medir de verdad
Dos endpoints, ambos requieren threads_manage_insights, según la documentación de estadísticas.
Por publicación, 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 luego likes, replies, reposts, quotes, clicks, followers_count y follower_demographics como totales. Ten en cuenta que la métrica de cuenta replies solo cuenta las respuestas de primer nivel, así que dará un número más bajo que la suma de los recuentos de respuestas por publicación.
Un límite duro: la marca de tiempo más antigua que acepta la API es 1712991600, el 13 de abril de 2024. Se rechaza cualquier rango que empiece antes, así que un trabajo 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 API de Threads salió en 2024 con publicación más lecturas básicas. Leyendo la documentación de hoy, hay cuatro cosas que van más allá de aquella primera versión: moderación de respuestas con aprobaciones pendientes, búsqueda por palabras clave, webhooks y etiquetado de ubicación con su propio permiso threads_location_tagging y un tope de 500 búsquedas al día.
Para la mayoría de proyectos, lo que más importa son los webhooks. Consultar GET /<threads-media-id>/pending_replies de forma periódica te quema el presupuesto de llamadas contra 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 que en todas partes: también quieres Instagram, LinkedIn, X, TikTok y YouTube, y no quieres seis almacenes de tokens, seis pipelines de medios y tres revisiones de app. PlugKit publica en Threads, con las mismas restricciones que impone 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, consulta la guía de configuración de Hermes Agent y el hub /social-media-api/. PlugKit cuesta $49 al mes para 5 cuentas conectadas, y puedes cancelar cuando quieras.
Preguntas frecuentes
¿Threads tiene una API oficial?
Sí. Meta lanzó la API de Threads en 2024 y ahora cubre publicación, lectura de tus propias publicaciones y perfil, respuestas y moderación, estadísticas, webhooks, búsqueda por palabras clave y etiquetado de ubicación. Funciona en graph.threads.com o graph.threads.net con tokens de acceso OAuth y permisos 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?
Para tu propio perfil, no. Publicar requiere los permisos threads_basic y threads_content_publish, que puedes autorizarte a ti mismo. La revisión de la app entra en juego cuando tu aplicación actúa en nombre de los 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?
Por parte de Meta, no. La API publica cuando llamas a threads_publish, así que tu propio programador mantiene la cola y la dispara en el minuto correcto, o usas un servicio que la mantenga por ti. Recuerda la espera recomendada de 30 segundos entre crear el contenedor y publicarlo.
Un solo plug para cada plataforma que toca tu agente
49 $ al mes por 5 cuentas conectadas, cancela cuando quieras. Todas las funciones en todos los planes.
Consigue tu clave de API →