Iniciar sessãoIniciar teste gratuito
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 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.

100

O número máximo de publicações que um pedido pode ler com limit; pedir mais devolve um erro.

About 600

Publicações publicadas e ordenadas por relevância, por ano, que a API devolve ao ler as publicações de uma Página.

is_published

Campo que separa as publicações publicadas das não publicadas, que o edge feed devolve em conjunto.

video_reels

O edge da Página para onde aponta a referência do feed da Meta, para listar os Reels publicados numa Página.

next

Ligação de paginação a seguir até deixar de aparecer; uma página curta ou vazia não assinala 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?

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:

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

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

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 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.
Fazer isto com a EasyCoexistence

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