BR
Guia para desenvolvedores

API de posts do Facebook: publique, edite e leia posts a partir do seu app

Publique, edite, exclua e leia posts do Facebook por API em 2026, pela Pages API da Meta ou pelas próprias contas conectadas dos seus usuários.

Seu app Conectado
Postar comoFacebookNorthwind BakeryFacebookAnna Lee
Pão de fermentação natural fresquinho toda manhã a partir das 7h. Encomendas abertas na sexta.
Publicar
Nosso cardápio de outono chega na segundaNorthwind Bakery · Página · HojePublicado
Obrigado por 10 anos incríveis!Northwind Bakery · Página · 2 out.Editado
De volta da feiraAnna Lee · Pessoal · 28 set.Na lixeira
POSTposts PATCHposts/{id} DELETEposts/{id} 200 OK
Resposta curta

Uma API de posts do Facebook permite que o seu app publique, edite, exclua e leia posts do Facebook com requisições HTTP. Há dois caminhos: a Pages API da Meta, que só publica em Páginas do Facebook por meio de um app da Meta e de Page access tokens, ou uma conta conectada, em que cada usuário vincula a própria conta do Facebook e o seu app publica como o perfil dele ou como uma Página que ele gerencia.

Para o panorama completo da plataforma da Meta, veja como as APIs do Facebook se encaixam.

Com a Unipile

Publique um post no Facebook em três etapas

  1. Conecte a contaO seu usuário conecta a conta do Facebook, e as Páginas que gerencia, pelo Hosted Auth. Sem app da Meta, sem App Review.

  2. Crie o postEnvie POST /v2/{account_id}/posts com a sua chave em X-API-KEY e um texto ou anexos.

  3. Edite, exclua ou publique como PáginaChame PATCH ou DELETE no post, ou adicione post_as com o ID de uma Página ativada.

Definição

O que é a API de posts do Facebook?

A Meta não tem nenhum produto chamado "Post API". Os posts do Facebook são objetos da Graph API, e os apps os publicam pela Pages API, que só escreve em Páginas do Facebook. Desde 2018, um app de terceiros não pode mais publicar no perfil pessoal de alguém.

Na prática, "API de posts do Facebook", ou o que os desenvolvedores chamam de API do Facebook para posts, significa chamadas da Graph API em um nó de post e no edge /feed de uma Página. Nós, edges e tokens: veja a nossa visão geral da Graph API do Facebook.

Facebook Posts na Graph API
{page_id}_{post_id}O nó do post. O ID dele junta o ID do autor e o ID do post.
/{page_id}/feedO edge que lista os posts de uma Página e recebe os novos.
messageO texto do post.
created_timeQuando o post foi publicado.
/{page_id}/photosO edge dos posts com foto.
Pages API da Meta

Como publicar um post em uma Página do Facebook com a Graph API?

Envie POST /{page_id}/feed com um message (e, opcionalmente, um link), usando um Page access token (veja o guia da API de Páginas do Facebook e o nosso guia sobre o token de acesso da API do Facebook). A Meta retorna o ID do novo post como {"id": "{page_post_id}"}.

1

App da Meta

Crie um app e adicione o Facebook Login for Business.

pages_show_list
2

Permissões

Solicite os direitos de publicação e depois passe pelo App Review.

pages_manage_posts
3

Token de Página

Obtenha o token de Página a partir do token de usuário.

GET /me/accounts
4

Publicar

Publique no feed da Página com o token de Página.

POST /{page_id}/feed

Permissões e tarefas de Página

  • Para publicar. A referência do feed de Página exige pages_manage_posts, pages_read_engagement e pages_show_list, concedidas por alguém que possa executar a tarefa CREATE_CONTENT na Página.
  • Para gerenciar os posts e o engajamento deles. O guia de posts da Pages API acrescenta pages_manage_engagement e pages_read_user_engagement, com as tarefas CREATE_CONTENT, MANAGE e MODERATE.
  • Para vídeo. Adicione publish_video.

A requisição e a resposta estão nas abas Meta cURL e Meta Python do bloco de código abaixo, ao lado da versão da Unipile.

Parâmetros de um post de Página

ParâmetroO que faz
messageO texto do post
linkUma URL exibida com prévia do link
publishedfalse para um post não publicado ou agendado
scheduled_publish_timeData de publicação, de 10 minutos a 30 dias à frente
message
O texto do post
link
Uma URL exibida com prévia do link
published
false para um post não publicado ou agendado
scheduled_publish_time
Data de publicação, de 10 minutos a 30 dias à frente

Fotos e vídeo. Uma única foto vai para /{page_id}/photos. Para um post com várias fotos, envie cada foto para esse edge com published=false e depois publique todas juntas em /{page_id}/feed com attached_media e os IDs retornados; as fotos não publicadas são excluídas após 24 horas. Os vídeos passam pela Video API com publish_video.

Fonte da Meta: documentação de posts da Pages API, primeiros passos com a Pages API, a referência do feed de Página e a referência de fotos de Página (Graph API v27.0). Última verificação: 17 de novembro de 2026.

Regras de posts

O que a API da Meta não deixa você fazer com os posts

Três regras da Graph API definem qualquer projeto de publicação no Facebook: os apps não podem publicar em perfis pessoais, não podem publicar em Grupos e só podem atualizar os posts de Página que eles mesmos criaram.

Desde 2018

Nada de posts em perfis pessoais

A Meta retirou a permissão publish_actions dos apps em 1º de agosto de 2018. Detalhes nos limites da API oficial do Facebook.

Desde 2024

Nada de posts em Grupos

A Groups API e a publish_to_groups foram descontinuadas com a Graph API v19.0 em 23 de janeiro de 2024.

Muitas vezes esquecido

Edição só dos posts do seu próprio app

"Um app só pode atualizar um post de Página se o post tiver sido feito com esse app."

O seu app não pode atualizar um post escrito no facebook.com ou por outra ferramenta, então um produto que edita posts precisa criá-los.

Os primeiros erros que você vai encontrar. Com a Graph API, o código 190 significa que o token de acesso expirou, os códigos 200 a 299 significam que uma permissão não foi concedida ou foi removida, e 4 ou 17 significam chamadas demais. Com a Unipile, publicar como uma Página não ativada retorna 403 api/insufficient_permissions.

Fontes da Meta: documentação de posts da Pages API, changelog do Facebook Login, anúncio da Graph API v19.0 e tratamento de erros da Graph API. Última verificação: 17 de novembro de 2026.

Com a Unipile

Publicar, editar e excluir posts a partir de uma conta conectada

Com a Unipile, cada usuário conecta a conta do Facebook pelo Hosted Auth, e o seu app recebe um account_id. Você cria um post com POST /v2/{account_id}/posts, altera o texto com PATCH e o remove com DELETE. Um post excluído vai para a lixeira, onde o autor ainda pode lê-lo por 30 dias.

Sem app da Meta nem App Review do seu lado: cada chamada envia a sua chave de API em X-API-KEY e é executada em nome do usuário que conectou a conta. As abas Meta mostram a mesma publicação com a Graph API e um Page access token, para comparação.

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()

Os campos da requisição estão em Create posts, a edição e a lixeira em Edit and delete posts. As abas Meta seguem o guia de posts da Pages API e a referência de Post, v27.0, verificados em 17 de nov. de 2026.

Regras de conteúdo de um post do Facebook

Campo ou casoRegra
text e attachmentsTexto ou anexo obrigatório. Arquivos em base64, ou multipart para arquivos grandes
ImagensVárias imagens formam um álbum
VídeoUm vídeo por post, nunca misturado com imagens
quoted_post_idCompartilha um post, sem anexos
Menções@ mais um ID ou nome de usuário em text
can_readanyone (padrão) ou relations_only
can_commentSó anyone; caso contrário, 400
text e attachments
Texto ou anexo obrigatório. Arquivos em base64, ou multipart para arquivos grandes
Imagens
Várias imagens formam um álbum
Vídeo
Um vídeo por post, nunca misturado com imagens
quoted_post_id
Compartilha um post, sem anexos
Menções
@ mais um ID ou nome de usuário em text
can_read
anyone (padrão) ou relations_only
can_comment
Só anyone; caso contrário, 400
Conformidade

Os seus usuários publicam a partir das próprias contas

A Unipile não é um produto da Meta nem um Meta Partner. Os seus usuários conectam as próprias contas, decidem o que é publicado e continuam sujeitos aos termos da Meta.

Páginas do Facebook

Como postar como Página do Facebook a partir de uma conta conectada?

Adicione post_as com o ID de uma Página que a conta administra e que está ativada na conta. Não há uma conta separada para conectar: o mesmo account_id cobre o perfil do usuário e as Páginas dele.

  • Encontre o ID da Página. Cada Página ativada tem uma caixa de entrada chamada PAGE_<page_id>_INBOX.
  • Ative a Página primeiro. Postar como uma Página não ativada retorna 403 api/insufficient_permissions.
  • As edições seguem o autor. Um post escrito por uma Página ativada é editado ou excluído como essa Página, sem campo extra.

As etapas de configuração estão na documentação de Páginas do Facebook.

Postar como Facebook
Anna LeeSem post_as: posta como o perfilPerfil
Northwind Bakerypost_as: "1357020157484056"Ativada
Harbor CafePágina não ativada403
POST /v2/{account_id}/posts
{
  "text": "Hello from our Page!",
  "post_as": "1357020157484056"
}
Ler posts

Como obter os posts de um perfil ou de uma Página do Facebook?

Com a API da Meta, chame GET /{page_id}/feed com um Page access token. Com a Unipile, chame GET /v2/{account_id}/users/{user_id}/posts, em que user_id é me, o ID de uma Página ativada ou o ID de outra pessoa ou Página cujos posts a conta conectada já consegue ver no Facebook.

Uso típico: atividade recente em um CRM ou ferramenta social, para as contas que os seus usuários conectaram. A leitura dos posts de outra pessoa fica limitada ao que a conta conectada já vê no Facebook e acontece quando o usuário pede.

Julia Chen · Posts recentes Facebook

Animada para entrar no time de Lisboa no mês que vem!

Há 2 dias41

Os slides da minha palestra sobre ferramentas de suporte já estão no ar.

30 out.18

Trilha de fim de semana com o time.

21 out.27
Próxima páginanext_cursor: "QVFIUm..."
GET v2/{ACCOUNT_ID}/users/{USER_ID}/posts 200 OK
Meta

Com a Graph API da Meta

Endpoint
GET/{page_id}/feed
Token
Page access token
Tarefa na Página
O titular do token precisa de CREATE_CONTENT, MANAGE ou MODERATE na Página
Permissões
pages_read_engagement e pages_read_user_content
Volume
No máximo 100 posts por requisição com limit, e cerca de 600 posts publicados e ranqueados por ano
Um post
GET /{post_id}, escolhendo fields como message, created_time ou permalink_url (veja as abas Meta acima)
Os posts de um usuário
/{user_id}/posts com um User access token e user_posts: apenas os posts na própria linha do tempo desse usuário e os posts em que ele foi marcado

Fontes: referências Page feed, Post e User posts, v27.0, verificadas em 17 de nov. de 2026.

Unipile

Com a Unipile

Listar posts
GET/v2/{account_id}/users/{user_id}/posts
user_id
me, o ID de uma Página ativada ou o ID de outra pessoa ou Página, limitado aos posts que a conta conectada já consegue ver
Um post
GET/v2/{account_id}/posts/{post_id}
ID do post
<author id>_<post id>
Reações e comentários
Liste, adicione e remova reações em um post e trabalhe com os comentários dele (veja a API de comentários do Facebook) pelo mesmo account_id
A paginação é definida pelo Facebook

O Facebook retorna até 3 posts por página, seja qual for o limit enviado. Siga next_cursor para obter a próxima página; não existe offset. Detalhes em List user posts.

Decisão

Pages API ou contas conectadas: qual combina com o seu produto?

A Pages API da Meta serve para um app que publica nas Páginas da própria empresa ou em Páginas de clientes que passam pelo seu app da Meta. Uma conta conectada serve para um produto SaaS em que cada usuário publica a partir do próprio perfil e das próprias Páginas, sem app da Meta do seu lado.

CritérioPages API da MetaConta conectada (Unipile)
Contas cobertasPáginas que os usuários do seu app gerenciamO perfil do usuário e as Páginas que ele gerencia
Configuração do seu ladoApp da Meta, Facebook Login, App ReviewChave de API e Hosted Auth, sem App Review
CredenciaisUm token de Página por PáginaUm account_id por usuário
Posts no perfil pessoalIndisponível desde 2018Sim, como o usuário conectado
Edição de postsSó os posts feitos com o seu appTexto de um post, por post_id
GruposDescontinuada na v19.0Não suportado
StoriesFora do escopo deste guiaNão suportado
Agendamentoscheduled_publish_time, de 10 minutos a 30 diasNão documentado; use a sua própria fila de jobs
Outras redesSó Páginas do FacebookA mesma API para LinkedIn, Instagram, WhatsApp e outras
Contas cobertas
Pages API da MetaPáginas que os usuários do seu app gerenciam
Conta conectadaO perfil do usuário e as Páginas que ele gerencia
Configuração do seu lado
Pages API da MetaApp da Meta, Facebook Login, App Review
Conta conectadaChave de API e Hosted Auth, sem App Review
Credenciais
Pages API da MetaUm token de Página por Página
Conta conectadaUm account_id por usuário
Posts no perfil pessoal
Pages API da MetaIndisponível desde 2018
Conta conectadaSim, como o usuário conectado
Edição de posts
Pages API da MetaSó os posts feitos com o seu app
Conta conectadaTexto de um post, por post_id
Grupos
Pages API da MetaDescontinuada na v19.0
Conta conectadaNão suportado
Stories
Pages API da MetaFora do escopo deste guia
Conta conectadaNão suportado
Agendamento
Pages API da Metascheduled_publish_time, de 10 minutos a 30 dias
Conta conectadaNão documentado; use a sua própria fila de jobs
Outras redes
Pages API da MetaSó Páginas do Facebook
Conta conectadaA mesma API para LinkedIn, Instagram, WhatsApp e outras

A mesma conexão cobre as conversas: veja a API do Facebook e do Messenger da Unipile, como conectar uma conta pessoal do Facebook e os preços da API do Facebook Messenger.

Casos de uso

Casos de uso: posts dentro de CRMs, ferramentas sociais e agentes de IA

A API de posts do Facebook rende mais dentro dos produtos em que as pessoas já trabalham, com cada usuário publicando a partir das próprias contas.

Inbox social e ferramentas de comunidade

Os community managers publicam e corrigem posts do perfil e das Páginas deles, ao lado das mensagens.

Atividade no CRM

Quando o vendedor pede, uma ficha de contato mostra os posts mais recentes da pessoa, limitados ao que a conta conectada do vendedor já vê no Facebook.

Agentes de IA com aprovação

Um agente redige um post, o usuário o aprova e só então o seu app envia o POST.

O mesmo modelo de posts funciona para outras redes: o nosso guia da API do Instagram cobre a outra rede da Meta.

Comece a publicar posts do Facebook a partir do seu app

Use a Pages API da Meta para as suas próprias Páginas. Quando cada usuário publica, edita e lê posts a partir do próprio perfil e das próprias Páginas, conecte as contas deles pela Unipile: uma única API REST.

Comissão Europeia
Regulamentado pela UE Digital Markets Act (DMA)

Cada usuário conecta a própria conta, sem armazenamento de perfis. A Unipile não é Meta Partner. Saiba mais

Todos os endpoints da API do Facebook em um só lugar

Os posts são só uma parte do panorama. Veja todos os endpoints do Facebook disponíveis com a Unipile, de mensagens a perfis, ou leia o guia completo da API do Facebook.

Perguntas frequentes sobre a API de posts do Facebook

Respostas rápidas sobre Páginas, fotos, agendamento, edições, Grupos, vídeo e leitura de posts.

Com a Pages API da Meta, envie POST /{page_id}/feed com um message, usando um Page access token e as permissões pages_manage_posts, pages_read_engagement e pages_show_list. Com a Unipile, o usuário conecta a conta do Facebook uma única vez e você chama POST /v2/{account_id}/posts com post_as definido como o ID de uma Página que ele gerencia e ativou.

Com a Unipile, várias imagens em um post são exibidas como um álbum, e um post pode levar um vídeo no lugar delas, nunca os dois. Com a Pages API da Meta, as fotos são publicadas pelo edge /{page_id}/photos.

A Pages API da Meta permite: crie o post com published definido como false e um scheduled_publish_time entre 10 minutos e 30 dias à frente, segundo o guia da Pages API (a referência do Page feed fala em 75 dias; teste na sua versão). A Unipile não documenta agendamento nativo, então guarde a data planejada na sua própria fila de jobs e chame POST /v2/{account_id}/posts na hora certa.

Sim. Com a API da Meta, um app só pode atualizar os posts de Página que ele criou e exclui um post com DELETE /{page_post_id}. Com a Unipile, PATCH /v2/{account_id}/posts/{post_id} altera o texto e DELETE move o post para a lixeira, onde o autor pode lê-lo por 30 dias.

Não. A Meta descontinuou a Groups API e a permissão publish_to_groups com a Graph API v19.0 em janeiro de 2024, e a Unipile também não oferece publicação em Grupos.

Você pode publicar um vídeo. Com a Unipile, um post leva um vídeo, que o Facebook processa de forma assíncrona. Os Reels não são documentados e os Stories não são suportados.

Com a Graph API da Meta, chame GET /{page_id}/feed com um Page access token e as permissões pages_read_engagement e pages_read_user_content; limit retorna no máximo 100 posts por requisição. Com a Unipile, chame GET /v2/{account_id}/users/{user_id}/posts com o ID de uma Página ativada e depois siga next_cursor para obter a próxima página.

Não. A Unipile é uma empresa independente, não um Meta Partner, e não é endossada, patrocinada nem aprovada pela Meta. Os posts que o seu app publica vêm das próprias contas e Páginas do Facebook dos seus usuários. Facebook é uma marca registrada da Meta Platforms, Inc.

Não. Para publicar ou ler posts pela Unipile, os seus usuários conectam a própria conta do Facebook, e as Páginas que gerenciam, pela autenticação hospedada. Você dispensa o app da Meta, as permissões de publicação e o App Review que o caminho da Pages API exige.

A Unipile foi projetada no espírito do Digital Markets Act: cada usuário conecta a própria conta e decide o que é publicado, e a Unipile age em nome dele sem armazenar perfis de usuários. Saiba mais na nossa página sobre o Digital Markets Act.

Sim. Cada post que o seu app publica ou lê passa por uma conta que continua sujeita aos Termos de Serviço da Meta. Mantenha-se em usos legítimos, como publicar o conteúdo dos próprios usuários e mostrar os posts que a conta deles já vê quando eles pedem; spam e automação não autorizada podem levar à restrição das contas.

Ainda tem dúvidas? Nossa equipe está aqui para ajudar.

Fale com um especialista