AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Instagram-Bildunterschriften: Zeichen, Hashtags und @-Tags in der API

Die Instagram-API akzeptiert eine Bildunterschrift mit bis zu 2,200 Zeichen zu einem Foto, Reel oder Karussell, mit höchstens 20 @-Tags. Laut Stand November 2026 erlaubt der Hilfebereich von Instagram 5 Hashtags pro Beitrag, während Metas API-Referenz noch 30 aufführt, daher bleiben Sie bei 5. @-markierte Konten werden bei der Veröffentlichung benachrichtigt, und eine zu lange Bildunterschrift schlägt mit Code 36004, Subcode 2207010 fehl.

easyCoexistence veröffentlicht ein Foto, Karussell oder Reel mit seiner Bildunterschrift über publish_instagram_post, aus Claude, ChatGPT oder Ihrem eigenen Code.

2,200

Die meisten Zeichen, die eine Bildunterschrift über die Instagram-API enthalten kann.

5

Die meisten Hashtags, die der Hilfebereich von Instagram inzwischen pro Beitrag erlaubt, in der Bildunterschrift oder den Kommentaren.

30

Die meisten Hashtags pro Bildunterschrift laut Metas API-Referenz, die noch den älteren Wert nennt.

20

Die meisten @-Tags in einer Bildunterschrift; bei Überschreitung kommt Code 100, Subcode 2207040 zurück.

2207010

Fehler-Subcode unter Code 36004 für eine Bildunterschrift, die länger ist, als Instagram erlaubt.

Partial

media_publish kann mit config_issue CAPTION_NOT_ATTACHED erfolgreich sein: Der Beitrag ist online, aber ohne Bildunterschrift.

Wie lauten die Limits für Bildunterschriften?

Drei, alle beim Parameter caption des Media-Containers. Eine Bildunterschrift kann Hashtags, geschrieben als #tag, und Benutzernamen von Instagram-Konten, geschrieben als @username, innerhalb dieser Grenzen enthalten:

  • Länge: bis zu 2.200 Zeichen.
  • Hashtags: bis zu 5 pro Beitrag laut dem Hilfebereich von Instagram, wobei die in den Kommentaren mitzählen; Metas API-Referenz nennt weiterhin 30.
  • @-Tags: bis zu 20, und jedes erwähnte Konto wird bei der Veröffentlichung des Beitrags benachrichtigt.

Welche Beiträge erhalten eine Bildunterschrift?

Fotos, Reels und Karussells. Bei einem Karussell wird die Bildunterschrift am Karussell-Container angegeben, da die darin enthaltenen Bilder und Videos keine Bildunterschrift unterstützen. Metas Referenz beschreibt für Stories keine Bildunterschrift, daher gehört Text für eine Story in das Bild oder Video selbst.

Was passiert, wenn eine Bildunterschrift ein Limit verletzt?

Die Anfrage schlägt mit einem Fehler fehl, der das Problem benennt. Eine zu lange Bildunterschrift liefert Code 36004, Subcode 2207010, und Metas Lösung dafür nennt die Grenzen erneut: höchstens 2.200 Zeichen, 30 Hashtags und 20 @-Tags. Mehr als 20 @-Tags kann zusätzlich Code 100, Subcode 2207040 zurückgeben. Kürzen Sie die Bildunterschrift und senden Sie die Anfrage erneut.

Wann werden erwähnte Konten benachrichtigt?

Wenn der Container veröffentlicht wird, nicht wenn er erstellt wird. Konten, die in einer Bildunterschrift mit @ erwähnt werden, erhalten in diesem Moment eine Benachrichtigung, sodass ein vorab angelegter Container niemanden benachrichtigt, bis er live geht. Metas Grenze von 20 @-Tags pro Bildunterschrift gilt für diese Erwähnungen.

Kann ein Beitrag ohne seine Bildunterschrift online gehen?

Ja. media_publish kann mit dem Feld config_issue auf CAPTION_NOT_ATTACHED erfolgreich sein, was bedeutet, dass das Medium ohne Bildunterschrift veröffentlicht wurde. Meta nennt das einen Teilerfolg: Die Media-ID ist gültig, daher sollten Sie den Beitrag abgleichen, statt ihn erneut zu veröffentlichen.

Kann eine Bildunterschrift nach der Veröffentlichung geändert werden?

Metas Media-Referenz dokumentiert ein Update für veröffentlichte Medien: Kommentare mit POST /<IG_MEDIA_ID> und comment_enabled ein- oder ausschalten. Eine Bearbeitung der Bildunterschrift ist nicht vorgesehen. Prüfen Sie daher Text, Hashtags und @-Tags, bevor der Container erstellt wird.

Häufige Fehler

  • Nur die Länge prüfen. Eine Bildunterschrift unter 2.200 Zeichen verletzt die Limits trotzdem, wenn sie mehr als 5 Hashtags enthält, Instagrams aktuelle Regel, oder mehr als 20 @-Tags.
  • Einzelne Karussell-Elemente beschriften. Nur der Karussell-Container nimmt eine Bildunterschrift an.
  • Eine Bildunterschrift für eine Story schreiben. Der Story-Container nimmt keine an, daher gehört der Text in das Bild oder Video.
  • Nach CAPTION_NOT_ATTACHED erneut veröffentlichen. Der erste Beitrag ist bereits online, und eine zweite Veröffentlichung erzeugt ein Duplikat.
Mit EasyCoexistence

Beim Karussell setzen Sie die Bildunterschrift einmal, und list_social_posts liest die Bildunterschrift jedes Beitrags zurück. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung. Die ersten 3 Tage sind eine kostenlose Testphase.

Häufig gestellte Fragen

Was bedeutet Fehler 2207040 bei Instagram?

Die Bildunterschrift hat mehr als 20 @-Tags, zurückgegeben unter Code 100. Entfernen Sie Tags, bis 20 oder weniger übrig sind, und senden Sie die Anfrage erneut.

Zählen Hashtags in Kommentaren zum 5-Hashtag-Limit von Instagram?

Ja. Der Hilfebereich von Instagram erlaubt bis zu 5 Hashtags pro Beitrag, wobei Hashtags in der Bildunterschrift und in den Kommentaren mitgezählt werden.

Kann ich Kommentare bei einem veröffentlichten Beitrag über die API deaktivieren?

Ja. POST /<IG_MEDIA_ID> mit comment_enabled auf false deaktiviert Kommentare, true schaltet sie wieder ein. Das ist das einzige Update, das Metas Media-Referenz für veröffentlichte Medien dokumentiert.

Was bedeutet Fehler 2207010?

Die Bildunterschrift ist länger, als Instagram erlaubt. Kürzen Sie sie auf 2.200 Zeichen oder weniger und senden Sie die Anfrage erneut.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am