通过 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 条。
单次请求通过 limit 参数最多可读取的帖子数量,请求更多会返回错误。
读取主页帖子时,API 每年返回的经过排序的已发布帖子数量。
用于区分已发布与未发布帖子的字段,feed 边会同时返回两者。
Meta 的 feed 参考文档指向的边,用于列出发布到主页的 Reels。
需持续跟随的分页链接,直到它不再出现;页面较短或为空都不代表结束。
主页自己的帖子,Meta 的 Page 参考文档将其描述为 /feed 边的派生结果。
feed、posts 与 published_posts 有什么区别?
区别在于帖子是谁发布的,以及是否已经发布。Meta 的 Page 参考文档以这种方式描述了三条主要的边和另外三条范围较窄的边;此外,feed 还会同时返回未发布的帖子,可通过 is_published 将二者区分开:
哪些字段值得请求?
在 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 表示它可能超过实际返回的评论数,原因是隐私设置或删除。
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 的值。
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 监控
验证时间