InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Alt-tekst bij Instagram-posts via de API

De Instagram-API voegt alternatieve tekst toe aan een afbeeldingspost via de parameter alt_text, die je instelt bij het aanmaken van de mediacontainer. Die accepteert tot 1.000 tekens en werkt op een losse foto of op elk beeld in een carrousel, terwijl Reels en Stories het niet ondersteunen. Meta voegde het veld toe op 24 maart 2025.

easyCoexistence publiceert foto's en carrousels met publish_instagram_post vanuit Claude, ChatGPT of je eigen code.

1,000

Het maximale aantal tekens aan alternatieve tekst dat één afbeelding via de API kan bevatten.

24 Mar 2025

Wanneer Meta het veld alt_text voor afbeeldingsposts introduceerde op het media-endpoint.

Images only

alt_text werkt op losse afbeeldingen en carrouselbeelden; Reels en Stories worden niet ondersteund.

alt_text

Veld op gepubliceerde media dat de beschrijvende tekst van een afbeelding teruggeeft, voor toegankelijkheid.

Wat is alt-tekst bij een Instagram-post?

Een schriftelijke beschrijving van een afbeelding, die de mediareferentie van Meta beschrijvende tekst voor afbeeldingen noemt, voor toegankelijkheid. Via de API stel je die per afbeelding in met de parameter alt_text bij het aanmaken van de container, en lees je haar terug uit het veld alt_text zodra de post is gepubliceerd.

Hoe voeg je alt-tekst toe?

Met alt_text op de container van de afbeelding. POST /<IG_ID>/media met image_url, het bijschrift en alt_text maakt hem aan, en POST /<IG_ID>/media_publish publiceert hem zoals gewoonlijk. Bij een carrousel stel je alt_text in op de container van elk afbeeldingsitem, de containers die zijn aangemaakt met is_carousel_item ingesteld op true, voordat je de carrouselcontainer aanmaakt.

An image container with alt text
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json

{
  "image_url": "https://example.com/photo.jpg",
  "caption": "<CAPTION>",
  "alt_text": "<WHAT_THE_IMAGE_SHOWS>"
}

Welke posts ondersteunen alt-tekst?

Alleen afbeeldingsposts, zoals de referentie van Meta de parameter beschrijft:

  • Een enkele afbeeldingspost: ondersteund, tot 1.000 tekens.
  • Afbeeldingen in een carrousel: ondersteund, elk met een eigen tekst.
  • Video's, ook videoitems in een carrousel: niet ondersteund.
  • Reels en Stories: niet ondersteund.
  • De carrouselcontainer zelf: de tekst gaat in plaats daarvan op de afbeeldingsitems.

Hoe lees je alt-tekst terug?

Vraag het veld alt_text op van de gepubliceerde afbeelding, GET /<IG_MEDIA_ID>?fields=alt_text. Het is een publiek veld van het mediaobject, dus je kunt het ook opvragen voor de afbeeldingen van een carrousel via de children-edge, die de foto's en video's binnen de post opsomt.

Kun je alt-tekst wijzigen na publicatie?

Meta documenteert geen manier om dat te doen. De enige update die de mediareferentie voor een gepubliceerde post noemt, is het aan- of uitzetten van reacties. Alt-tekst moet dus in de container worden geschreven voordat de post live gaat, samen met het bijschrift en de URL van de afbeelding.

Veelgemaakte fouten

  • alt_text meesturen bij een Reel of een Story. Meta ondersteunt het alleen bij afbeeldingsposts.
  • Het op de carrouselcontainer zetten. Alt-tekst hoort bij elk afbeeldingsitem binnen de carrousel.
  • Meer dan 1.000 tekens schrijven. Dat is het maximum dat de alternatieve tekst van één afbeelding kan bevatten.
Dit doen met EasyCoexistence

De tool neemt geen alt_text aan, dus de beschrijving voeg je toe in de Instagram-app, via de optie Bewerken van de post. Van US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Hoeveel tekens mag alt-tekst zijn via de Instagram-API?

Tot 1.000 tekens per afbeelding, ingesteld met alt_text op de container van elke afbeelding, dus elke afbeelding in een carrousel krijgt een eigen tekst.

Kan een Reel alt-tekst hebben via de API?

Nee. Meta ondersteunt alt_text niet bij Reels of Stories.

Hoe voeg ik alt-tekst toe aan een carrousel?

Stel alt_text in op de container van elk afbeeldingsitem, aangemaakt met is_carousel_item ingesteld op true, voordat je de carrouselcontainer aanmaakt.

Wanneer heeft de Instagram-API alt-tekst toegevoegd?

Meta introduceerde het veld alt_text voor afbeeldingsposts op 24 maart 2025.

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