Listar as publicações de uma Página do Facebook pela API: feed, posts e published_posts
As publicações de uma Página do Facebook são lidas em três edges da Graph API: /{page-id}/feed retorna o feed da Página, incluindo publicações de visitantes e publicações públicas que marcam a Página, /{page-id}/posts retorna as próprias publicações da Página, e /{page-id}/published_posts retorna as publicadas. Uma requisição retorna até 100 publicações, as páginas seguintes vêm por cursor, e a Meta devolve cerca de 600 publicações publicadas e ranqueadas por ano.
A easyCoexistence lista as publicações recentes de uma Página do Facebook com list_social_posts a partir do Claude, do ChatGPT ou do seu próprio código, até 100 por chamada.
Maior número de publicações que uma requisição pode ler com limit; pedir mais retorna um erro.
Publicações ranqueadas e publicadas por ano que a API retorna ao ler as publicações de uma Página.
Campo que separa publicações publicadas das não publicadas, que o edge feed retorna juntas.
O edge da Página que a referência de feed da Meta indica para listar os Reels publicados em uma Página.
Link de paginação a seguir até que ele não apareça mais; uma página curta ou vazia não marca o fim.
As próprias publicações da Página, que a referência de Página da Meta descreve como derivadas do edge /feed.
Qual é a diferença entre feed, posts e published_posts?
De quem é a publicação e se ela já foi ao ar. A referência de Página da Meta descreve os três edges principais e os três mais específicos dessa forma, e o feed também retorna publicações não publicadas ao lado das publicadas, que is_published diferencia:
Quais campos vale pedir?
Nomeie-os em fields: o exemplo de leitura das publicações de uma Página feito pela própria Meta retorna id, created_time e message. Sua referência de Page Post lista estes entre os campos de uma publicação:
- id, message e
created_time: a publicação, seu texto e quando foi publicada. permalink_url: o endereço permanente da publicação no facebook.com.full_picture: a imagem em tamanho completo do seu anexo.status_type,is_publishedescheduled_publish_time.- shares, com a contagem de quantas vezes a publicação foi compartilhada.
- attachments, comments e reactions, que são edges e não campos simples.
Como obter as contagens de reações e comentários?
Com expansão de campos na leitura das publicações. reactions.summary(total_count) acrescenta o número de reações, e a Meta observa que as contagens de curtidas incluem care. shares traz sua própria contagem. O edge comments retorna total_count quando summary é solicitado, que a Meta diz poder superar os comentários retornados, por causa de privacidade ou exclusão.
GET /{page-id}/posts?fields=id,message,created_time,permalink_url,shares,reactions.summary(total_count)&limit=25Como funciona a paginação?
Por cursor. Cada resposta traz paging, com cursores before e after e os links next e previous; siga next até que ele não apareça mais. A Meta alerta para não tratar uma página com menos resultados que limit como o fim, já que uma página pode até vir vazia e ainda assim trazer next. Os cursores podem ficar inválidos rapidamente conforme itens são adicionados ou excluídos, então, para um intervalo ao qual você voltará, use since e until.
Quais limites se aplicam?
A referência de feed da Meta define estes para a leitura das publicações de uma Página:
- 100 publicações por requisição com limit; um valor maior retorna um erro pedindo que não se ultrapasse 100.
- Cerca de 600 publicações publicadas e ranqueadas por ano.
- O conteúdo de uma publicação expirada não pode mais ser visualizado pela Graph API.
- Listar publicações de vídeo exige que quem faz a requisição seja administrador da Página.
- Uma publicação que compartilha a de outra pessoa pode não ficar visível se a original não estiver visível para o token usado.
- Dados de pessoas aparecem nas respostas somente quando a requisição usa um token de acesso de Página.
Onde são listados os Reels e os stories?
Em edges próprios. A referência de feed da Meta aponta para o edge video_reels da Página para os Reels publicados nela, e GET /{page-id}/video_reels os lista com since e until. GET /{page-id}/stories lista os stories da Página como PUBLISHED ou ARCHIVED, sendo os arquivados apenas enquanto o arquivo de stories da Página estiver ativado.
O que list_social_posts retorna para uma Página?
As publicações recentes da Página a partir de /{page-id}/posts, 25 por padrão e até 100 por chamada, cada uma com id, message, created_time, permalink_url e full_picture, junto com os cursores de paginação da Meta. Ela não pede contagens e lê uma página de resultados: list_social_comments lê os comentários de uma publicação, e get_social_insights lê as métricas de uma publicação com o ID dela como object_id.
Como listar as publicações feitas pela easyCoexistence?
Com list_scheduled_posts, que lista as publicações feitas pela easyCoexistence, já publicadas ou agendadas: as próximas primeiro, por status, ou uma só por post_id. Cada uma traz seu status (scheduled, publishing, processing, published, failed ou canceled), publish_at, seu link quando estiver no ar e o erro, se tiver falhado. A tela de Publicações do painel as mostra em Precisa de atenção, Próximas e Publicadas.
Erros comuns
- Esperar contagens de list_social_posts. Ela lê texto, horário, link e imagem; as métricas de uma publicação vêm de get_social_insights com o ID dela como object_id.
- Ler /feed para as publicações da própria Página. Ele também retorna publicações de visitantes, publicações públicas que marcam a Página e as não publicadas; use /published_posts ou filtre por is_published.
- Tratar uma página curta como a última. Pare somente quando o link next desaparecer, já que a Meta diz que uma página pode vir vazia e ainda assim ter um.
- Guardar cursores para depois. A Meta diz que eles podem ficar inválidos rapidamente conforme publicações são adicionadas ou excluídas; guarde os valores de since e until.
list_scheduled_posts acompanha o que foi enviado pela easyCoexistence. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O edge feed inclui publicações agendadas?
Ele retorna publicações publicadas e não publicadas juntas, então leia is_published para diferenciá-las, ou use GET /{page-id}/scheduled_posts para as programadas para depois.
A API pode listar as publicações de outra Página?
Somente com o recurso Page Public Content Access da Meta e um token de acesso de Usuário. A easyCoexistence lê as Páginas que você conecta, com os próprios tokens de Página delas.
Como obter publicações de um intervalo de datas?
Adicione since e until à leitura, como timestamps UNIX ou valores strtotime; o guia de paginação da Meta recomenda os dois para resultados consistentes.
Quanto custa a easyCoexistence para uma Página do Facebook?
De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis; cada Página conectada é uma conexão.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em