Facebook
BulkPublish
API di Facebook
Pubblica, programma e gestisci Facebook dal tuo codice. Una sola REST API e una sola chiave coprono Facebook e ogni altra rete che colleghi, così scrivi l’integrazione una volta sola.
Cosa copre l’API di Facebook
Tutto ciò che segue fa parte dell’API pubblicata e oggi funziona con Facebook.
| 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 |
| Leggi e rispondi alle recensioni | 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 Facebook
Scegli il tipo con postTypeOverrides. Un tipo che Facebook non offre viene rifiutato prima che qualcosa finisca in coda.
| Tipo di post | Media |
|---|---|
post Post | Facoltativo, fino a 10 immagini o video |
reel Reel | Obbligatorio: 1 video |
story Story | Obbligatorio: 1 immagine o video |
Programma un post su Facebook 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 Facebook.
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=@photo.jpg" 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": "Our spring range is in the shop today",
"channels": [{ "channelId": 12 }],
"status": "scheduled",
"scheduledAt": "2026-12-01T09:00:00Z",
"mediaFiles": [101],
"platformSpecific": {
"facebook": {
"shareToStory": true
}
}
}' 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 Facebook
Inviale dentro platformSpecific, sotto la chiave di Facebook.
| Opzione | Cosa fa | Accetta |
|---|---|---|
shareToStory | Condividi anche in una Storia | vero o falso |
thumbnailUrl | Immagine di copertina, da un URL pubblico | testo |
Analisi di Facebook tramite API
Queste metriche tornano per ogni post di Facebook su GET /api/posts/{id}/metrics, con rilevazioni nel tempo.
- Impression
- Copertura
- Mi piace
- Commenti
- Condivisioni
- Clic
- Visualizzazioni video
- Tasso di interazione
Commenti e messaggi
Tramite l’API puoi leggere e rispondere ai commenti dei post pubblicati, leggere e rispondere ai messaggi diretti e leggere e rispondere alle recensioni.
Su Facebook 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 Facebook oppure usa BulkPublish
Lavorare direttamente è una scelta sensata, soprattutto se ti serve qualcosa che BulkPublish non offre. Ecco cosa ti chiede Graph API for Pages, verificato sulla sua documentazione a ottobre 2026.
- Prima di pubblicare devi registrare un’app per sviluppatori presso Facebook.
- Per pubblicare come Pagina serve un token di accesso della Pagina o un ruolo su quella Pagina.
- L’API può programmare un post da sola, entro i limiti fissati dalla piattaforma.
BulkPublish mantiene la connessione per te: rinnova i token, controlla ogni post rispetto alle regole di Facebook 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 Facebook, con richieste in linguaggio naturale al posto del codice.
Vedi il server MCP per Facebook
Preferisci un calendario al codice?
Lo stesso account Facebook si può programmare dall’app, con un calendario dei contenuti e il caricamento in blocco.
Vedi il pianificatore per Facebook
Domande frequenti
Le domande più comuni sull’API di Facebook.
Esiste un’API di Facebook che posso usare senza costruire io l’integrazione?
Sì. BulkPublish espone Facebook tramite la sua REST API. Collega il tuo account Facebook 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 Facebook tramite l’API?
I tipi di post sono Post, Reel e Story. Ognuno viene controllato rispetto alle regole sui media di Facebook prima di finire in coda, quindi una richiesta che Facebook rifiuterebbe fallisce subito con un errore chiaro.
Posso programmare i post di Facebook 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 Facebook tramite l’API?
Sì. Le metriche dei singoli post includono Impression, Copertura, Mi piace, Commenti, Condivisioni, Clic, Visualizzazioni video e Tasso di interazione, con rilevazioni nel tempo.
Posso leggere e rispondere ai commenti o ai messaggi di Facebook tramite l’API?
Sì. Puoi leggere e rispondere ai commenti dei post pubblicati, leggere e rispondere ai messaggi diretti e leggere e rispondere alle recensioni. Per rispondere ai commenti serve un piano a pagamento, e la casella condivisa fa parte di Pro e Business.
L’API di Facebook 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 Facebook o una revisione dell’app?
Non per usare BulkPublish. Colleghi il tuo account Facebook dalla pagina Canali e pubblichi con una chiave BulkPublish. Se invece costruisci sull’API di Facebook, la sezione qui sopra elenca cosa ti chiede.
Può farlo anche un assistente IA?
Sì. La pagina del server MCP per Facebook mostra come collegare Claude, ChatGPT o Cursor e cosa chiedere.
Altre reti
La stessa chiave e la stessa forma di richiesta funzionano per 15 reti.
Inizia a pubblicare su Facebook dal codice
Crea un account gratuito, collega Facebook e genera una chiave. Nessuna carta richiesta.