Come automatizzare la pubblicazione sui social media con l'API di BulkPublish

Nota: le funzioni e i limiti dell’API descritti in questo articolo sono stati verificati ad aprile 2026.

La maggior parte degli strumenti di programmazione social media è pensata per l’uso manuale. Apri una dashboard, componi un post, scegli le piattaforme e premi pubblica. Funziona bene quando gestisci una manciata di post a settimana.

Ma quando gestisci contenuti per più clienti, importi post da un CMS o costruisci automazioni che generano post in base a eventi esterni, hai bisogno di un’API. BulkPublish include l’accesso API su ogni piano, incluso il livello gratuito.

Cosa ti permette di fare l’API

L’API di BulkPublish è una API REST standard che copre le stesse funzioni della dashboard web:

• Creare e programmare post: componi contenuti, allega media, seleziona i canali e pubblica o programma per un orario specifico
• Caricare media: carica via codice immagini e video nella tua libreria media
• Elencare i canali: vedi quali account social sono collegati e il loro stato
• Visualizzare le analisi: estrai metriche di coinvolgimento, numero di follower e dati sulle prestazioni dei post
• Gestire le chiavi API: crea, elenca e revoca le chiavi

Tutti gli endpoint usano corpi di richiesta e risposta in JSON, con autenticazione tramite token Bearer.

Come iniziare

Passo 1: crea una chiave API

Vai su app.bulkpublish.com/developer e clicca su Genera nuova chiave. Dalle un nome (ad esempio “Server di produzione” o “Pipeline contenuti”) e scegli una scadenza. Copia subito la chiave. Viene mostrata una sola volta.

Passo 2: autentica le richieste

Aggiungi la tua chiave all’header Authorization:

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

Ogni richiesta API deve includere questo header. Le richieste senza una chiave valida restituiscono 401 Unauthorized.

Passo 3: crea il tuo primo post

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the API!",
    "channels": [{"channelId": 1, "platform": "instagram"}],
    "status": "draft"
  }'

Imposta status su "draft" per salvare senza pubblicare, su "scheduled" con un timestamp scheduledAt per programmare per dopo, oppure crea il post e poi chiama l’endpoint di pubblicazione per pubblicarlo subito.

Esempi di flussi di lavoro

Importazione in blocco da CSV

Se hai un foglio di calcolo con i contenuti (didascalia, URL immagine, piattaforma, data programmata), puoi scrivere un semplice script che legge ogni riga e crea un post tramite l’API. Carica prima i media, poi crea il post con gli ID dei media.

Integrazione con il CMS

Genera un post sui social media ogni volta che pubblichi un articolo sul blog. Il webhook del tuo CMS chiama l’API di BulkPublish con titolo, estratto e immagine in evidenza dell’articolo, e il post viene programmato automaticamente su tutti i tuoi canali collegati.

Pipeline di contenuti ricorrenti

Combina l’API con un’attività pianificata o uno strumento di automazione dei flussi di lavoro (Zapier, Make, n8n) per pubblicare contenuti a intervalli regolari da un database di contenuti o da un feed RSS.

Limiti dei piani

L’accesso API è disponibile su ogni piano. Il limite di richieste giornaliere scala con il tuo livello:

Si applicano anche limiti di burst al minuto: 60 richieste di scrittura/minuto e 300 richieste di lettura/minuto, indipendentemente dal piano. Servono a prevenire un sovraccarico accidentale dell’API ma non dovrebbero influire sull’uso normale.

Limiti di frequenza ed errori

Se superi la tua quota giornaliera, l’API restituisce 429 Too Many Requests con un messaggio che indica il tuo utilizzo attuale e il limite. Il contatore giornaliero si azzera a mezzanotte UTC.

Altre risposte comuni:

• 401 Unauthorized, chiave API non valida o scaduta
• 403 Forbidden: quota superata (ad esempio, post al giorno, limite di spazio di archiviazione)
• 400 Bad Request, campi obbligatori mancanti o input non valido

Come si confronta con la concorrenza

L’accesso API non è scontato negli strumenti di gestione social media:

• Later e SocialBee non offrono un’API pubblica a nessun prezzo
• Sprout Social limita l’accesso API al piano Advanced a 399 $ per postazione al mese
• Sendible limita le funzionalità API all’integrazione SSO white-label a partire da 315 $/mese
• Hootsuite richiede un’approvazione separata dell’account sviluppatore e un piano a pagamento a partire da 99 $/mese
• Buffer offre l’accesso API su tutti i piani, ma la loro API è attualmente in Beta con un ambito limitato (solo creazione post)

BulkPublish include un’API completa su ogni piano, senza processo di approvazione, senza periodo di attesa e senza restrizioni di ambito.

Riferimento API completo

La documentazione completa degli endpoint (con schemi di richiesta/risposta, dettagli sull’autenticazione ed esempi di payload) è disponibile su app.bulkpublish.com/docs.