Instagram BulkPublish

API di Instagram

Pubblica, programma e gestisci Instagram dal tuo codice. Una sola REST API e una sola chiave coprono Instagram e ogni altra rete che colleghi, così scrivi l’integrazione una volta sola.

Ottieni una chiave API gratuita Leggi la documentazione API

Integrazione di Instagram con BulkPublish

Cosa copre l’API di Instagram

Tutto ciò che segue fa parte dell’API pubblicata e oggi funziona con Instagram.

Funzione	Endpoint
Crea, programma, modifica e pubblica post	`POST /api/posts`
Carica immagini e video	`POST /api/media`
Trova il prossimo slot libero nella tua coda	`GET /api/posts/queue-slot`
Crea programmazioni ricorrenti	`POST /api/schedules`
Pubblica i nuovi elementi di un feed RSS	`POST /api/rss-feeds`
Pubblica un primo commento in automatico	`platformSpecific._firstComment`
Pubblica un post come Storia	`POST /api/posts/{id}/story`
Leggi le metriche di ogni post	`GET /api/posts/{id}/metrics`
Leggi e rispondi ai commenti dei post pubblicati	`GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply`
Leggi e rispondi ai messaggi diretti	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
Controlla che la connessione funzioni	`GET /api/channels/{id}/health`
Controlla l’utilizzo del tuo piano	`GET /api/quotas/usage`

Tipi di post che puoi pubblicare su Instagram

Scegli il tipo con postTypeOverrides. Un tipo che Instagram non offre viene rifiutato prima che qualcosa finisca in coda.

Tipo di post	Media
`feed_photo` Feed Photo	Obbligatorio: 1 immagine
`feed_video` Feed Video	Obbligatorio: 1 video
`reel` Reel	Obbligatorio: 1 video
`story` Story	Obbligatorio: 1 immagine o video
`carousel` Carousel	Obbligatorio: da 2 a 10 immagini o video

Programma un post su Instagram con curl

Tre richieste: trova il tuo canale, carica il file se il post ne ha uno, poi crea il post. Sostituisci la chiave con una creata in Impostazioni, poi Chiavi API, e 12 con l’id del tuo canale.

1. Elenca i tuoi canali e annota l’id del tuo account Instagram.

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

2. Carica il file. La risposta ti dà l’id del media da usare come mediaFiles qui sotto.

curl -X POST https://app.bulkpublish.com/api/media \
  -H "Authorization: Bearer bp_your_key_here" \
  -F "file=@clip.mp4"

3. Crea il post.

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Behind the scenes of launch day",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "mediaFiles": [101],
  "postTypeOverrides": {
    "instagram": "reel"
  },
  "platformSpecific": {
    "instagram": {
      "collaborators": "bulkpublish",
      "thumbnailTimestamp": 2
    }
  }
}'

La risposta è il post creato, con il suo id e lo stato. Recuperalo più tardi con GET /api/posts/{id} per vedere com’è andata.

Opzioni di Instagram

Inviale dentro platformSpecific, sotto la chiave di Instagram.

Opzione	Cosa fa	Accetta
`collaborators`	Nomi utente da taggare come coautori	testo
`shareToStory`	Condividi anche in una Storia	vero o falso
`trialReel`	Pubblica come Reel di prova	vero o falso
`graduationStrategy`	Come un Reel di prova diventa un Reel normale	`manualauto`
`thumbnailTimestamp`	Fotogramma di copertina, in secondi dall’inizio	un numero
`coverUrl`	Immagine di copertina, da un URL pubblico	testo

Analisi di Instagram tramite API

Queste metriche tornano per ogni post di Instagram su GET /api/posts/{id}/metrics, con rilevazioni nel tempo.

Impression
Copertura
Mi piace
Commenti
Condivisioni
Salvataggi
Tasso di interazione

Commenti e messaggi

Tramite l’API puoi leggere e rispondere ai commenti dei post pubblicati e leggere e rispondere ai messaggi diretti.

Su Instagram le risposte sono accettate entro 24 ore dall’ultimo messaggio della persona.

Leggere i commenti funziona su ogni piano. Per rispondere ai commenti serve un piano a pagamento, e la casella condivisa fa parte di Pro e Business. Finché una funzione non è attiva sul tuo account, l’API risponde 403 con un codice che puoi controllare.

Accesso all’API su ogni piano

Ogni piano include le chiavi API, anche il piano Free. Ecco cosa consente ciascuno.

Piano	Chiavi API	Richieste al giorno
Free	1	30
Pro	5	5000
Business	10	50.000

Costruisci direttamente su Instagram oppure usa BulkPublish

Lavorare direttamente è una scelta sensata, soprattutto se ti serve qualcosa che BulkPublish non offre. Ecco cosa ti chiede Instagram Platform API, verificato sulla sua documentazione a ottobre 2026.

Per pubblicare serve un account professionale.
Limite documentato: 100 post pubblicati via API in 24 ore.
I media vengono scaricati da un URL pubblico che devi ospitare tu.
Un post con media richiede più chiamate: caricamento o creazione, attesa dell’elaborazione, poi pubblicazione.
I token di accesso durano circa 60 giorni, quindi ti serve un modo tuo per rinnovarli o ricollegare l’account prima che scadano.

BulkPublish mantiene la connessione per te: rinnova i token, controlla ogni post rispetto alle regole di Instagram prima che finisca in coda e segnala sul post una destinazione fallita, così il tuo codice fa una sola richiesta.

Leggi la documentazione ufficiale

Preferisci chiedere a un assistente?

Claude, ChatGPT e Cursor possono fare lo stesso tramite il server MCP per Instagram, con richieste in linguaggio naturale al posto del codice.

Vedi il server MCP per Instagram

Preferisci un calendario al codice?

Lo stesso account Instagram si può programmare dall’app, con un calendario dei contenuti e il caricamento in blocco.

Vedi il pianificatore per Instagram

Domande frequenti

Le domande più comuni sull’API di Instagram.

Esiste un’API di Instagram che posso usare senza costruire io l’integrazione?

Sì. BulkPublish espone Instagram tramite la sua REST API. Collega il tuo account Instagram una volta sola, poi pubblica, programma e gestisci tutto con una chiave. La stessa chiave vale per ogni altra rete che colleghi.

Cosa posso pubblicare su Instagram tramite l’API?

I tipi di post sono Feed Photo, Feed Video, Reel, Story e Carousel. Ognuno viene controllato rispetto alle regole sui media di Instagram prima di finire in coda, quindi una richiesta che Instagram rifiuterebbe fallisce subito con un errore chiaro.

Posso programmare i post di Instagram tramite l’API?

Sì. Invia status "scheduled" con un orario scheduledAt e un timezone, oppure chiedi prima il prossimo slot libero nella tua coda. Sono disponibili anche programmazioni ricorrenti e feed RSS.

Posso leggere le analisi di Instagram tramite l’API?

Sì. Le metriche dei singoli post includono Impression, Copertura, Mi piace, Commenti, Condivisioni, Salvataggi e Tasso di interazione, con rilevazioni nel tempo.

Posso leggere e rispondere ai commenti o ai messaggi di Instagram tramite l’API?

Sì. Puoi leggere e rispondere ai commenti dei post pubblicati e leggere e rispondere ai messaggi diretti. Per rispondere ai commenti serve un piano a pagamento, e la casella condivisa fa parte di Pro e Business.

L’API di Instagram costa extra?

No. L’accesso all’API è su ogni piano. Free include 1 chiave e 30 richieste al giorno, Pro 5 chiavi e 5000 al giorno, Business 10 chiavi e 50.000 al giorno.

Mi serve un account sviluppatore Instagram o una revisione dell’app?

Non per usare BulkPublish. Colleghi il tuo account Instagram dalla pagina Canali e pubblichi con una chiave BulkPublish. Se invece costruisci sull’API di Instagram, la sezione qui sopra elenca cosa ti chiede.

Può farlo anche un assistente IA?

Sì. La pagina del server MCP per Instagram mostra come collegare Claude, ChatGPT o Cursor e cosa chiedere.

La stessa chiave e la stessa forma di richiesta funzionano per 15 reti.