IT
Guida per sviluppatori

API post Facebook: pubblicare, modificare e leggere post dalla vostra app

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.

La tua app Connesso
Pubblica comeFacebookNorthwind BakeryFacebookAnna Lee
Pane a lievito madre fresco ogni mattina dalle 7. Preordini aperti da venerdì.
Pubblica
Il nostro menu autunnale parte lunedìNorthwind Bakery · Pagina · OggiPubblicato
Grazie per 10 splendidi anni!Northwind Bakery · Pagina · 2 ottModificato
Di ritorno dal mercato contadinoAnna Lee · Personale · 28 setNel cestino
POSTposts PATCHposts/{id} DELETEposts/{id} 200 OK
In breve

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.

Con Unipile

Pubblicate un post Facebook in tre passaggi

  1. Collegate l'accountL'utente collega il suo account Facebook, e le Pagine che gestisce, tramite Hosted Auth. Nessuna app Meta, nessuna App Review.

  2. Create il postInviate POST /v2/{account_id}/posts con la vostra chiave in X-API-KEY e un testo o degli allegati.

  3. Modificate, eliminate o pubblicate come PaginaChiamate PATCH o DELETE sul post, oppure aggiungete post_as con l'ID di una Pagina attivata.

Definizione

Cos'è l'API post Facebook?

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.

Facebook I post nella 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.
Pages API di Meta

Come si pubblica un post su una Pagina Facebook con la Graph API?

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}"}.

1

App Meta

Creare un'app e aggiungere Facebook Login for Business.

pages_show_list
2

Autorizzazioni

Richiedere i diritti di pubblicazione, poi superare l'App Review.

pages_manage_posts
3

Page token

Ottenere il Page token dallo user token.

GET /me/accounts
4

Pubblicare

Pubblicare sul feed della Pagina con il Page token.

POST /{page_id}/feed

Autorizzazioni e task della Pagina

  • Per pubblicare. Il riferimento del feed della Pagina richiede pages_manage_posts, pages_read_engagement e pages_show_list, da parte di una persona che può svolgere il task CREATE_CONTENT sulla Pagina.
  • Per gestire i post e il loro engagement. La guida ai post della Pages API aggiunge pages_manage_engagement e pages_read_user_engagement, con i task CREATE_CONTENT, MANAGE e MODERATE.
  • Per i video. Aggiungete 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.

Parametri di un post della Pagina

ParametroA cosa serve
messageIl testo del post
linkUn URL mostrato con l'anteprima del link
publishedfalse per un post non pubblicato o programmato
scheduled_publish_timeData di pubblicazione, da 10 minuti a 30 giorni in anticipo
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

Foto 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.

Regole sui post

Cosa l'API di Meta non vi permette di fare con i post

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.

Dal 2018

Niente post sui profili personali

Meta ha tolto l'autorizzazione publish_actions alle app il 1° agosto 2018. Dettagli nei limiti dell'API Facebook ufficiale.

Dal 2024

Niente post nei Gruppi

La Groups API e publish_to_groups sono state deprecate con la Graph API v19.0 il 23 gennaio 2024.

Spesso trascurato

Modifiche solo sui post creati dalla vostra app

«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

Pubblicare, modificare ed eliminare post da un account collegato

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.

Regole sui contenuti di un post Facebook

Campo o casoRegola
text e attachmentsTesto o allegato obbligatorio. File in base64, oppure multipart per i file di grandi dimensioni
ImmaginiPiù immagini formano un album
VideoUn video per post, mai insieme a immagini
quoted_post_idCondivide un post, senza allegati
Menzioni@ seguito da un ID o da un nome utente in text
can_readanyone (predefinito) o relations_only
can_commentSolo anyone, altrimenti 400
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
Conformità

I 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.

Pagine Facebook

Come si pubblica come Pagina Facebook da un account collegato?

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.

  • Trovare l'ID della Pagina. Ogni Pagina attivata ha un'inbox chiamata PAGE_<page_id>_INBOX.
  • Attivare prima la Pagina. Pubblicare come una Pagina non attivata restituisce 403 api/insufficient_permissions.
  • Le modifiche seguono l'autore. Un post scritto da una Pagina attivata viene modificato o eliminato come quella Pagina, senza campi aggiuntivi.

I passaggi di configurazione sono nella documentazione Facebook Pages.

Pubblica come Facebook
Anna LeeSenza post_as: pubblica come profiloProfilo
Northwind Bakerypost_as: "1357020157484056"Attivata
Harbor CafePagina non attivata403
POST /v2/{account_id}/posts
{
  "text": "Hello from our Page!",
  "post_as": "1357020157484056"
}
Leggere i post

Come si recuperano i post di un profilo o di una Pagina Facebook?

Con l'API di Meta, chiamate GET /{page_id}/feed con un Page access token. Con Unipile, chiamate GET /v2/{account_id}/users/{user_id}/posts, 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.

Julia Chen · Ultimi post Facebook

Non vedo l'ora di unirmi al team di Lisbona il mese prossimo!

2 giorni fa41

Online le slide del mio intervento sugli strumenti di supporto.

30 ott18

Escursione del weekend con il team.

21 ott27
Pagina successivanext_cursor: "QVFIUm..."
GET v2/{ACCOUNT_ID}/users/{USER_ID}/posts 200 OK
Meta

Con la Graph API di Meta

Endpoint
GET/{page_id}/feed
Token
Page access token
Task sulla Pagina
Il titolare del token deve disporre di CREATE_CONTENT, MANAGE o MODERATE sulla Pagina
Autorizzazioni
pages_read_engagement e pages_read_user_content
Volume
Al massimo 100 post per richiesta con limit, e circa 600 post pubblicati e classificati all'anno
Un post
GET /{post_id}, scegliendo i fields come message, created_time o permalink_url (vedete le schede Meta qui sopra)
I post di un utente
/{user_id}/posts con un User access token e user_posts: solo i post sul diario dell'utente stesso e quelli in cui è taggato

Fonti: riferimenti Page feed, Post e User posts, v27.0, verificati il 17 nov. 2026.

Unipile

Con Unipile

Elencare i post
GET/v2/{account_id}/users/{user_id}/posts
user_id
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à
Un post
GET/v2/{account_id}/posts/{post_id}
ID del post
<author id>_<post id>
Reazioni e commenti
Elencare, aggiungere e rimuovere le reazioni a un post e gestirne i commenti (vedi l'API dei commenti Facebook), tramite lo stesso account_id
La paginazione la decide Facebook

Facebook 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.

Scelta

Pages API o account collegati: quale si adatta al vostro prodotto?

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.

CriterioPages API di MetaAccount collegato (Unipile)
Account copertiPagine gestite dagli utenti della vostra appIl profilo dell'utente e le Pagine che gestisce
Configurazione da parte vostraApp Meta, Facebook Login, App ReviewChiave API e Hosted Auth, nessuna App Review
CredenzialiUn Page token per PaginaUn account_id per utente
Post sul profilo personaleNon disponibili dal 2018Sì, come l'utente collegato
Modifica dei postSolo i post creati con la vostra appTesto di un post, tramite post_id
GruppiDeprecati nella v19.0Non supportato
StorieFuori dall'ambito di questa guidaNon supportato
Programmazionescheduled_publish_time, da 10 minuti a 30 giorniNon documentata, usate una vostra coda di job
Altri social networkSolo Pagine FacebookStessa API per LinkedIn, Instagram, WhatsApp e altri
Account coperti
Pages API di MetaPagine gestite dagli utenti della vostra app
Account collegatoIl profilo dell'utente e le Pagine che gestisce
Configurazione da parte vostra
Pages API di MetaApp Meta, Facebook Login, App Review
Account collegatoChiave API e Hosted Auth, nessuna App Review
Credenziali
Pages API di MetaUn Page token per Pagina
Account collegatoUn account_id per utente
Post sul profilo personale
Pages API di MetaNon disponibili dal 2018
Account collegatoSì, come l'utente collegato
Modifica dei post
Pages API di MetaSolo i post creati con la vostra app
Account collegatoTesto di un post, tramite post_id
Gruppi
Pages API di MetaDeprecati nella v19.0
Account collegatoNon supportato
Storie
Pages API di MetaFuori dall'ambito di questa guida
Account collegatoNon supportato
Programmazione
Pages API di Metascheduled_publish_time, da 10 minuti a 30 giorni
Account collegatoNon documentata, usate una vostra coda di job
Altri social network
Pages API di MetaSolo Pagine Facebook
Account collegatoStessa API per LinkedIn, Instagram, WhatsApp e altri

La 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.

Casi d'uso

Casi d'uso: post in CRM, strumenti social e agenti IA

L'API post Facebook dà il meglio nei prodotti in cui le persone lavorano già, con ogni utente che pubblica dai propri account.

Inbox social e strumenti per community

I community manager pubblicano e correggono i post del proprio profilo e delle proprie Pagine, accanto ai messaggi.

Attività nel CRM

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.

Agenti IA con approvazione

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.

Commissione europea
Regolamentato dall'UE Digital Markets Act (DMA)

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.

FAQ sull'API post 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