Wie das Link-Limit der Threads API URLs in einem Beitrag zählt

Was ist das Link-Limit der Threads API?

Metas Link-Limit der Threads API erlaubt 5 eindeutige URLs pro Beitrag, und seit dem 22. Dezember 2025 scheitert ein Media-Container mit einer sechsten schon bei der Erstellung, mit dem Fehlercode THREADS_API__LINK_LIMIT_EXCEEDED. Die Regel steht im Abschnitt Links von Metas Leitfaden zu Threads-Beiträgen als einzeiliger Aufzählungspunkt, „The number of links is restricted to 5 or less,“ gefolgt von einem Warnkasten:

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.

Der Threads-Changelog hat die Änderung am 8. Dezember 2025 angekündigt und sie am 22. Dezember 2025 erneut mit demselben Satz vermerkt: „Threads posts with more than 5 links will fail to post with the error THREADS_API__LINK_LIMIT_EXCEEDED.“

Das ist das einzige Beitragslimit in der Threads-Dokumentation mit eigenem Fehlerstring. Die Obergrenze von 500 Zeichen für text hat keinen, wie der Beitrag dazu zeigt, wie das 500-Zeichen-Limit der Threads API Topic-Tags behandelt.

Wie zählt Meta Links in einem Threads-Beitrag?

Meta zählt eindeutige URLs im Feld text und im Parameter link_attachment zusammen. Der Leitfaden zu Beiträgen nennt drei Regeln:

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

Danach rechnet Meta drei Beispiele durch, hier so wiedergegeben, wie sie dort stehen:

Die dritte Zeile ist die nützliche. Vier Erwähnungen von URLs ergeben eine Zählung von 2, weil Wiederholungen zusammenfallen und der Anhang einer URL entspricht, die schon im Text steht. Das Umgekehrte erwischt die Leute: Sechs verschiedene URLs in einer Liste von „Ressourcen“ scheitern, auch wenn der Beitrag kurz wirkt.

Was behandelt Meta als URL?

Metas Beispiele verwenden reine Domains wie www.facebook.com, ohne https:// davor. Der Zähler wartet also nicht auf ein Schema, bevor er etwas als Link zählt, und eine Domain, die im Fließtext steht, erhöht die Summe.

Darüber hinaus schweigt Meta. Der Leitfaden zu Beiträgen sagt nicht, ob http://example.com und https://example.com eine URL oder zwei sind, ob ein abschließender Schrägstrich oder ein Query-String eine neue URL ergibt, oder ob eine Domain ohne www einer mit www entspricht. Die Beispiele wiederholen eine URL immer nur Zeichen für Zeichen. Solange Meta keine Normalisierung dokumentiert, zähl zwei Strings, die sich unterscheiden, als zwei Links, und schreib dieselbe URL überall im Beitrag identisch.

An welcher Stelle im Veröffentlichungsablauf erscheint der Fehler?

Bei der Container-Erstellung, also in Schritt eins. Die Veröffentlichung auf Threads braucht zwei Aufrufe: POST /{threads-user-id}/threads erstellt einen Media-Container, und POST /{threads-user-id}/threads_publish macht daraus einen Live-Beitrag. Meta nennt den ersten Aufruf als Stelle, an der es scheitert.

Diese Platzierung hat zwei Folgen. Der Beitrag erreicht den Veröffentlichungsschritt nie, also berührt er auch nie das Kontingent von 250 Beiträgen, das Meta auf threads_publish durchsetzt. Wie dieses Kontingent funktioniert, steht im Beitrag zum Limit der Threads API von 250 Beiträgen pro Tag. Und es kommt keine Container-ID zurück, also gibt es nichts abzufragen. Die Container-Statuswerte der Fehlerbehebungsseite, etwa EXPIRED und ERROR, gelten nur für Container, die existieren, und ihre Liste von Fehlermeldungen deckt nur die Verarbeitung von Video und Audio ab.

Meta dokumentiert den Fehler als Code-String. Den HTTP-Status oder einen numerischen Fehlercode dazu dokumentiert Meta nicht, also prüfe die Antwort auf THREADS_API__LINK_LIMIT_EXCEEDED statt auf eine Zahl.

Gilt das Limit für Bild-, Video- und Karussell-Beiträge?

Metas Wortlaut lässt das offen. Die Liste Limitations unter Links beginnt mit „This feature is only available for text-only posts. It will not work with image, video, or carousel posts,“ und der Punkt zu den 5 Links ist die nächste Zeile in derselben Liste. Der erste Punkt beschreibt link_attachment, das auch die Parametertabelle einschränkt: „Can only be used for media_type=TEXT posts.“

Der Warnkasten selbst sagt „Threads posts containing more than 5 links,“ ohne Medientyp, und ein Bild- oder Video-Beitrag kann trotzdem URLs in seinem text enthalten. Für diesen Fall gibt Meta kein Beispiel. Die sichere Lesart ist, dass 5 eindeutige URLs die Obergrenze für jeden Beitragstyp sind, denn nichts in der Dokumentation sagt, dass eine Bildunterschrift bei einem Bild-Beitrag ausgenommen ist.

Wie verändern Text-Anhänge die Zählung?

Text-Anhänge bringen ihre eigene Kopie der Regel mit. Die Seite Text Attachments, die längere Texte „with up to 10,000 characters and a link“ behandelt, wiederholt den Punkt zu den 5 Links, die Warnung zum 22. Dezember 2025 und dieselben drei Beispiele, wobei link_attachment_url im Objekt text_attachment an die Stelle von link_attachment tritt.

Sie ergänzt eine Einschränkung: „If there is already a link attachment in the main post, a link attachment cannot be added in the text attachment.“ Ein Beitrag hat also höchstens einen Anhang-Link, an der einen Stelle oder an der anderen.

Die Lücke ist das Feld plaintext. Es fasst bis zu 10,000 Zeichen, und Metas Zählregeln nennen nur URLs, die „found in the text field“ sind, und die Anhang-URL. URLs, die in plaintext stehen, erwähnen sie nie. Meta sagt nicht, dass sie ausgenommen sind, und sagt auch nicht, dass sie zählen. Halten Sie die eindeutige Summe über text, plaintext und den Anhang bei 5 oder weniger, dann stellt sich die Frage nie.

Wie beheben Sie THREADS_API__LINK_LIMIT_EXCEEDED?

Metas eigene Anweisung ist eine Zeile: „If you receive this error, reduce the number of unique links in your post to 5 or less.“ In der Praxis heißt das, vor dem API-Aufruf zu zählen:

1. Ziehen Sie jede URL und jede reine Domain aus text, dazu link_attachment oder text_attachment.link_attachment_url.
2. Führen Sie exakte Duplikate zusammen.
3. Bleiben mehr als 5 übrig, streichen Sie Links oder verschieben Sie sie in eine Antwort. Die wird als eigener Beitrag über denselben Endpunkt mit reply_to_id erstellt und hat deshalb ihre eigene Zählung.

Ein Planungstool sollte diese Prüfung ausführen, wenn ein Beitrag geschrieben wird, nicht wenn er ausgelöst wird, denn ein Fehler um 03:00 ist ein verpasster Slot. Dasselbe gilt für die Zeichenzahl und das Tageskontingent. Wie Sie eine Warteschlange sauber halten, zeigt der Beitrag dazu, wie Sie Threads-Beiträge planen. Das Limit gehört zu Threads, also arbeitet jedes Tool zur Threads-Planung innerhalb derselben 5.

Häufig gestellte Fragen

Was bedeutet THREADS_API__LINK_LIMIT_EXCEEDED?

Es bedeutet, dass der Beitrag mehr als 5 eindeutige Links enthielt. Seit dem 22. Dezember 2025 lehnt Meta solche Beiträge beim Schritt der Medienerstellung ab, POST /{threads-user-id}/threads, und gibt statt einer Container-ID diesen Fehlercode zurück.

Zählt derselbe Link zweimal als zwei Links?

Nein. Meta zählt „All unique URLs found in the text field,“ also zählt eine in text wiederholte URL einmal. Ein link_attachment, das einer URL entspricht, die schon in text steht, „is only counted once, rather than twice.“

Zählt link_attachment zum Limit von 5 Links?

Nur wenn es eine neue URL hinzufügt. Meta sagt, dass ein link_attachment, das sich von jeder URL in text unterscheidet, „is counted as an additional link,“ während eines, das einer URL in text entspricht, der Zählung nichts hinzufügt.

Seit wann setzt Threads das Link-Limit durch?

Seit dem 22. Dezember 2025. Meta hat es am 8. Dezember 2025 im Threads-Changelog angekündigt, und die Warnung im Leitfaden zu Beiträgen beginnt mit „Starting December 22, 2025.“

Verbraucht ein am Link-Limit gescheiterter Beitrag das Tageskontingent von 250 Beiträgen?

Meta setzt das Limit von 250 Beiträgen auf POST /{threads-user-id}/threads_publish durch, und der Fehler zum Link-Limit kommt früher, bei der Container-Erstellung. Ein Beitrag, der wegen zu vieler Links abgelehnt wird, erreicht den Veröffentlichungsaufruf nie.

Kann ich in einem Threads-Thread mehr als 5 Links teilen?

Meta zählt Links pro Beitrag. Eine Antwort ist ein eigener Beitrag, erstellt über denselben Container-Endpunkt mit reply_to_id, also bleibt jeder einzelne unter dem Limit, wenn Sie die Links auf einen Beitrag und seine Antworten verteilen. Eine gemeinsame Obergrenze für einen ganzen Thread dokumentiert Meta nicht.

Wie viele Links darf ein Threads-Beitrag haben?

Ein Threads-Beitrag darf 5 eindeutige URLs enthalten. Metas Posts-Guide sagt „The number of links is restricted to 5 or less,“ und ein sechster Link scheitert bei der Container-Erstellung mit THREADS_API__LINK_LIMIT_EXCEEDED. Eine im Beitrag wiederholte URL zählt einmal.

Zählt eine Domain ohne https:// als Link?

Metas Beispiele verwenden reine Domains wie www.facebook.com und zählen sie als Links. Der Zähler wartet also nicht auf ein Schema. Eine Domain im Fließtext erhöht die Summe.

Sind die http- und die https-Version derselben URL ein Link oder zwei?

Das sagt Meta nicht. Der Posts-Guide wiederholt URLs nur Zeichen für Zeichen, also behandeln Sie zwei unterschiedliche Zeichenfolgen als zwei Links. Schreiben Sie dieselbe URL überall identisch.

Zählen URLs im plaintext eines Text-Anhangs zum Limit?

Das sagt Meta nicht. Die Zählregeln nennen URLs im Feld text und die Anhangs-URL, plaintext kommt nicht vor. Halten Sie die Summe eindeutiger URLs über text, plaintext und Anhang bei höchstens 5.