> ## 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. 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**:

```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/...",
    "attachments": [
      {
        "media_type": "photo",
        "media": {
          "image": {
            "src": "https://scontent.xx.fbcdn.net/..."
          }
        }
      }
    ],
    "permalink_url": "https://www.facebook.com/...",
    "reactions": 120,
    "comments": 14,
    "shares": 9
  }
]
```