Comment la limite de liens de l'API Threads compte les URL d'un post

Qu'est-ce que la limite de liens de l'API Threads ?

Chez Meta, la limite de liens de l'API Threads autorise 5 URL uniques par post, et depuis le 22 décembre 2025, un conteneur média qui en contient une sixième échoue à la création avec le code d'erreur THREADS_API__LINK_LIMIT_EXCEEDED. La règle figure sous Links dans le guide des posts Threads de Meta, sous la forme d'une puce d'une ligne, « The number of links is restricted to 5 or less », suivie d'un encadré d'avertissement :

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.

Le changelog de Threads a annoncé le changement le 8 décembre 2025 et l'a consigné de nouveau le 22 décembre 2025 avec la même phrase : « Threads posts with more than 5 links will fail to post with the error THREADS_API__LINK_LIMIT_EXCEEDED. »

C'est la seule limite de post de la documentation Threads qui ait sa propre chaîne d'erreur. Le plafond de 500 caractères sur text n'en a aucune, comme l'explique la page sur la façon dont la limite de 500 caractères de l'API Threads traite les tags de sujet.

Comment Meta compte-t-elle les liens dans un post Threads ?

Meta compte les URL uniques du champ text et du paramètre link_attachment pris ensemble. Le guide des posts donne trois règles :

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

Meta détaille ensuite trois exemples, reproduits ici tels quels :

La troisième ligne est la plus utile. Quatre mentions d'URL donnent un décompte de 2, parce que les répétitions fusionnent et que la pièce jointe correspond à une URL déjà présente dans le texte. L'inverse est ce qui piège les gens : six URL différentes dans une liste de « ressources » échouent même quand le post paraît court.

Qu'est-ce que Meta considère comme une URL ?

Les exemples de Meta utilisent des domaines nus comme www.facebook.com, sans https:// devant. Le compteur n'attend donc pas de schéma pour considérer quelque chose comme un lien, et un domaine tapé dans le texte courant augmente le total.

Au-delà, Meta se tait. Le guide des posts ne dit pas si http://example.com et https://example.com sont une seule URL ou deux, si une barre oblique finale ou une chaîne de requête crée une nouvelle URL, ni si un domaine sans www correspond au même domaine avec. Les exemples ne répètent jamais une URL qu'à l'identique, caractère pour caractère. Tant que Meta ne documente pas la normalisation, comptez deux chaînes différentes comme deux liens, et écrivez la même URL de façon identique partout où elle apparaît dans un post.

À quel moment du flux de publication l'erreur apparaît-elle ?

À la création du conteneur, c'est-à-dire à la première étape. Publier sur Threads demande deux appels : POST /{threads-user-id}/threads crée un conteneur média, et POST /{threads-user-id}/threads_publish le transforme en post en ligne. Meta désigne le premier appel comme le point d'échec.

Cet emplacement a deux conséquences. Le post n'atteint jamais l'étape de publication, donc il ne touche jamais au quota de 250 posts, que Meta applique sur threads_publish. Le fonctionnement de ce quota est expliqué dans la limite de 250 posts par jour de l'API Threads. Et aucun ID de conteneur ne revient, donc il n'y a rien à interroger. Les valeurs de statut de conteneur de la page de dépannage, comme EXPIRED et ERROR, ne s'appliquent qu'aux conteneurs qui existent, et sa liste de messages d'erreur ne couvre que le traitement vidéo et audio.

Meta documente l'erreur sous forme de chaîne de code. Elle ne documente ni le statut HTTP ni un code d'erreur numérique qui l'accompagnerait, donc cherchez THREADS_API__LINK_LIMIT_EXCEEDED dans la réponse plutôt qu'un nombre.

La limite s'applique-t-elle aux posts image, vidéo et carrousel ?

La formulation de Meta laisse la question ouverte. La liste Limitations sous Links commence par « This feature is only available for text-only posts. It will not work with image, video, or carousel posts », et la puce sur les 5 liens est la ligne suivante de la même liste. La première puce décrit link_attachment, que le tableau des paramètres restreint aussi : « Can only be used for media_type=TEXT posts. »

L'encadré d'avertissement lui-même dit « Threads posts containing more than 5 links », sans type de média associé, et un post image ou vidéo peut toujours contenir des URL dans son text. Meta ne donne aucun exemple pour ce cas. La lecture prudente est que 5 URL uniques constituent le plafond pour tout type de post, puisque rien dans la documentation ne dit qu'une légende de post image en est exemptée.

Comment les pièces jointes texte modifient-elles le décompte ?

Les pièces jointes texte apportent leur propre copie de la règle. La page Text Attachments, qui couvre les textes longs « with up to 10,000 characters and a link », reprend la puce sur les 5 liens, l'avertissement du 22 décembre 2025 et les trois mêmes exemples, avec link_attachment_url dans l'objet text_attachment à la place de link_attachment.

Elle ajoute une restriction : « If there is already a link attachment in the main post, a link attachment cannot be added in the text attachment. » Un post a donc au plus un lien en pièce jointe, à un endroit ou à l'autre.

Le trou se situe dans le champ plaintext. Il peut contenir jusqu'à 10,000 caractères, et les règles de décompte de Meta ne nomment que les URL « found in the text field » et l'URL de la pièce jointe. Elles ne mentionnent jamais les URL écrites dans plaintext. Meta ne dit pas qu'elles sont exemptées, et elle ne dit pas qu'elles comptent. Gardez le total d'URL uniques entre text, plaintext et la pièce jointe à 5 ou moins, et la question ne se pose jamais.

Comment corriger THREADS_API__LINK_LIMIT_EXCEEDED ?

La consigne de Meta tient en une ligne : « If you receive this error, reduce the number of unique links in your post to 5 or less. » En pratique, cela veut dire compter avant d'appeler l'API :

1. Extraire chaque URL et chaque domaine nu de text, plus link_attachment ou text_attachment.link_attachment_url.
2. Fusionner les doublons exacts.
3. S'il en reste plus de 5, supprimer des liens ou les déplacer dans une réponse, qui est créée comme un post distinct via le même endpoint avec reply_to_id et porte donc son propre décompte.

Un outil de programmation doit faire cette vérification au moment où le post est rédigé, pas au moment où il part, car un échec à 03:00 est un créneau perdu. Il en va de même pour le nombre de caractères et le quota quotidien. Pour garder une file d'attente propre, voyez comment programmer des posts Threads. La limite appartient à Threads, donc chaque outil de programmation Threads travaille avec les mêmes 5.

Questions fréquentes

Que signifie THREADS_API__LINK_LIMIT_EXCEEDED ?

Cela signifie que le post contenait plus de 5 liens uniques. Depuis le 22 décembre 2025, Meta rejette ces posts pendant l'étape de création du média, POST /{threads-user-id}/threads, et renvoie ce code d'erreur au lieu d'un ID de conteneur.

Le même lien deux fois compte-t-il comme deux liens ?

Non. Meta compte « All unique URLs found in the text field », donc une URL répétée dans text compte une fois. Un link_attachment identique à une URL déjà présente dans text « is only counted once, rather than twice. »

link_attachment compte-t-il dans la limite de 5 liens ?

Seulement quand il ajoute une nouvelle URL. Meta indique qu'un link_attachment différent de toutes les URL de text « is counted as an additional link », tandis qu'un link_attachment identique à une URL de text n'ajoute rien au décompte.

Quand Threads a-t-il commencé à appliquer la limite de liens ?

Le 22 décembre 2025. Meta l'a annoncé dans le changelog de Threads le 8 décembre 2025, et l'avertissement du guide des posts commence par « Starting December 22, 2025. »

Un post rejeté pour la limite de liens consomme-t-il le quota quotidien de 250 posts ?

Meta applique la limite de 250 posts sur POST /{threads-user-id}/threads_publish, et l'erreur de limite de liens arrive plus tôt, à la création du conteneur. Un post rejeté pour trop de liens n'atteint jamais l'appel de publication.

Puis-je partager plus de 5 liens dans un fil Threads ?

Meta compte les liens par post. Une réponse est un post distinct, créé via le même endpoint de conteneur avec reply_to_id, donc répartir les liens entre un post et ses réponses maintient chacun sous la limite. Meta ne documente aucun plafond cumulé sur un fil.

Combien de liens un post Threads peut-il contenir ?

Un post Threads accepte 5 URL uniques. Le guide des posts de Meta indique « The number of links is restricted to 5 or less », et un sixième lien échoue à la création du conteneur avec THREADS_API__LINK_LIMIT_EXCEEDED. Une URL répétée dans le post compte une seule fois.

Un domaine sans https:// compte-t-il comme un lien ?

Les exemples de Meta utilisent des domaines nus comme www.facebook.com et les comptent comme des liens. Le compteur n'attend donc pas de schéma. Un domaine écrit dans le texte s'ajoute au total.

Les versions http et https d'une même URL comptent-elles pour un lien ou deux ?

Meta ne le précise pas. Le guide ne répète les URL que caractère pour caractère, donc considérez deux chaînes différentes comme deux liens. Écrivez la même URL de façon identique partout.

Les URL du plaintext d'une pièce jointe texte comptent-elles dans la limite ?

Meta ne le précise pas. Ses règles de décompte citent les URL du champ text et l'URL de la pièce jointe, jamais plaintext. Gardez le total d'URL uniques entre text, plaintext et la pièce jointe à 5 ou moins.