Instagram-bijschriftlimieten: tekens, hashtags en @-tags in de API
De API van Instagram accepteert een bijschrift van maximaal 2.200 tekens bij een foto, Reel of carrousel, met maximaal 20 @-tags. Per november 2026 staat het Instagram Helpcentrum maximaal 5 hashtags per post toe, terwijl de API-referentie van Meta nog 30 vermeldt, dus houd het bij 5. Vermelde accounts krijgen een melding wanneer de post wordt gepubliceerd, en een bijschrift dat te lang is, geeft een fout met code 36004, subcode 2207010.
easyCoexistence publiceert een foto, carrousel of Reel met bijschrift via publish_instagram_post, vanuit Claude, ChatGPT of je eigen code, waarbij je het bijschrift één keer instelt op een carrousel.
Het maximale aantal tekens dat een bijschrift via de API van Instagram kan bevatten.
Het maximale aantal hashtags dat het Help Center van Instagram nu per post toestaat, in het bijschrift of de reacties.
Het maximale aantal hashtags per bijschrift in de API-referentie van Meta, die nog het oudere cijfer geeft.
Het maximale aantal @-tags in één bijschrift; overschrijding geeft code 100, subcode 2207040.
Foutsubcode, onder code 36004, voor een bijschrift dat langer is dan Instagram toestaat.
media_publish kan slagen met config_issue CAPTION_NOT_ATTACHED: de post staat live zonder bijschrift.
Wat zijn de limieten voor bijschriften?
Drie, alle op de parameter caption van de mediacontainer. Een bijschrift kan hashtags bevatten, geschreven als #tag, en gebruikersnamen van Instagram-accounts, geschreven als @gebruikersnaam, binnen deze limieten:
- Lengte: maximaal 2.200 tekens.
- Hashtags: maximaal 5 per post volgens het Instagram Helpcentrum, waarbij ook die in de reacties meetellen; de API-referentie van Meta vermeldt nog 30.
- @-tags: maximaal 20, en elk vermeld account krijgt een melding wanneer de post wordt gepubliceerd.
Welke posts krijgen een bijschrift?
Foto's, Reels en carrousels. Bij een carrousel gaat het bijschrift op de carrouselcontainer, omdat de afbeeldingen en video's erin dat niet ondersteunen. De referentie van Meta beschrijft geen bijschrift voor Stories, dus tekst die bij een Story hoort, staat in de afbeelding of video zelf.
Wat gebeurt er als een bijschrift een limiet overschrijdt?
Het verzoek mislukt met een fout die het probleem benoemt. Een te lang bijschrift geeft code 36004, subcode 2207010, en de oplossing van Meta daarvoor herhaalt de limieten: maximaal 2.200 tekens, 30 hashtags en 20 @-tags. Meer dan 20 @-tags kan ook code 100 teruggeven, subcode 2207040. Kort het bijschrift in en verstuur het verzoek opnieuw.
Wanneer krijgen vermelde accounts een melding?
Wanneer de container wordt gepubliceerd, niet wanneer hij wordt aangemaakt. Accounts die in een bijschrift worden vermeld, krijgen dan een melding. Een container die van tevoren is voorbereid, waarschuwt dus niemand totdat hij live gaat. De limiet van 20 @-tags per bijschrift van Meta geldt voor deze vermeldingen.
Kan een post live gaan zonder bijschrift?
Ja. media_publish kan slagen met het veld config_issue ingesteld op CAPTION_NOT_ATTACHED, wat betekent dat de media zonder bijschrift is gepubliceerd. Meta noemt dit een gedeeltelijk succes: de media-ID is geldig, dus controleer de bestaande post in plaats van hem opnieuw te publiceren.
Kan een bijschrift na publicatie worden gewijzigd?
De mediareferentie van Meta documenteert één update voor gepubliceerde media: reacties aan- of uitzetten met POST /<IG_MEDIA_ID> en comment_enabled. Er is geen manier om een bijschrift te bewerken, dus controleer de tekst, hashtags en @-tags voordat de container wordt aangemaakt.
Veelgemaakte fouten
- Alleen op lengte controleren. Een bijschrift van minder dan 2.200 tekens overschrijdt de limieten nog steeds met meer dan 5 hashtags, de huidige regel van Instagram, of met meer dan 20 @-tags.
- Bijschriften op carrouselitems zetten. Alleen de carrouselcontainer neemt een bijschrift.
- Een bijschrift schrijven voor een Story. De Stories-container neemt er geen, dus zet de tekst in de afbeelding of video.
- Opnieuw publiceren na CAPTION_NOT_ATTACHED. De eerste post staat al live, en een tweede publicatie maakt een duplicaat.
list_social_posts leest het bijschrift van elke post terug. Vanaf US$ 9 per verbinding per maand, dalend tot US$ 0,75 naarmate je meer verbindingen toevoegt, met de eerste 3 dagen als gratis proefperiode.
Veelgestelde vragen
Wat betekent fout 2207040 bij Instagram?
Het bijschrift heeft meer dan 20 @-tags, teruggegeven onder code 100. Verwijder tags tot er 20 of minder overblijven en verstuur het verzoek opnieuw.
Telt de limiet van 5 hashtags van Instagram ook hashtags in reacties mee?
Ja. Het Help Center van Instagram staat maximaal 5 hashtags per post toe, waarbij die in het bijschrift en in de reacties samen worden geteld.
Kan ik reacties op een gepubliceerde post via de API uitzetten?
Ja. POST /<IG_MEDIA_ID> met comment_enabled ingesteld op false zet reacties uit en true zet ze weer aan. Dit is de enige update die de mediareferentie van Meta documenteert voor gepubliceerde media.
Wat betekent fout 2207010?
Het bijschrift is langer dan Instagram toestaat. Kort het in tot 2.200 tekens of minder en verstuur het verzoek opnieuw.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op