Come il limite di link dell'API Threads conta gli URL in un post

Qual è il limite di link dell'API di Threads?

Il limite di link dell'API di Threads consente 5 URL unici per post. Dal 22 dicembre 2025 un contenitore multimediale con un sesto URL fallisce già alla creazione, con il codice di errore THREADS_API__LINK_LIMIT_EXCEEDED. La regola si trova sotto "Links" nella guida ai post di Threads di Meta, come punto elenco di una riga, "Il numero di link è limitato a 5 o meno", seguito da un riquadro di avviso:

A partire dal 22 dicembre 2025, i post di Threads che contengono più di 5 link non verranno pubblicati e falliranno durante la fase di creazione del contenuto multimediale (POST /{threads-user-id}/threads) con il codice di errore: THREADS_API__LINK_LIMIT_EXCEEDED.

Il changelog di Threads ha annunciato la modifica l'8 dicembre 2025 e l'ha registrata di nuovo il 22 dicembre 2025 con la stessa frase: "I post di Threads con più di 5 link non verranno pubblicati e restituiranno l'errore THREADS_API__LINK_LIMIT_EXCEEDED."

È l'unico limite sui post, nella documentazione di Threads, ad avere una propria stringa di errore. Il tetto di 500 caratteri per text non ne ha una, come spiegato in come il limite di 500 caratteri dell'API di Threads tratta i tag argomento.

Come conta i link Meta in un post di Threads?

Meta conta gli URL unici nel campo text e nel parametro link_attachment insieme. La guida ai post indica tre regole:

1. "Tutti gli URL unici presenti nel campo text vengono conteggiati come link."
2. "Se il campo link_attachment contiene un URL diverso da tutti quelli presenti nel campo text, viene conteggiato come link aggiuntivo."
3. "Se l'URL di link_attachment è uguale a uno qualsiasi degli URL nel campo text, viene conteggiato una sola volta, non due."

Meta propone poi tre esempi, che riportiamo così come sono scritti:

La terza riga è la più utile. Quattro menzioni di URL danno un conteggio di 2, perché le ripetizioni si fondono e l'allegato coincide con un URL già presente nel testo. Il caso opposto è quello che frega molti: sei URL diversi in un elenco di "risorse" fanno fallire il post, anche se sembra breve.

Cosa considera un URL Meta?

Gli esempi di Meta usano domini senza protocollo, come www.facebook.com, senza https:// davanti. Il contatore quindi non aspetta uno schema per considerare qualcosa un link, e un dominio scritto in mezzo al testo aumenta il totale.

Oltre a questo, Meta non dice nulla. La guida ai post non chiarisce se http://example.com e https://example.com siano un solo URL o due, se una barra finale o una query string creino un nuovo URL, o se un dominio senza www corrisponda a uno con www. Gli esempi ripetono sempre un URL carattere per carattere. Finché Meta non documenta la normalizzazione, conta come due link due stringhe qualsiasi che differiscono, e scrivi lo stesso URL in modo identico ovunque compaia in un post.

In quale punto del flusso di pubblicazione compare l'errore?

Alla creazione del contenitore, cioè nel primo passaggio. La pubblicazione su Threads richiede due chiamate. POST /{threads-user-id}/threads crea un contenitore multimediale, e POST /{threads-user-id}/threads_publish lo trasforma in un post pubblico. Meta indica la prima chiamata come punto di errore.

Questa collocazione ha due conseguenze. Il post non arriva mai alla fase di pubblicazione, quindi non intacca la quota di 250 post che Meta applica su threads_publish. Come funziona quella quota è spiegato nel limite di 250 post al giorno dell'API di Threads. Inoltre non torna alcun ID del contenitore, quindi non c'è nulla da interrogare. I valori di stato del contenitore nella pagina di risoluzione dei problemi, come EXPIRED ed ERROR, valgono solo per i contenitori che esistono, e il suo elenco di messaggi di errore riguarda soltanto l'elaborazione di video e audio.

Meta documenta l'errore come stringa di codice. Non documenta lo stato HTTP né un codice di errore numerico che lo accompagni, quindi cerca THREADS_API__LINK_LIMIT_EXCEEDED nella risposta invece di basarti su un numero.

Il limite vale anche per i post con immagini, video e caroselli?

La formulazione di Meta lascia la questione aperta. L'elenco delle limitazioni sotto "Links" si apre con "Questa funzione è disponibile solo per i post di solo testo. Non funziona con post con immagini, video o caroselli", e il punto sui 5 link è la riga successiva dello stesso elenco. Il primo punto descrive link_attachment, che anche la tabella dei parametri restringe: "Può essere usato solo per post con media_type=TEXT."

Il riquadro di avviso dice invece "i post di Threads che contengono più di 5 link", senza alcun tipo di contenuto associato, e un post con immagine o video può comunque portare URL nel proprio text. Meta non fornisce alcun esempio per questo caso. La lettura più prudente è che 5 URL unici siano il tetto per qualsiasi tipo di post, dato che nulla nella documentazione dice che la didascalia di un post con immagine sia esente.

Come cambiano il conteggio gli allegati di testo?

Gli allegati di testo hanno la propria copia della regola. La pagina Text Attachments, che riguarda la scrittura lunga "fino a 10.000 caratteri e un link", ripete il punto sui 5 link, l'avviso del 22 dicembre 2025 e gli stessi tre esempi, con link_attachment_url dentro l'oggetto text_attachment al posto di link_attachment.

Aggiunge una restrizione: "Se nel post principale c'è già un allegato link, non è possibile aggiungerne uno nell'allegato di testo." Quindi un post ha al massimo un link allegato, in un posto o nell'altro.

La lacuna è il campo plaintext. Può contenere fino a 10.000 caratteri, e le regole di conteggio di Meta citano solo gli URL "presenti nel campo text" e l'URL dell'allegato. Non menzionano mai gli URL scritti dentro plaintext. Meta non dice che siano esenti, e non dice che contino. Se tieni il totale degli URL unici tra text, plaintext e allegato a 5 o meno, la domanda non si pone nemmeno.

Come si risolve THREADS_API__LINK_LIMIT_EXCEEDED?

L'istruzione di Meta è una sola riga: "Se ricevi questo errore, riduci a 5 o meno il numero di link univoci nel tuo post." In pratica significa contare prima di chiamare l'API:

1. Estrai ogni URL e ogni dominio senza schema da text, più link_attachment o text_attachment.link_attachment_url.
2. Elimina i duplicati esatti.
3. Se ne restano più di 5, togli dei link oppure spostali in una risposta. La risposta viene creata come post separato tramite lo stesso endpoint con reply_to_id, quindi ha un conteggio tutto suo.

Uno scheduler dovrebbe fare questo controllo quando scrivi il post, non quando parte, perché un errore alle 03:00 è uno slot perso. Lo stesso vale per il numero di caratteri e per la quota giornaliera. Per tenere in ordine la coda, leggi come programmare i post su Threads. Il limite è di Threads, quindi ogni strumento di programmazione per Threads lavora dentro gli stessi 5 link.

Domande frequenti

Cosa significa THREADS_API__LINK_LIMIT_EXCEEDED?

Significa che il post conteneva più di 5 link univoci. Dal 22 dicembre 2025 Meta rifiuta questi post nella fase di creazione del media, POST /{threads-user-id}/threads, e restituisce questo codice di errore al posto dell'ID del container.

Lo stesso link scritto due volte conta come due link?

No. Meta conta "Tutti gli URL univoci trovati nel campo text", quindi un URL ripetuto in text conta una volta sola. Un link_attachment uguale a un URL già presente in text "viene conteggiato una sola volta, non due".

Il link_attachment conta nel limite di 5 link?

Solo quando aggiunge un URL nuovo. Meta spiega che un link_attachment diverso da tutti gli URL in text "viene conteggiato come link aggiuntivo", mentre uno uguale a un URL di text non cambia il totale.

Da quando Threads applica il limite sui link?

Dal 22 dicembre 2025. Meta lo ha annunciato nel changelog di Threads l'8 dicembre 2025, e l'avviso nella guida ai post inizia con "A partire dal 22 dicembre 2025".

Un post respinto per il limite dei link consuma la quota giornaliera di 250 post?

Meta applica il limite di 250 post su POST /{threads-user-id}/threads_publish, mentre l'errore sui link arriva prima, alla creazione del container. Un post rifiutato per troppi link non arriva mai alla chiamata di pubblicazione.

Posso condividere più di 5 link in un thread su Threads?

Meta conta i link per singolo post. Una risposta è un post separato, creato con lo stesso endpoint dei container e reply_to_id, quindi distribuire i link tra un post e le sue risposte tiene ciascuno sotto il limite. Meta non documenta alcun tetto complessivo per l'intero thread.

Quanti link può avere un post su Threads?

Un post su Threads può avere 5 URL univoci. La guida ai post di Meta dice "Il numero di link è limitato a 5 o meno", e un sesto link fa fallire la creazione del container con THREADS_API__LINK_LIMIT_EXCEEDED. Un URL ripetuto nel post conta una volta.

Un dominio senza https:// conta come link?

Gli esempi di Meta usano domini senza schema, come www.facebook.com, e li contano come link. Quindi il conteggio non aspetta lo schema. Un dominio scritto nel testo normale si somma al totale.

Le versioni http e https dello stesso URL sono un link o due?

Meta non lo dice. La guida ai post ripete solo gli URL carattere per carattere, quindi considera due stringhe diverse come due link. Scrivi lo stesso URL in modo identico ovunque compaia.

Gli URL nel testo semplice di un allegato di testo contano nel limite?

Meta non lo dice. Le sue regole di conteggio citano gli URL nel campo text e l'URL dell'allegato, e non nominano mai il testo semplice. Tieni il totale degli URL univoci tra text, testo semplice e allegato a 5 o meno.