EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

100

Maior número de publicações que uma requisição pode ler com limit; pedir mais retorna um erro.

About 600

Publicações ranqueadas e publicadas por ano que a API retorna ao ler as publicações de uma Página.

is_published

Campo que separa publicações publicadas das não publicadas, que o edge feed retorna juntas.

video_reels

O edge da Página que a referência de feed da Meta indica para listar os Reels publicados em uma Página.

next

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.

posts

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:

feedThe Page's feed: its own posts and links, visitors' posts and public posts tagging it
postsThe Page's own posts, a derivative of /feed
published_postsPublished posts by the Page
scheduled_postsPosts the Page scheduled to a future date
visitor_postsPublic posts published by visitors on the Page
taggedPhotos, videos and posts in which the Page is tagged

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_published e scheduled_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.

Reading posts with share and reaction counts
GET /{page-id}/posts?fields=id,message,created_time,permalink_url,shares,reactions.summary(total_count)&limit=25

Como 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.
Fazendo isso com o EasyCoexistence

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