AccediInizia la prova gratuita
easyCoexistence API ufficiali

Pubblicare storie Instagram tramite l'API

L'API di Instagram pubblica una storia da un'immagine o un video in un URL pubblico: crea un container con media_type STORIES, poi pubblicalo. Le immagini sono JPEG fino a 8 MB, i video durano da 3 a 60 secondi e arrivano a 100 MB, Meta consiglia un fotogramma 9:16, e la storia scompare dopo 24 ore, come nell'app.

easyCoexistence pubblica storie con immagini e video tramite publish_instagram_post da Claude, ChatGPT o dal tuo codice, e può programmarle dalla sua coda.

60 s

Il video storia più lungo che l'API pubblica; il più breve dura 3 secondi e il file può arrivare a 100 MB.

8 MB

L'immagine storia più grande, che deve essere un JPEG.

24 hours

Per quanto tempo una storia pubblicata resta online prima di scadere.

Under 5

I valori delle metriche storia così bassi tornano come codice di errore 10, numero di spettatori insufficiente, invece di un numero.

Come si pubblica una storia?

Con le stesse due chiamate di qualsiasi post. POST /<IG_ID>/media con media_type impostato su STORIES e image_url oppure video_url, poi POST /<IG_ID>/media_publish con l'ID del container. Un video storia viene elaborato prima, quindi il campo status_code del suo container deve risultare FINISHED prima che possa essere pubblicato.

Il riferimento di Meta descrive la didascalia per foto, video e caroselli, non per le storie, quindi le parole rivolte allo spettatore vanno nell'immagine o nel video stesso.

Quali sono i requisiti multimediali delle storie?

Meta consiglia un fotogramma 9:16 sia per le immagini sia per i video delle storie, per evitare ritagli o spazi vuoti.

  • Immagine: JPEG, fino a 8 MB, in sRGB; gli altri spazi colore vengono convertiti.
  • Video: MOV o MP4 con video H.264 o HEVC e audio AAC, da 23 a 60 fotogrammi al secondo, fino a 1920 pixel di larghezza e 25 Mbps.
  • Durata video: da 3 a 60 secondi, con un file fino a 100 MB.
  • Proporzioni del video: sono accettate tutte quelle da 0,1:1 a 10:1.

Cosa può contenere una storia?

L'immagine o il video stesso e le menzioni di altri account: da luglio 2025 il parametro user_tags etichetta account pubblici nelle storie con immagine e video, con coordinate x e y facoltative. Meta non supporta la pubblicazione di adesivi tramite l'API, quindi link, sondaggi e posizioni restano nell'app.

Cosa succede dopo la pubblicazione di una storia?

Resta online per 24 ore, poi scade, come nell'app. Meta elenca le storie attive in un edge dedicato, separato da quello dei media; la lista dei media dell'account, GET /<IG_ID>/media, non le include. Quando la rileggi, il media_type di una storia è IMAGE o VIDEO, come per ogni altro media, quindi distingui le storie in base a dove le hai trovate e non in base al loro tipo.

Come tornano le risposte e le menzioni?

Come messaggi diretti. Una risposta a una storia arriva all'account come DM sul webhook dei messaggi, con l'ID e l'URL della storia allegati, e apre la consueta finestra di 24 ore per rispondere. Quando qualcuno menziona l'account nella propria storia, arriva anch'essa come messaggio, con un allegato di tipo story_mention. L'API Mentions di Meta non copre le storie.

Quali metriche riporta una storia?

Raggiungimento, visualizzazioni, condivisioni, risposte, follow, visite al profilo, attività del profilo, navigazione, clic sul link, repost e interazioni totali, lette tramite l'endpoint degli insight dei media. Sono disponibili solo per 24 ore, e un valore inferiore a 5 restituisce il codice di errore 10, numero di spettatori insufficiente, invece di un numero. Le risposte di persone in Europa e in Giappone sono escluse dal conteggio, e una storia creata da un account lì riporta 0 risposte.

Errori comuni

  • Pianificare un adesivo con link. L'API non pubblica adesivi, quindi un link deve raggiungere le persone in un altro modo, ad esempio con una risposta via DM.
  • Leggere le metriche delle storie il giorno dopo. Sono disponibili solo per 24 ore, quindi raccoglile mentre la storia è online.
  • Cercare una storia pubblicata nella lista dei media dell'account. Le storie attive sono elencate in un edge separato dedicato alle storie.
  • Pubblicare un video orizzontale come storia. Meta consiglia 9:16, e le altre forme possono mostrare spazi vuoti o venire ritagliate.
Farlo con EasyCoexistence

Le risposte a una storia arrivano come DM, che possono essere inoltrate al tuo endpoint o ricevere una risposta da un'automazione. Da US$ 9 a US$ 0,75 per connessione al mese, in calo con l'aggiunta di connessioni, con la prima prova gratuita di 3 giorni.

Domande frequenti

Posso aggiungere un adesivo con link a una storia tramite l'API?

No. Meta non supporta la pubblicazione di adesivi tramite l'API, link, sondaggi e posizioni inclusi. Menzionare un altro account senza adesivo è supportato.

Dove compare una storia pubblicata nell'API?

Nell'edge dedicato alle storie dell'account finché è online. GET /<IG_ID>/media non include le storie, e una storia viene letta come IMAGE o VIDEO.

Una storia può avere una didascalia tramite l'API?

No. Il riferimento di Meta non descrive didascalie per le storie, e publish_instagram_post invia una storia senza didascalia, quindi le parole rivolte allo spettatore vanno nell'immagine o nel video stesso.

Per quanto tempo sono disponibili gli insight delle storie?

Per 24 ore. Meta rende disponibili le metriche delle storie solo per questo periodo, quindi leggile mentre la storia è online.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il