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 a partir de três edges da Graph API: /{page-id}/feed devolve o feed da Página, incluindo publicações de visitantes e publicações públicas que marcam a Página, /{page-id}/posts devolve as próprias publicações da Página, e /{page-id}/published_posts devolve as publicadas. Um pedido devolve até 100 publicações; as páginas seguintes chegam por cursor, e a Meta devolve cerca de 600 publicações publicadas e ordenadas por relevância 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.
O número máximo de publicações que um pedido pode ler com limit; pedir mais devolve um erro.
Publicações publicadas e ordenadas por relevância, por ano, que a API devolve ao ler as publicações de uma Página.
Campo que separa as publicações publicadas das não publicadas, que o edge feed devolve em conjunto.
O edge da Página para onde aponta a referência do feed da Meta, para listar os Reels publicados numa Página.
Ligação de paginação a seguir até deixar de aparecer; uma página curta ou vazia não assinala 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?
Quem escreveu a publicação e se já foi publicada. A referência de Página da Meta descreve assim os três edges principais e os três mais restritos. O feed devolve também publicações não publicadas ao lado das publicadas, que is_published distingue:
Que campos vale a pena pedir?
Indique-os em fields: o exemplo da própria Meta para ler as publicações de uma Página devolve id, created_time e message. A referência Page Post da Meta lista estes entre os campos de uma publicação:
- id, message e
created_time: a publicação, 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 partilhada.
- attachments, comments e reactions, que são edges e não campos simples.
Como se obtêm as contagens de reações e comentários?
Com a expansão de campos na leitura das publicações. reactions.summary(total_count) acrescenta o número de reações, e a Meta indica que as contagens de gosto incluem care. shares traz a sua própria contagem. O edge comments devolve total_count quando se pede summary, valor que a Meta diz poder ser superior aos comentários devolvidos, por causa da privacidade ou de eliminações.
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 as ligações next e previous; siga next até deixar de aparecer. A Meta alerta para não tratar como fim uma página com menos resultados do que limit, pois uma página pode até estar vazia e ainda trazer next. Os cursores podem tornar-se inválidos rapidamente à medida que se acrescentam ou eliminam itens, por isso, para um intervalo a que volta, use since e until.
Que limites se aplicam?
A referência de feed da Meta define estes limites para a leitura das publicações de uma Página:
- 100 publicações por pedido com limit; um valor superior devolve um erro a pedir que não se ultrapassem as 100.
- Cerca de 600 publicações publicadas e ordenadas por relevância por ano.
- O conteúdo de uma publicação expirada já não pode ser visto através da Graph API.
- Listar publicações de vídeo exige que quem faz o pedido seja administrador da Página.
- Uma publicação que partilha a de outra pessoa pode não ser visível se a original não for visível para o token utilizado.
- Os dados das pessoas só aparecem nas respostas quando o pedido usa um token de acesso à Página.
Onde se listam os Reels e as 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 numa Página, e GET /{page-id}/video_reels lista-os com since e until. GET /{page-id}/stories lista as stories da Página como PUBLISHED ou ARCHIVED, sendo as arquivadas apenas enquanto o arquivo de stories da Página estiver ativado.
O que devolve list_social_posts para uma Página?
As publicações recentes da Página a partir de /{page-id}/posts, 25 por predefinição e até 100 por chamada, cada uma com id, message, created_time, permalink_url e full_picture, juntamente com os cursores de paginação da Meta. 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 se listam as publicações feitas através da easyCoexistence?
Com list_scheduled_posts, que lista as publicações feitas através da easyCoexistence, já publicadas ou agendadas: as próximas primeiro, por estado, ou uma só por post_id. Cada uma traz o seu estado (scheduled, publishing, processing, published, failed ou canceled), publish_at, a ligação quando já está no ar e o erro, se falhou. O ecrã de Publicações do painel mostra-as em Requer atenção, Próximas e Publicadas.
Erros comuns
- Esperar contagens de list_social_posts. Este lê o texto, a hora, a ligação e a 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. Este devolve também as de visitantes, as 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 apenas quando a ligação next desaparecer, pois a Meta diz que uma página pode estar vazia e ainda ter uma.
- Guardar cursores para mais tarde. A Meta diz que podem tornar-se inválidos rapidamente à medida que publicações são acrescentadas ou eliminadas; guarde antes os valores since e until.
list_scheduled_posts acompanha o que foi enviado através da easyCoexistence. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
O edge feed inclui publicações agendadas?
Devolve publicações publicadas e não publicadas em conjunto, por isso leia is_published para as distinguir, ou use GET /{page-id}/scheduled_posts para as que estão marcadas para mais tarde.
A API pode listar as publicações de outra Página?
Só com a funcionalidade Page Public Content Access da Meta e um token de acesso de utilizador. A easyCoexistence lê as Páginas que liga, com os respetivos tokens de Página.
Como obtenho publicações de um intervalo de datas?
Acrescente since e until à leitura, como timestamps UNIX ou valores strtotime; o guia de paginação da Meta recomenda ambos para resultados consistentes.
Quanto custa a easyCoexistence para uma Página do Facebook?
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos; cada Página ligada conta como uma ligação.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em