List Posts

Lists a Facebook Page’s published posts with engagement counts, or its scheduled post queue. Useful for finding post IDs to boost with meta_ads_create_ad_from_post or to update and delete later.


App	Facebook
Operation ID	`facebook_list_posts`
Type	Action
Connection	`facebook` (required)
Credits per run	1

Inputs

Field	Type	Required	Default	Description
`page`	string or SelectItem	Yes	-	Select the Facebook Page to list posts from, ask the user for it if not provided
`post_status`	string or SelectableOption	No	`published`	Which posts to list. Available options: ‘published’ (default, recent posts with engagement counts) or ‘scheduled’ (the queue of posts scheduled for later).
`since`	string	No	-	Only include published posts created on or after this date (YYYY-MM-DD). Ignored for scheduled posts.
`until`	string	No	-	Only include published posts created on or before this date (YYYY-MM-DD). Ignored for scheduled posts.
`limit`	integer or string	No	`25`	Maximum number of posts to return, between 1 and 100. Default is 25.

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: List[Dict] Returns a list of posts. Published posts include permalink and engagement counts; scheduled posts include the scheduled publish time. image_url is the post’s full_picture and attachments is Meta’s raw attachments payload (media image/video source URLs, targets, subattachments per photo). Media URLs are signed CDN links that expire after a few days, so use them right away rather than storing them. Fields: post_id, message, created_time, media_type, status, image_url, attachments, permalink_url, reactions, comments, shares, scheduled_publish_time Example:

[
  {
    "post_id": "1234567890_9876543210",
    "message": "Big news!",
    "created_time": "2026-08-01T10:00:00+0000",
    "media_type": "photo",
    "status": "published",
    "image_url": "https://scontent.xx.fbcdn.net/...",
    "attachments": [
      {
        "media_type": "photo",
        "media": {
          "image": {
            "src": "https://scontent.xx.fbcdn.net/..."
          }
        }
      }
    ],
    "permalink_url": "https://www.facebook.com/...",
    "reactions": 120,
    "comments": 14,
    "shares": 9
  }
]

Get Started

Guides

Operations

Inputs

SelectItem

SelectableOption

Output

​Inputs

​SelectItem

​SelectableOption

​Output

Inputs

SelectItem

SelectableOption

Output