Listing a Facebook Page's posts through the API: feed, posts and published_posts
A Facebook Page's posts are read from three Graph API edges: /{page-id}/feed returns the Page's feed, including visitors' posts and public posts that tag the Page, /{page-id}/posts returns the Page's own posts, and /{page-id}/published_posts returns its published ones. A request returns up to 100 posts, later pages come by cursor, and Meta returns about 600 ranked, published posts a year.
easyCoexistence lists a Facebook Page's recent posts with list_social_posts from Claude, ChatGPT or your own code, up to 100 per call.
Most posts one request can read with limit; asking for more returns an error.
Ranked, published posts per year the API returns when reading a Page's posts.
Field that separates published from unpublished posts, which the feed edge returns together.
The Page edge Meta's feed reference points to for listing the Reels published to a Page.
Paging link to follow until it no longer appears; a short or empty page does not mark the end.
The Page's own posts, which Meta's Page reference describes as a derivative of the /feed edge.
What is the difference between feed, posts and published_posts?
Who wrote the post and whether it is out yet. Meta's Page reference describes the three main edges and three narrower ones this way, and the feed also returns unpublished posts beside published ones, which is_published tells apart:
Which fields are worth asking for?
Name them in fields: Meta's own example read of a Page's posts comes back with id, created_time and message. Its Page Post reference lists these among a post's fields:
- id, message and
created_time: the post, its text and when it was published. permalink_url: the permanent address of the post on facebook.com.full_picture: the full-size picture from its attachment.status_type,is_publishedandscheduled_publish_time.- shares, with a count of how many times the post was shared.
- attachments, comments and reactions, which are edges rather than plain fields.
How do you get reaction and comment counts?
With field expansion on the posts read. reactions.summary(total_count) adds the number of reactions, and Meta notes that like counts include care. shares carries its own count. The comments edge returns total_count when summary is requested, which Meta says can exceed the comments returned, because of privacy or deletion.
GET /{page-id}/posts?fields=id,message,created_time,permalink_url,shares,reactions.summary(total_count)&limit=25How does pagination work?
By cursor. Each response carries paging, with before and after cursors and next and previous links; follow next until it no longer appears. Meta warns not to treat a page holding fewer results than limit as the end, since a page can even be empty and still carry next. Cursors can quickly become invalid as items are added or deleted, so for a range you come back to, use since and until.
What limits apply?
Meta's feed reference sets these for reading a Page's posts:
- 100 posts per request with limit; a larger value returns an error asking not to exceed 100.
- About 600 ranked, published posts per year.
- An expired post's content can no longer be viewed through the Graph API.
- Listing video posts requires that the person making the request be an admin of the Page.
- A post sharing someone else's may not be visible if the original is not visible to the token used.
- People's details appear in responses only when the request uses a Page access token.
Where are Reels and stories listed?
On edges of their own. Meta's feed reference points to the Page's video_reels edge for the Reels published to a Page, and GET /{page-id}/video_reels lists them with since and until. GET /{page-id}/stories lists the Page's stories as PUBLISHED or ARCHIVED, the archived ones only while the Page's story archive is on.
What does list_social_posts return for a Page?
The Page's recent posts from /{page-id}/posts, 25 by default and up to 100 per call, each with id, message, created_time, permalink_url and full_picture, together with Meta's paging cursors. It asks for no counts and reads one page of results: list_social_comments reads a post's comments, and get_social_insights reads a post's metrics with its ID as object_id.
How do you list the posts made through easyCoexistence?
With list_scheduled_posts, which lists the posts made through easyCoexistence, posted now or scheduled: upcoming ones soonest first, by status, or one by post_id. Each carries its status (scheduled, publishing, processing, published, failed or canceled), publish_at, its link once live and the error if it failed. The dashboard's Posts screen shows them under Needs attention, Coming up and Published.
Common mistakes
- Expecting counts from list_social_posts. It reads text, time, link and picture; a post's metrics come from get_social_insights with its ID as object_id.
- Reading /feed for the Page's own posts. It also returns visitors' posts, public posts that tag the Page and unpublished ones; use /published_posts, or filter on is_published.
- Treating a short page as the last one. Stop only when the next link disappears, since Meta says a page can be empty and still have one.
- Saving cursors for later. Meta says they can quickly become invalid as posts are added or deleted; keep since and until values instead.
list_scheduled_posts follows what went out through easyCoexistence. US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Does the feed edge include scheduled posts?
It returns published and unpublished posts together, so read is_published to tell them apart, or GET /{page-id}/scheduled_posts for the ones set for later.
Can the API list another Page's posts?
Only with Meta's Page Public Content Access feature and a User access token. easyCoexistence reads the Pages you connect, with their own Page tokens.
How do I get posts from a date range?
Add since and until to the read, as UNIX timestamps or strtotime values; Meta's pagination guide recommends both for consistent results.
How much does easyCoexistence cost for a Facebook Page?
US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free; each connected Page is one connection.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on