Pubblicazione programmata e API di piattaforma

Instagram API di pubblicazione dei contenuti (Instagram API di pubblicazione dei contenuti)

Data di verifica del profilo:2026-11-11 · Organizzato in base alla documentazione ufficiale dello sviluppatore della piattaforma e al centro assistenza del produttore

Definizione:Instagram Content Publishing API è l'interfaccia ufficiale fornita da Meta nella piattaforma Instagram, che consente alle applicazioni di terze parti autorizzate di pubblicare singole immagini, singoli video, bobine, storie e post di caroselli fino a 20 materiali per conto di account professionali Instagram (account commerciante o creatore). La funzione "Instagram pubblicazione automatica/pubblicazione diretta" negli strumenti di gestione dei social media di solito richiama questo insieme di interfacce nella parte inferiore: crea prima un contenitore multimediale, quindi chiama l'endpoint di pubblicazione all'orario pianificato.

Instagram Diagramma del processo API di pubblicazione dei contenuti: creare contenitori multimediali, caricare o estrarre materiali, controllare lo stato del contenitore, chiamare media_publish per pubblicare e contrassegnare la quota di pubblicazione di 24 ore e la scadenza di 24 ore del contenitore — SocialKit Diagramma schematico originale, compilato secondo la Guida alla pubblicazione dei contenuti di Meta for Developers e il documento di riferimento IG User Media e non rappresenta alcuna interfaccia del prodotto.

"Come funziona?"

Collegamento autorizzato: Gli utenti autorizzano tramite Facebook Login per Business o Business Login per Instagram, ottenendo i permessi di pubblicazione (come instagram_content_publish o instagram_business_content_publish). Solo Instagram account professionali possono pubblicare tramite l'API.
Crea un contenitore media: invia una richiesta a /{IG_ID}/media, allega l'URL pubblico e una copia dell'immagine o del video, e ottieni un ID contenitore. Meta recupererà attivamente il materiale da questo URL, quindi il materiale deve essere posizionato su un server accessibile pubblicamente al momento del tentativo di pubblicazione; i video di grandi dimensioni possono essere caricati anche tramite l'upload riprendibile di rupload.facebook.com.
Specificare il tipo di contenuto: i contenitori video usano media_type per distinguere tra VIDEO, REELS o STORIES; per i carusel, prima creare sotto-container per ogni asset (is_carousel_item=true), poi combinarli in un contenitore carusel usando media_type=CAROUSEL e bambini.
Controllare lo stato del contenitore: l'elaborazione video richiede tempo; è possibile interrogare il codice status_code del contenitore, che può restituire IN_PROGRESS, FINISHED, ERROR, EXPIRED, o PUBBLICADO. Si raccomanda ufficialmente di interrogare una volta al minuto per un massimo di 5 minuti.
Pubblica: passa creation_id (ID contenitore) a /{IG_ID}/media_publish, e ricevi l'ID media ufficiale dopo il successo. Il cosiddetto "rilascio programmato" dello strumento di pianificazione consiste nel completare questo passaggio all'orario previsto.
Controllo di quota: Prima di pubblicare, è possibile chiedere /{IG_ID}/content_publishing_limit per vedere quante volte l'account ha pubblicato nelle ultime 24 ore; si raccomanda ufficialmente che le applicazioni implementino anche i propri controlli di quota, soprattutto per le applicazioni che supportano la programmazione.

Panoramica delle regole e delle restrizioni chiave

Progetto	"Regole nella documentazione ufficiale"	Impatto sugli utenti dello strumento di programmazione
Tipi di account	Supporta solo la pubblicazione di account professionali Instagram (account merchant o creator)	Gli account personali non possono essere rilasciati automaticamente. Lo strumento può essere modificato solo in promemoria push, che puoi completare manualmente sul tuo cellulare.
Quota di rilascio	La linea guida per la pubblicazione dei contenuti stabilisce che un massimo di 100 rilasci di interfaccia può essere pubblicato entro 24 ore dal rollio, e il carosello conta come 1 elementi; la pagina di riferimento per il paragrafo del carosello e il limite di pubblicazione dei contenuti indica ancora 50 elementi.	I due numeri non sono coerenti. Prevarrà il quota_total restituito dall'interfaccia; è necessario lasciare un margine quando si pianifica un numero elevato di volte.
"Contenitore Media"	I contenitori scadranno se non pubblicati entro 24 ore; ogni conto può creare un massimo di 400 contenitori per ogni laminazione 24 ore	I contenitori devono essere pubblicati entro 24 ore dalla creazione; la programmazione di molti giorni in anticipo richiede lo strumento per creare il contenitore più vicino all'orario di pubblicazione, e metodi specifici variano a seconda dello strumento
"Specifiche delle immagini"	supporta solo JPEG, la dimensione massima è 8 MB, le proporzioni devono essere comprese tra 4:5 e 1.91:1; JPEG estesi come MPO e JPS non sono supportati	Le immagini con rapporti fuori portata non possono essere pubblicate automaticamente e devono essere ritagliate o passate a pubblicazione promemoria
Specifiche delle bobine	MOV o MP4, durata da 3 secondi a 15 minuti, massimo 300 MB, consigliato 9:16	I video con durate al di fuori della gamma non possono essere automaticamente pubblicati.
Storie	Durata 3 a 60 secondi, max 100 MB	Storie di oltre 60 secondi devono essere modificate
Carusel	Fino a 20 immagini o video; tutte le immagini vengono ritagliate al rapporto di aspetto della prima immagine (predefinito 1:1)	I carruselli misti-ratio possono essere raccolti; è meglio unificare il rapporto prima di pubblicare.
funzione non supportata	Le etichette e i filtri non sono supportati; gli account con l'autorizzazione di pubblicazione della pagina incompleta non possono pubblicare.	Post con caratteristiche come i tag di acquisti devono utilizzare la pubblicazione di promemoria o essere completati all'interno dell'App

Le regole sono estratte dalle linee guida di pubblicazione dei contenuti di Meta for Developers (pagina marcata con aggiornamenti 2026-10-20), da riferimento IG User Media (2026-09-28 aggiornamenti), e da riferimento IG User Content Publishing Limit (2024-07-23 aggiornamenti), accessibili su 2026-11-11. Meta aggiusterà le versioni e i limiti; si prega di fare riferimento all'ultima documentazione prima dell'integrazione o dell'acquisto.

Indicazioni comuni

Auto-pubblicazione programmata: Lo strumento di programmazione dei social media pubblica post di immagini, Reels, Storie e caruselli per voi a orari programmati senza bisogno di aprire manualmente Instagram.
"Operazioni multi-account e di team: agenzie o team di brand gestiscono calendari editoriali e approvazioni per più account professionali in un unico backend, con pubblicazione tramite API dopo approvazione."
Integrazione con sviluppatori: Crea il tuo sistema di contenuti, il backend di e-commerce o il servizio di pubblicazione API (come un'interfaccia di pubblicazione multipiattaforma unificata) per spingere i contenuti a Instagram attraverso di esso.
Annotazione di conformità: is_ai_generated può essere utilizzato per dichiarare autonomamente contenuti generati da AI durante la creazione di un contenitore; un'etichetta partner (Paid partnership) può anche essere aggiunta accedendo tramite Facebook Login.
Tracciamento dello stato di rilascio: attraverso l'interfaccia dello stato del contenitore e della quota di rilascio, lo strumento segnala la causa del fallimento ed evita di superare il limite.

Limitazioni e precauzioni

Gli account personali non possono essere sbloccati automaticamente: questa è una limitazione dell'interfaccia stessa, non un difetto di un determinato strumento. Se desideri pubblicare automaticamente, devi cambiare il tuo account in un account commerciante o creatore.
Non tutte le funzionalità dell'App possono essere pubblicate tramite API: La documentazione Meta afferma che i tag di shopping e i filtri non sono supportati; il Centro di Aiuto Buffer elenca anche le funzionalità come musica per messaggi e storie, link di storie, testo di storia o adesivi, tag di prodotto e hashtag non possono essere pubblicati automaticamente da strumenti di terze parti; l'aggiunta di questi si tradurrà in un promemoria da pubblicare.
Le specifiche sono più rigorose rispetto all'App: le immagini sono accettate solo in formato JPEG con rapporti di aspetto limitati da 4:5 a 1.91:1; gli strumenti di programmazione di solito non possono pubblicare automaticamente se superano questa gamma.
Le attività devono essere rastrellabili da Meta: Quando si utilizzano URL, le attività devono essere inserite negli indirizzi accessibili al pubblico; i collegamenti di rete interna o i collegamenti che richiedono login non saranno disponibili.
Ci sono quote di postazione: c'è un limite sul numero di posti entro un periodo di 24 ore rotolante, e i numeri nella documentazione ufficiale variano tra le diverse pagine (100 vs 50); per la pianificazione all'ingrosso, il valore effettivo restituito dall'API dovrebbe prevalere.
L'autorizzazione dell'account riguarda le funzionalità disponibili: per esempio, Buffer spiega che quando si collegano account professionali tramite Instagram login, si aggiunge la posizione, collaboratori e si aggiunge musica ai Reels durante la pubblicazione automatica non è supportato; è necessario utilizzare un metodo di connessione associato a una homepage Facebook.
Autorizzazione e stato della pagina: Se la pagina collegata richiede l'autorizzazione di pubblicazione della pagina o l'autenticazione a due fattori e non è completata, le richieste di pubblicazione non saranno disponibili; Meta raccomanda di completare in anticipo.

Concetti sbagliati comuni

Se lo strumento di programmazione mostra 'Inviato', significa che il post è già in diretta su Instagram?

Non necessariamente. Per i post che ti ricordano di pubblicare, se lo strumento mostra che è stato inviato, significa solo che il promemoria è stato inviato al tuo cellulare e devi comunque completare la pubblicazione nell'App Instagram. Solo attraverso la pubblicazione automatica dell'API di pubblicazione dei contenuti, lo strumento otterrà direttamente l'ID del media pubblicato.

Se uso uno strumento di programmazione a pagamento, il mio account personale può anche pubblicare automaticamente?

No. L'API di pubblicazione dei contenuti supporta solo account professionali e il fatto che tu paghi o meno non cambia questo. Gli account personali possono utilizzare la pubblicazione dei promemoria solo in strumenti come Buffer.

Finché puoi inviare Reels, puoi usare la musica nella tua libreria musicale?

Non necessariamente. La possibilità di rilasciare automaticamente funzioni come la musica dipende dall'interfaccia della piattaforma e dal metodo di connessione. Buffer indica che la musica per post e storie deve essere pubblicata come promemoria e l'aggiunta automatica di musica per Reels richiede la connessione tramite l'associazione della home page Facebook.

La quota di pubblicazione viene resettata a un fisso di 0 punti ogni giorno?

No. Il documento ufficiale parla di un periodo mobile di 24 ore (periodo mobile), non di un azzeramento basato sui giorni naturali; puoi utilizzare content_publishing_limit per interrogare l'utilizzo delle ultime 24 ore.

Esempio

L'attività di un marchio di abbigliamento pianifica un post carosello di una serie di 5 immagini per venerdì 20:00 nello strumento di pianificazione. Prima di arrivare al punto, lo strumento crea sottocontenitori per ciascuna immagine e poi li combina in un contenitore a carosello. Dopo aver confermato che lo stato è FINISHED, viene chiamato l'endpoint di pubblicazione. I post vengono online in tempo e vengono conteggiati in 1 delle 24 ore di quota di pubblicazione dell'account. Nella stessa settimana ha anche organizzato un post con un tag prodotto. Poiché l'interfaccia non supporta i tag degli acquisti, lo strumento lo ha modificato in un post di promemoria, che in quel momento è stato inviato al suo cellulare. Ha aggiunto il tag nell'app Instagram e lo ha pubblicato. Questo esempio è scritto secondo le regole del flusso di documentazione Meta e del Centro assistenza Buffer ed è solo a scopo illustrativo.

Strumenti che supportano l'auto-pubblicazione Instagram

La maggior parte degli strumenti di pianificazione del rilascio nella directory SocialKit supportano il rilascio automatico sull'account professionale Instagram tramite l'interfaccia ufficiale. Sono inoltre disponibili API di rilascio unificate per sviluppatori come Ayrshare e Upload-Post. Ciascuno strumento dispone di un supporto diverso per dettagli quali pubblicazione di promemoria, musica, posizione, collaboratori, primi commenti, ecc. Fare riferimento alla documentazione di aiuto di ciascun prodotto.

Vai a SocialKit Directory degli strumenti Visualizza tutti i prodotti e i criteri di filtraggio.

FAQ

Perché il mio post Instagram è stato automaticamente modificato in "promemoria di pubblicazione" nello strumento di pianificazione?

I motivi comuni includono: l'account è un account personale; il rapporto immagine o aspetto video supera il limite API; la durata dei rimorchi non è compresa tra 3 secondi e 15 minuti; o il post include funzionalità non supportate per l'auto-pubblicazione dall'API, come musica, link di storia, adesivi o tag prodotti. Il Buffer Help Center elenca queste come condizioni per passare automaticamente alla pubblicazione di promemoria.

Instagram Devo pagare per l'API di pubblicazione dei contenuti?

La documentazione di pubblicazione dei contenuti di Meta non elenca i termini di tariffazione per chiamata; gli sviluppatori devono creare applicazioni e ottenere i livelli di accesso e le autorizzazioni corrispondenti. Quando gli utenti ordinari utilizzano lo strumento di pianificazione, il costo dipende dal pacchetto dello strumento stesso.

Quanti messaggi può inviare automaticamente un account ogni giorno tramite lo strumento?

Le linee guida per la pubblicazione di contenuti Meta indicano 100 elementi in sequenza per 24 ore (il carosello conta come 1 elementi), ma il paragrafo del carosello e la pagina di riferimento delle quote della stessa guida indicano ancora 50 elementi. Prevarrà l'effettivo quota_total restituito dall'interfaccia content_publishing_limit.

Rieli auto-pubblicati saranno trattati come video regolari?

Quando si interroga media_type per i Reels pubblicati tramite API, esso restituisce VIDEO; è necessario controllare il campo media_product_type per determinare se è un Reel; si tratta di una discrepanza di campo dati, e la documentazione Meta non indica che influisce sulla distribuzione dei Reels.

Fonte delle informazioni

L'accesso alla pagina precedente è stato effettuato al numero 2026-11-11. L'interfaccia della piattaforma e le funzioni del prodotto potrebbero essere modificate, fare riferimento alla documentazione ufficiale.