登录开始免费试用
easyCoexistence 官方 API

通过 API 列出 Facebook 主页的帖子:feed、posts 与 published_posts

Facebook 主页的帖子通过三条 Graph API 边读取:/{page-id}/feed 返回主页的 feed,包括访客发布的帖子和标记了该主页的公开帖子;/{page-id}/posts 返回主页自己的帖子;/{page-id}/published_posts 返回其已发布的帖子。每次请求最多返回 100 条帖子,后续页面通过游标获取。Meta 每年约返回 600 条经过排序的已发布帖子。

easyCoexistence 可通过 Claude、ChatGPT 或您自己的代码,使用 list_social_posts 列出 Facebook 主页最近的帖子,每次调用最多 100 条。

100

单次请求通过 limit 参数最多可读取的帖子数量,请求更多会返回错误。

About 600

读取主页帖子时,API 每年返回的经过排序的已发布帖子数量。

is_published

用于区分已发布与未发布帖子的字段,feed 边会同时返回两者。

video_reels

Meta 的 feed 参考文档指向的边,用于列出发布到主页的 Reels。

next

需持续跟随的分页链接,直到它不再出现;页面较短或为空都不代表结束。

posts

主页自己的帖子,Meta 的 Page 参考文档将其描述为 /feed 边的派生结果。

feed、posts 与 published_posts 有什么区别?

区别在于帖子是谁发布的,以及是否已经发布。Meta 的 Page 参考文档以这种方式描述了三条主要的边和另外三条范围较窄的边;此外,feed 还会同时返回未发布的帖子,可通过 is_published 将二者区分开:

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

哪些字段值得请求?

在 fields 参数中指定字段。Meta 自己的示例中,读取主页帖子会返回 id、created_time 和 message。其 Page Post 参考文档在帖子的字段中列出了以下内容:

  • id、message 和 created_time:帖子本身、其文本以及发布时间。
  • permalink_url:帖子在 facebook.com 上的永久地址。
  • full_picture:附件中的原尺寸图片。
  • status_type、is_published 和 scheduled_publish_time。
  • shares:帖子被分享的次数统计。
  • attachments、comments 和 reactions,它们是边而非普通字段。

反应和评论数量如何获取?

在读取帖子时使用字段展开。reactions.summary(total_count) 会加上反应的数量,Meta 提示点赞数包含“关心”反应。shares 自带计数。请求 summary 时,comments 边会返回 total_count,Meta 表示它可能超过实际返回的评论数,原因是隐私设置或删除。

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

分页如何运作?

通过游标。每个响应都包含 paging,其中有 before 和 after 游标以及 next 和 previous 链接;持续跟随 next,直到它不再出现。Meta 提醒不要把结果数少于 limit 的页面视为结尾,因为页面甚至可能为空,但仍带有 next。随着项目的添加或删除,游标可能很快失效,因此如果需要重复访问某个时间范围,请使用 since 和 until。

有哪些限制?

Meta 的 feed 参考文档为读取主页帖子设定了以下限制:

  • 使用 limit 时每次请求最多 100 条帖子;更大的值会返回错误,提示不得超过 100。
  • 每年约 600 条经过排序的已发布帖子。
  • 已过期的帖子,其内容无法再通过 Graph API 查看。
  • 列出视频帖子要求发出请求的人是该主页的管理员。
  • 分享他人帖子的帖子,如果原帖对所使用的访问令牌不可见,则可能无法看到。
  • 只有当请求使用 Page 访问令牌时,响应中才会出现用户的详细信息。

Reels 和 stories 在哪里列出?

各自有独立的边。Meta 的 feed 参考文档指出,发布到主页的 Reels 应使用主页的 video_reels 边,GET /{page-id}/video_reels 可通过 since 和 until 列出它们。GET /{page-id}/stories 以 PUBLISHED 或 ARCHIVED 状态列出主页的 stories,已归档的 stories 仅在主页的 story 归档功能开启时才会列出。

list_social_posts 为主页返回什么?

它从 /{page-id}/posts 返回主页最近的帖子,默认 25 条,每次调用最多 100 条,每条包含 id、message、created_time、permalink_url 和 full_picture,并附带 Meta 的分页游标。它不请求计数,也只读取一页结果:list_social_comments 读取帖子的评论,get_social_insights 则以帖子的 ID 作为 object_id 读取其指标。

如何列出通过 easyCoexistence 发布的帖子?

使用 list_scheduled_posts,它会列出通过 easyCoexistence 已发布或已排期的帖子:可按即将发布的先后顺序列出,可按状态筛选,也可按 post_id 列出单条。每条帖子都包含其状态(scheduled, publishing, processing, published, failed, canceled)、publish_at、上线后的链接,以及发布失败时的错误。控制台的“帖子”页面会将它们分为“需要关注”、“即将发布”和“已发布”。

常见错误

  • 期望从 list_social_posts 获取计数。它只读取文本、时间、链接和图片;帖子的指标需通过 get_social_insights 获取,并以帖子的 ID 作为 object_id。
  • 用 /feed 读取主页自己的帖子。它还会返回访客的帖子、标记了主页的公开帖子以及未发布的帖子;请使用 /published_posts,或按 is_published 过滤。
  • 把较短的页面当作最后一页。只有当 next 链接消失时才停止,因为 Meta 表示页面可能为空,却仍带有该链接。
  • 把游标留到以后再用。Meta 表示,随着帖子的添加或删除,游标可能很快失效;请改为保存 since 和 until 的值。
使用 EasyCoexistence 完成这些操作

list_scheduled_posts 用于跟踪通过 easyCoexistence 发出的帖子。每个连接每月 US$ 9 至 US$ 0.75,随连接数量增加而降低,前 3 天免费试用。

常见问题

feed 边是否包含已排期的帖子?

它会同时返回已发布和未发布的帖子,因此请读取 is_published 来区分,或使用 GET /{page-id}/scheduled_posts 获取设定为稍后发布的帖子。

API 能否列出其他主页的帖子?

只有在使用 Meta 的 Page Public Content Access 功能和用户访问令牌时才可以。easyCoexistence 读取您所连接的主页,并使用其各自的 Page 访问令牌。

如何获取某个日期范围内的帖子?

在读取时添加 since 和 until,可使用 UNIX 时间戳或 strtotime 值;Meta 的分页指南建议两者都使用,以获得一致的结果。

easyCoexistence 为一个 Facebook 主页收费多少?

每个连接每月 US$ 9 至 US$ 0.75,随连接数量增加而降低,前 3 天免费试用;每个已连接的主页算作一个连接。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间