> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Posts

> Lists a Facebook Page's published posts with engagement counts, or its scheduled post queue

Lists a Facebook Page's published posts with engagement counts, or its scheduled post queue. Only works for Pages included in the user's Facebook connection; public Pages the user does not manage are not supported. Reaction and comment counts can come back empty depending on the Page access; use facebook\_page\_insights for post metrics and stats. Useful for finding post IDs to boost with meta\_ads\_create\_ad\_from\_post or to update and delete later.

| | |
| - | - |
| **App** | Facebook Organic |
| **Operation ID** | `facebook_list_posts` |
| **Type** | Action |
| **Connection** | `facebook` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |

## 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. Must be a Page included in the Facebook connection (use facebook\_select\_pages to see them); public Pages the user does not manage are not supported. |
| `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**:

```json theme={"dark"}
[
  {
    "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/..."
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.