InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Instagram stories publiceren via de API

De API van Instagram publiceert een story uit één afbeelding of één video op een openbare URL: maak een container aan met media_type STORIES en publiceer die daarna. Afbeeldingen zijn JPEG tot 8 MB, video's duren 3 tot 60 seconden en zijn tot 100 MB, Meta raadt een frame van 9:16 aan, en de story verdwijnt na 24 uur, net als in de app.

easyCoexistence publiceert afbeelding- en video-stories met publish_instagram_post vanuit Claude, ChatGPT of je eigen code, en kan ze plannen vanuit de eigen wachtrij.

60 s

De langste storyvideo die de API publiceert; de kortste is 3 seconden en het bestand kan tot 100 MB groot zijn.

8 MB

De grootste storyafbeelding, die een JPEG moet zijn.

24 hours

Hoe lang een gepubliceerde story zichtbaar blijft voordat hij verloopt.

Under 5

Metrieken van een story die zo laag zijn, komen terug als fout 10, onvoldoende kijkers, in plaats van een getal.

Hoe wordt een story gepubliceerd?

Met dezelfde twee aanroepen als elke post. POST /<IG_ID>/media met media_type op STORIES en ofwel image_url of video_url, daarna POST /<IG_ID>/media_publish met de container-ID. Een videostory wordt eerst verwerkt, dus de status_code van de container moet op FINISHED staan voordat hij kan worden gepubliceerd.

De referentie van Meta beschrijft het bijschrift voor foto's, video's en carrousels, niet voor stories. Teksten voor de kijker horen dus in de afbeelding of video zelf.

Wat zijn de mediaeisen voor een story?

Meta raadt een frame van 9:16 aan, zowel voor storyafbeeldingen als voor storyvideo's, om bijsnijden en lege ruimte te voorkomen.

  • Afbeelding: JPEG, tot 8 MB, in sRGB; andere kleurruimtes worden omgezet.
  • Video: MOV of MP4 met H.264- of HEVC-video en AAC-audio, 23 tot 60 frames per seconde, tot 1920 pixels breed en 25 Mbps.
  • Videolengte: 3 tot 60 seconden, met een bestand van maximaal 100 MB.
  • Videoverhouding: alles van 0,1:1 tot 10:1 wordt geaccepteerd.

Wat kan een story bevatten?

De afbeelding of video zelf, en vermeldingen van andere accounts: sinds juli 2025 tagt de parameter user_tags openbare accounts in afbeelding- en video-stories, met optionele x- en y-coördinaten. Meta ondersteunt het publiceren van stickers via de API niet, dus links, polls en locaties blijven in de app.

Wat gebeurt er nadat een story is gepubliceerd?

Hij blijft 24 uur zichtbaar en verloopt daarna, net als in de app. Meta toont live stories op een aparte stories-edge; de mediaslijst van het account, GET /<IG_ID>/media, bevat ze niet. Wanneer je een story terugleest, is de media_type IMAGE of VIDEO, net als bij elke andere media. Herken stories dus aan de plek waar je ze vond, niet aan hun type.

Hoe komen antwoorden en vermeldingen terug?

Als directe berichten. Een antwoord op een story bereikt het account als DM via de messages-webhook, met de ID en URL van de story erbij, en het opent het gebruikelijke venster van 24 uur om te antwoorden. Wanneer iemand het account vermeldt in de eigen story, komt dat ook als bericht binnen, met een bijlage van het type story_mention. De Mentions API van Meta dekt stories niet.

Welke metrics rapporteert een story?

Bereik, weergaven, keer gedeeld, antwoorden, nieuwe volgers, profielbezoeken, profielactiviteit, navigatie, linkklikken, reposts en totale interacties, opgehaald via het endpoint voor media-insights. Ze zijn slechts 24 uur beschikbaar, en een waarde onder 5 geeft foutcode 10, onvoldoende kijkers, in plaats van een getal. Antwoorden van mensen in Europa en Japan worden niet meegeteld, en een story van een account daar rapporteert 0 antwoorden.

Veelgemaakte fouten

  • Een linksticker plannen. De API publiceert geen stickers, dus een link moet de mensen op een andere manier bereiken, bijvoorbeeld via een DM-antwoord.
  • Storymetrics de volgende dag uitlezen. Ze zijn slechts 24 uur beschikbaar, dus verzamel ze terwijl de story nog live is.
  • Zoeken naar een gepubliceerde story in de mediaslijst van het account. Live stories staan in een aparte stories-edge.
  • Een liggende video als story publiceren. Meta raadt 9:16 aan, en andere vormen kunnen lege ruimte tonen of worden bijgesneden.
Dit doen met EasyCoexistence

Antwoorden op een story komen binnen als DM's, die je kunt doorsturen naar je endpoint of laten beantwoorden door een automatisering. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je er meer toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Kan ik een linksticker aan een story toevoegen via de API?

Nee. Meta ondersteunt het publiceren van stickers via de API niet, ook geen links, polls en locaties. Een ander account vermelden zonder sticker wordt wel ondersteund.

Waar staat een gepubliceerde story in de API?

In de aparte stories-edge van het account zolang hij live is. GET /<IG_ID>/media bevat geen stories, en een story komt terug als IMAGE of VIDEO.

Kan een story via de API een bijschrift hebben?

Nee. De referentie van Meta beschrijft geen bijschrift voor stories, en publish_instagram_post verstuurt een story zonder bijschrift, dus teksten voor de kijker gaan in de afbeelding of video zelf.

Hoe lang zijn storyinzichten beschikbaar?

24 uur. Meta maakt storymetrics slechts zo lang beschikbaar, dus lees ze uit terwijl de story nog live is.

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