
Guide all'integrazione
Guida all'API di LinkedIn
Guida all'API email
Guida all'API di WhatsApp
Contatta le vendite
Pubblicare, modificare, eliminare e leggere post di Facebook via API nel 2026, tramite la Pages API di Meta o gli account collegati dei vostri utenti.
posts
PATCHposts/{id}
DELETEposts/{id}
200 OK
Un'API post Facebook permette alla vostra app di pubblicare, modificare, eliminare e leggere post di Facebook con richieste HTTP. Le strade sono due: la Pages API di Meta, che pubblica solo sulle Pagine Facebook tramite un'app Meta e i Page access token, oppure un account collegato, in cui ogni utente collega il proprio account Facebook e la vostra app pubblica come il suo profilo o come una Pagina che gestisce.
Per il quadro completo della piattaforma di Meta, vedete come si combinano le API di Facebook.
Pubblicate un post Facebook in tre passaggi
Collegate l'accountL'utente collega il suo account Facebook, e le Pagine che gestisce, tramite Hosted Auth. Nessuna app Meta, nessuna App Review.
Create il postInviate POST /v2/{account_id}/posts con la vostra chiave in X-API-KEY e un testo o degli allegati.
Modificate, eliminate o pubblicate come PaginaChiamate PATCH o DELETE sul post, oppure aggiungete post_as con l'ID di una Pagina attivata.
Meta non ha alcun prodotto chiamato "Post API". I post di Facebook sono oggetti della Graph API e le app li pubblicano tramite la Pages API, che scrive solo sulle Pagine Facebook. Dal 2018 un'app di terze parti non può più pubblicare sul profilo di una persona.
In pratica, "API post Facebook", o quella che gli sviluppatori chiamano API Facebook per i post, significa chiamate della Graph API su un nodo post e sull'edge /feed di una Pagina. Nodi, edge e token: consultate la nostra panoramica sulla Facebook Graph API.
{page_id}_{post_id}Il nodo post. Il suo ID unisce l'ID dell'autore e l'ID del post./{page_id}/feedL'edge che elenca i post di una Pagina e riceve quelli nuovi.messageIl testo del post.created_timeQuando il post è stato pubblicato./{page_id}/photosL'edge per i post con foto.Inviate POST /{page_id}/feed con un message (ed eventualmente un link), usando un Page access token (vedete la guida all'API Pagine Facebook e la nostra guida al token di accesso dell'API Facebook). Meta restituisce l'ID del nuovo post come {"id": "{page_post_id}"}.
Creare un'app e aggiungere Facebook Login for Business.
pages_show_listRichiedere i diritti di pubblicazione, poi superare l'App Review.
pages_manage_postsOttenere il Page token dallo user token.
GET /me/accountsPubblicare sul feed della Pagina con il Page token.
POST /{page_id}/feedpages_manage_posts, pages_read_engagement e pages_show_list, da parte di una persona che può svolgere il task CREATE_CONTENT sulla Pagina.pages_manage_engagement e pages_read_user_engagement, con i task CREATE_CONTENT, MANAGE e MODERATE.publish_video.La richiesta e la sua risposta si trovano nelle schede Meta cURL e Meta Python del blocco di codice qui sotto, accanto alla versione Unipile.
| Parametro | A cosa serve |
|---|---|
message | Il testo del post |
link | Un URL mostrato con l'anteprima del link |
published | false per un post non pubblicato o programmato |
scheduled_publish_time | Data di pubblicazione, da 10 minuti a 30 giorni in anticipo |
false per un post non pubblicato o programmatoFoto e video. Una singola foto va su /{page_id}/photos. Per un post con più foto, caricate ogni foto su quell'edge con published=false, poi pubblicatele insieme su /{page_id}/feed con attached_media e gli ID restituiti; le foto non pubblicate vengono eliminate dopo 24 ore. I video passano dalla Video API con publish_video.
Fonti: la documentazione sui post della Pages API, la guida introduttiva alla Pages API, il riferimento del feed della Pagina e il riferimento delle foto della Pagina di Meta (Graph API v27.0). Ultima verifica: 17 novembre 2026.
Tre regole della Graph API condizionano qualsiasi progetto di pubblicazione su Facebook: le app non possono pubblicare sui profili personali, non possono pubblicare nei Gruppi e possono aggiornare solo i post della Pagina che hanno creato esse stesse.
Meta ha tolto l'autorizzazione publish_actions alle app il 1° agosto 2018. Dettagli nei limiti dell'API Facebook ufficiale.
La Groups API e publish_to_groups sono state deprecate con la Graph API v19.0 il 23 gennaio 2024.
«Un'app può aggiornare un post della Pagina solo se il post è stato creato con quell'app.»
La vostra app non può aggiornare un post scritto su facebook.com o con un altro strumento: un prodotto che modifica i post deve quindi crearli.
Gli errori che incontrerete per primi. Con la Graph API, il codice 190 indica che il token di accesso è scaduto, i codici da 200 a 299 indicano un'autorizzazione non concessa o revocata, e 4 o 17 indicano troppe chiamate. Con Unipile, pubblicare come una Pagina non attivata restituisce 403 api/insufficient_permissions.
Fonti: la documentazione sui post della Pages API, il changelog di Facebook Login, l'annuncio della Graph API v19.0 e la gestione degli errori della Graph API di Meta. Ultima verifica: 17 novembre 2026.
Con Unipile, ogni utente collega il proprio account Facebook tramite Hosted Auth e la vostra app ottiene un account_id. Si crea un post con POST /v2/{account_id}/posts, se ne modifica il testo con PATCH e lo si rimuove con DELETE. Un post eliminato finisce nel cestino, dove l'autore può ancora leggerlo per 30 giorni.
Nessuna app Meta né App Review da parte vostra: ogni chiamata invia la vostra chiave API in X-API-KEY e viene eseguita per conto dell'utente che ha collegato l'account. Le schede Meta mostrano la stessa pubblicazione con la Graph API e un Page access token, per confronto.
const BASE = "https://api.unipile.com/v2";
const headers = {
"X-API-KEY": process.env.UNIPILE_API_KEY,
"content-type": "application/json"
};
// 1. Publish a text post from the connected account
await fetch(`${BASE}/${ACCOUNT_ID}/posts`, {
method: "POST", headers,
body: JSON.stringify({ text: "Our autumn menu starts Monday." })
});
// 2. Edit its text later (media and audience are kept)
await fetch(`${BASE}/${ACCOUNT_ID}/posts/${POST_ID}`, {
method: "PATCH", headers,
body: JSON.stringify({ text: "Our autumn menu starts Monday at 7am." })
});
import os, requests
BASE = "https://api.unipile.com/v2"
headers = {"X-API-KEY": os.environ["UNIPILE_API_KEY"]}
# 1. Publish a text post from the connected account
requests.post(f"{BASE}/{ACCOUNT_ID}/posts", headers=headers,
json={"text": "Our autumn menu starts Monday."})
# 2. Edit its text later (media and audience are kept)
requests.patch(f"{BASE}/{ACCOUNT_ID}/posts/{POST_ID}", headers=headers,
json={"text": "Our autumn menu starts Monday at 7am."})
# 1. Publish a text post from the connected account
curl --request POST \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts" \
--header "X-API-KEY: {YOUR_API_KEY}" \
--header "content-type: application/json" \
--data '{ "text": "Our autumn menu starts Monday." }'
# 2. Edit its text later (media and audience are kept)
curl --request PATCH \
--url "https://api.unipile.com/v2/{ACCOUNT_ID}/posts/{POST_ID}" \
--header "X-API-KEY: {YOUR_API_KEY}" \
--header "content-type: application/json" \
--data '{ "text": "Our autumn menu starts Monday at 7am." }'
# Meta Graph API: publish to a Page with a Page access token
curl -X POST "https://graph.facebook.com/v27.0/{PAGE_ID}/feed" \
-H "Content-Type: application/json" \
-d '{
"message": "Our autumn menu starts Monday.",
"link": "https://example.com/menu",
"access_token": "{PAGE_ACCESS_TOKEN}"
}'
# Response: the ID of the new Page post
{ "id": "{PAGE_POST_ID}" }
# Read that post back with the fields you need
curl -G "https://graph.facebook.com/v27.0/{PAGE_POST_ID}" \
-d "fields=id,message,created_time,permalink_url" \
-d "access_token={PAGE_ACCESS_TOKEN}"
import os, requests
GRAPH = "https://graph.facebook.com/v27.0"
TOKEN = os.environ["PAGE_ACCESS_TOKEN"]
# Meta Graph API: publish to a Page
r = requests.post(f"{GRAPH}/{PAGE_ID}/feed", data={
"message": "Our autumn menu starts Monday.",
"link": "https://example.com/menu",
"access_token": TOKEN,
})
post_id = r.json()["id"] # {"id": "{PAGE_POST_ID}"}
# Read that post back with the fields you need
post = requests.get(f"{GRAPH}/{post_id}", params={
"fields": "id,message,created_time,permalink_url",
"access_token": TOKEN,
}).json()
Campi della richiesta in Create posts, modifica e cestino in Edit and delete posts Le schede Meta seguono la guida ai post della Pages API e il riferimento Post, v27.0, verificati il 17 nov. 2026.
| Campo o caso | Regola |
|---|---|
text e attachments | Testo o allegato obbligatorio. File in base64, oppure multipart per i file di grandi dimensioni |
| Immagini | Più immagini formano un album |
| Video | Un video per post, mai insieme a immagini |
quoted_post_id | Condivide un post, senza allegati |
| Menzioni | @ seguito da un ID o da un nome utente in text |
can_read | anyone (predefinito) o relations_only |
can_comment | Solo anyone, altrimenti 400 |
@ seguito da un ID o da un nome utente in textanyone (predefinito) o relations_onlyanyone, altrimenti 400I vostri utenti pubblicano dai propri account
Unipile non è un prodotto Meta né un Meta Partner. I vostri utenti collegano i propri account, decidono cosa pubblicare e restano vincolati ai termini di Meta.
Aggiungete post_as con l'ID di una Pagina amministrata dall'account e attivata sull'account. Non c'è un account separato da collegare: lo stesso account_id copre il profilo dell'utente e le sue Pagine.
PAGE_<page_id>_INBOX.403 api/insufficient_permissions.I passaggi di configurazione sono nella documentazione Facebook Pages.
POST /v2/{account_id}/posts
{
"text": "Hello from our Page!",
"post_as": "1357020157484056"
}
Con l'API di Meta, chiamate GET /{page_id}/feed con un Page access token. Con Unipile, chiamate GET /v2/, dove user_id è me, l'ID di una Pagina attivata o l'ID di un'altra persona o Pagina i cui post l'account collegato vede già su Facebook.
Uso tipico: l'attività recente in un CRM o in uno strumento social, per gli account collegati dai vostri utenti. La lettura dei post di altre persone resta entro ciò che l'account collegato vede già su Facebook, e avviene quando l'utente lo richiede.
Non vedo l'ora di unirmi al team di Lisbona il mese prossimo!
Online le slide del mio intervento sugli strumenti di supporto.
Escursione del weekend con il team.
next_cursor: "QVFIUm..."v2/{ACCOUNT_ID}/users/{USER_ID}/posts
200 OK
/v2/{account_id}/users/{user_id}/posts me, l'ID di una Pagina attivata o l'ID di un'altra persona o Pagina, limitatamente ai post che l'account collegato vede già/v2/{account_id}/posts/{post_id} <author id>_<post id>account_idFacebook restituisce fino a 3 post per pagina, qualunque sia il limit inviato. Seguite next_cursor per ottenere la pagina successiva; non esiste offset. Dettagli in List user posts.
La Pages API di Meta è adatta a un'app che pubblica sulle Pagine della propria azienda o su Pagine di clienti che passano dalla vostra app Meta. Un account collegato è adatto a un prodotto SaaS in cui ogni utente pubblica dal proprio profilo e dalle proprie Pagine, senza un'app Meta da parte vostra.
| Criterio | Pages API di Meta | Account collegato (Unipile) |
|---|---|---|
| Account coperti | Pagine gestite dagli utenti della vostra app | Il profilo dell'utente e le Pagine che gestisce |
| Configurazione da parte vostra | App Meta, Facebook Login, App Review | Chiave API e Hosted Auth, nessuna App Review |
| Credenziali | Un Page token per Pagina | Un account_id per utente |
| Post sul profilo personale | Non disponibili dal 2018 | Sì, come l'utente collegato |
| Modifica dei post | Solo i post creati con la vostra app | Testo di un post, tramite post_id |
| Gruppi | Deprecati nella v19.0 | Non supportato |
| Storie | Fuori dall'ambito di questa guida | Non supportato |
| Programmazione | scheduled_publish_time, da 10 minuti a 30 giorni | Non documentata, usate una vostra coda di job |
| Altri social network | Solo Pagine Facebook | Stessa API per LinkedIn, Instagram, WhatsApp e altri |
account_id per utentepost_idscheduled_publish_time, da 10 minuti a 30 giorniLa stessa connessione copre le conversazioni: scoprite l'API Facebook e Messenger di Unipile, come collegare un account Facebook personale e i prezzi dell'API Facebook Messenger.
L'API post Facebook dà il meglio nei prodotti in cui le persone lavorano già, con ogni utente che pubblica dai propri account.
I community manager pubblicano e correggono i post del proprio profilo e delle proprie Pagine, accanto ai messaggi.
Su richiesta del commerciale, la scheda di un contatto mostra gli ultimi post della persona, limitatamente a ciò che l'account collegato del commerciale vede già su Facebook.
Un agente scrive la bozza di un post, l'utente la approva e solo allora la vostra app invia il POST.
Lo stesso modello per i post funziona su altri social network: la nostra guida all'API Instagram copre l'altro social network di Meta.
Iniziate a pubblicare post Facebook dalla vostra app
Usate la Pages API di Meta per le vostre Pagine. Quando ogni utente pubblica, modifica e legge post dal proprio profilo e dalle proprie Pagine, collegate i loro account tramite Unipile: un'unica REST API.
Ogni utente collega il proprio account, senza archiviazione dei profili. Unipile non è un Meta Partner. Per saperne di più
Tutti gli endpoint dell'API Facebook in un unico posto
I post sono solo una parte del quadro. Consultate tutti gli endpoint Facebook disponibili con Unipile, dai messaggi ai profili, oppure leggete la guida completa all'API Facebook.
Risposte rapide su Pagine, foto, programmazione, modifiche, Gruppi, video e lettura dei post.
Con la Pages API di Meta, inviate POST /{page_id}/feed con un message, usando un Page access token e le autorizzazioni pages_manage_posts, pages_read_engagement e pages_show_list. Con Unipile, l'utente collega il proprio account Facebook una sola volta e voi chiamate POST /v2/{account_id}/posts con post_as impostato sull'ID di una Pagina che gestisce e ha attivato.
Con Unipile, più immagini in un post vengono mostrate come album e un post può contenere in alternativa un video, mai entrambi. Con la Pages API di Meta, le foto si pubblicano tramite l'edge /{page_id}/photos.
La Pages API di Meta sì: create il post con published impostato a false e uno scheduled_publish_time compreso tra 10 minuti e 30 giorni in anticipo, secondo la guida della Pages API (il riferimento Page feed indica 75 giorni; verificate sulla vostra versione). Unipile non documenta una programmazione nativa: conservate la data prevista in una vostra coda di job e chiamate POST /v2/{account_id}/posts al momento giusto.
Sì. Con l'API di Meta, un'app può aggiornare solo i post della Pagina che ha creato ed elimina un post con DELETE /{page_post_id}. Con Unipile, PATCH /v2/{account_id}/posts/{post_id} modifica il testo e DELETE sposta il post nel cestino, dove l'autore può leggerlo per 30 giorni.
No. Meta ha deprecato la Groups API e l'autorizzazione publish_to_groups con la Graph API v19.0 nel gennaio 2024 e nemmeno Unipile supporta la pubblicazione nei Gruppi.
Un video sì. Con Unipile, un post accetta un video, che Facebook elabora in modo asincrono. I Reel non sono documentati e le storie non sono supportate.
Con la Graph API di Meta, chiamate GET /{page_id}/feed con un Page access token e le autorizzazioni pages_read_engagement e pages_read_user_content; limit restituisce al massimo 100 post per richiesta. Con Unipile, chiamate GET /v2/{account_id}/users/{user_id}/posts con l'ID di una Pagina attivata, poi seguite next_cursor per ottenere la pagina successiva.
No. Unipile è un'azienda indipendente, non un Meta Partner, e non è sostenuta, sponsorizzata né approvata da Meta. I post pubblicati dalla vostra app provengono dagli account Facebook e dalle Pagine dei vostri utenti. Facebook è un marchio di Meta Platforms, Inc.
No. Per pubblicare o leggere post tramite Unipile, i vostri utenti collegano il proprio account Facebook, e le Pagine che gestiscono, tramite l'autenticazione ospitata. Evitate l'app Meta, le autorizzazioni di pubblicazione e l'App Review richiesti dalla strada della Pages API.
Unipile è progettata nello spirito del Digital Markets Act: ogni utente collega il proprio account e decide cosa pubblicare, e Unipile agisce per suo conto senza memorizzare i profili utente. Maggiori dettagli nella nostra pagina sul Digital Markets Act.
Sì. Ogni post che la vostra app pubblica o legge passa da un account che resta vincolato alle Condizioni d'uso di Meta. Limitatevi a usi legittimi, come pubblicare i contenuti dei vostri utenti e mostrare, su loro richiesta, i post che il loro account vede già; spam e automazioni non autorizzate possono portare alla limitazione degli account.
Avete ancora domande? Il nostro team è qui per aiutarvi.
Parla con un esperto