Cómo cuenta las URL de una publicación el límite de enlaces de la Threads API

¿Qué es el límite de enlaces de la Threads API?

El límite de enlaces de la Threads API de Meta permite 5 URL únicas por publicación, y desde el 22 de diciembre de 2025 un contenedor multimedia con una sexta falla al crearse con el código de error THREADS_API__LINK_LIMIT_EXCEEDED. La regla aparece bajo Links en la guía de publicaciones de Threads de Meta como una viñeta de una línea, "The number of links is restricted to 5 or less," seguida de un recuadro de advertencia:

Starting December 22, 2025, Threads posts containing more than 5 links will fail to post during the media creation step (POST /{threads-user-id}/threads) with the error code: THREADS_API__LINK_LIMIT_EXCEEDED.

El changelog de Threads anunció el cambio el 8 de diciembre de 2025 y lo volvió a registrar el 22 de diciembre de 2025 con la misma frase: "Threads posts with more than 5 links will fail to post with the error THREADS_API__LINK_LIMIT_EXCEEDED."

Es el único límite de publicación en la documentación de Threads con su propia cadena de error. El tope de 500 caracteres de text no tiene ninguna, como se explica en cómo trata el límite de 500 caracteres de la Threads API las etiquetas de tema.

¿Cómo cuenta Meta los enlaces de una publicación de Threads?

Meta cuenta las URL únicas del campo text y del parámetro link_attachment en conjunto. La guía de publicaciones da tres reglas:

1. "All unique URLs found in the text field are counted as links."
2. "If the link_attachment field contains a URL that is different from all URLs in the text field, it is counted as an additional link."
3. "If the link_attachment URL is the same as any URL in the text field, it is only counted once, rather than twice."

Después, Meta desarrolla tres ejemplos, reproducidos aquí tal como están escritos:

La tercera fila es la útil. Cuatro menciones de URL dan un recuento de 2, porque las repeticiones se agrupan y el adjunto coincide con una URL que ya está en el texto. Lo inverso es lo que pilla a la gente: seis URL distintas en una lista de "recursos" fallan aunque la publicación parezca corta.

¿Qué considera Meta una URL?

Los ejemplos de Meta usan dominios sin más, como www.facebook.com, sin https:// delante. Así que el contador no espera a ver un esquema para contar algo como enlace, y un dominio escrito en texto normal suma al total.

Más allá de eso, Meta no dice nada. La guía de publicaciones no aclara si http://example.com y https://example.com son una URL o dos, si una barra final o una query string crean una URL nueva, o si un dominio sin www coincide con uno que lo lleva. Los ejemplos solo repiten una URL carácter por carácter. Hasta que Meta documente la normalización, cuenta como dos enlaces cualquier par de cadenas que difieran, y escribe la misma URL de forma idéntica en todos los sitios donde aparezca dentro de una publicación.

¿En qué punto del flujo de publicación aparece el error?

En la creación del contenedor, que es el primer paso. Publicar en Threads requiere dos llamadas: POST /{threads-user-id}/threads crea un contenedor multimedia, y POST /{threads-user-id}/threads_publish lo convierte en una publicación visible. Meta señala la primera llamada como el punto de fallo.

Esa ubicación tiene dos consecuencias. La publicación nunca llega al paso de publicar, así que nunca toca la cuota de 250 publicaciones, que Meta aplica en threads_publish. El funcionamiento de esa cuota está en el límite de 250 publicaciones al día de la Threads API. Y no se devuelve ningún ID de contenedor, así que no hay nada que consultar. Los valores de estado de contenedor de la página de solución de problemas, como EXPIRED y ERROR, solo se aplican a contenedores que existen, y su lista de mensajes de error solo cubre el procesamiento de vídeo y audio.

Meta documenta el error como una cadena de código. No documenta el estado HTTP ni un código de error numérico que lo acompañe, así que compara con THREADS_API__LINK_LIMIT_EXCEEDED en la respuesta y no con un número.

¿El límite se aplica a publicaciones con imagen, vídeo y carrusel?

La redacción de Meta lo deja abierto. La lista de Limitations bajo Links empieza con "This feature is only available for text-only posts. It will not work with image, video, or carousel posts," y la viñeta de los 5 enlaces es la siguiente línea de esa misma lista. La primera viñeta describe link_attachment, que la tabla de parámetros también restringe: "Can only be used for media_type=TEXT posts."

El propio recuadro de advertencia dice "Threads posts containing more than 5 links," sin indicar tipo de contenido, y una publicación con imagen o vídeo puede seguir llevando URL en su text. Meta no da ningún ejemplo para ese caso. La lectura segura es que 5 URL únicas son el máximo para cualquier tipo de publicación, ya que nada en la documentación dice que el texto de una publicación con imagen esté exento.

¿Cómo cambian el recuento los adjuntos de texto?

Los adjuntos de texto traen su propia copia de la regla. La página Text Attachments, que cubre textos largos "with up to 10,000 characters and a link," repite la viñeta de los 5 enlaces, la advertencia del 22 de diciembre de 2025 y los mismos tres ejemplos, con link_attachment_url dentro del objeto text_attachment en lugar de link_attachment.

Añade una restricción: "If there is already a link attachment in the main post, a link attachment cannot be added in the text attachment." Así que una publicación tiene como máximo un enlace adjunto, en un sitio o en el otro.

El hueco es el campo plaintext. Puede contener hasta 10,000 caracteres, y las reglas de recuento de Meta solo nombran las URL "found in the text field" y la URL del adjunto. Nunca mencionan las URL escritas dentro de plaintext. Meta no dice que estén exentas, y tampoco dice que cuenten. Mantén el total de URL únicas entre text, plaintext y el adjunto en 5 o menos y la pregunta nunca se plantea.

¿Cómo se soluciona THREADS_API__LINK_LIMIT_EXCEEDED?

La instrucción de la propia Meta es una línea: "If you receive this error, reduce the number of unique links in your post to 5 or less." En la práctica, eso significa contar antes de llamar a la API:

1. Extrae todas las URL y dominios sueltos de text, más link_attachment o text_attachment.link_attachment_url.
2. Agrupa los duplicados exactos.
3. Si quedan más de 5, quita enlaces o muévelos a una respuesta, que se crea como una publicación aparte a través del mismo endpoint con reply_to_id y por tanto tiene su propio recuento.

Un programador de publicaciones debería hacer esa comprobación cuando se escribe la publicación, no cuando se dispara, porque un fallo a las 03:00 es un hueco perdido. Lo mismo vale para el recuento de caracteres y la cuota diaria. Para mantener limpia una cola, consulta cómo programar publicaciones en Threads. El límite es de Threads, así que cualquier herramienta para programar en Threads trabaja dentro de los mismos 5.

Preguntas frecuentes

¿Qué significa THREADS_API__LINK_LIMIT_EXCEEDED?

Significa que la publicación contenía más de 5 enlaces únicos. Desde el 22 de diciembre de 2025, Meta rechaza esas publicaciones durante el paso de creación del contenido, POST /{threads-user-id}/threads, y devuelve este código de error en lugar de un ID de contenedor.

¿El mismo enlace dos veces cuenta como dos enlaces?

No. Meta cuenta "All unique URLs found in the text field," así que una URL repetida en text cuenta una vez. Un link_attachment que coincide con una URL que ya está en text "is only counted once, rather than twice."

¿link_attachment cuenta para el límite de 5 enlaces?

Solo cuando añade una URL nueva. Meta afirma que un link_attachment distinto de todas las URL de text "is counted as an additional link," mientras que uno que coincide con una URL de text no suma nada al recuento.

¿Cuándo empezó Threads a aplicar el límite de enlaces?

El 22 de diciembre de 2025. Meta lo anunció en el changelog de Threads el 8 de diciembre de 2025, y la advertencia de la guía de publicaciones empieza con "Starting December 22, 2025."

¿Una publicación rechazada por el límite de enlaces consume la cuota diaria de 250 publicaciones?

Meta aplica el límite de 250 publicaciones en POST /{threads-user-id}/threads_publish, y el error del límite de enlaces llega antes, en la creación del contenedor. Una publicación rechazada por tener demasiados enlaces nunca llega a la llamada de publicación.

¿Puedo compartir más de 5 enlaces en un hilo de Threads?

Meta cuenta los enlaces por publicación. Una respuesta es una publicación aparte, creada a través del mismo endpoint de contenedores con reply_to_id, así que repartir los enlaces entre una publicación y sus respuestas mantiene cada una por debajo del límite. Meta no documenta ningún tope combinado para un hilo.

¿Cuántos enlaces puede tener una publicación de Threads?

Una publicación de Threads admite 5 URL únicas. La guía de publicaciones de Meta dice "The number of links is restricted to 5 or less", y un sexto enlace falla al crear el contenedor con THREADS_API__LINK_LIMIT_EXCEEDED. Una URL repetida en la publicación cuenta una vez.

¿Un dominio sin https:// cuenta como enlace?

Los ejemplos de Meta usan dominios sin esquema, como www.facebook.com, y los cuentan como enlaces. El contador no espera a un esquema. Un dominio escrito en el texto suma al total.

¿Las versiones http y https de la misma URL son un enlace o dos?

Meta no lo indica. La guía solo repite las URL carácter por carácter, así que trata dos cadenas distintas como dos enlaces. Escribe la misma URL de forma idéntica en todas partes.

¿Las URL del plaintext de un adjunto de texto cuentan para el límite?

Meta no lo indica. Sus reglas de recuento nombran las URL del campo text y la URL del adjunto, y nunca mencionan plaintext. Mantén el total de URL únicas entre text, plaintext y el adjunto en 5 o menos.