> ## 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 posts in an X (Twitter) Ads account: published, draft, or scheduled, and organic or Promoted-only

Lists posts in an X (Twitter) Ads account: published, draft, or scheduled, and organic or Promoted-only. Use the returned post IDs with x\_ads\_create\_ad to promote existing content.

|                      |                    |
| -------------------- | ------------------ |
| **App**              | X Ads              |
| **Operation ID**     | `x_ads_list_posts` |
| **Type**             | Action             |
| **Connection**       | `x_ads` (required) |
| **Credits per run**  | 1                  |
| **Agent / MCP tool** | Yes                |

## Inputs

| Field                          | Type                                     | Required | Default     | Description                                                                                                                                                                                                                                                                                                                          |
| ------------------------------ | ---------------------------------------- | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `account`                      | DynamicAccount                           | Yes      | -           | Select the X Ads account whose posts should be listed.                                                                                                                                                                                                                                                                               |
| `tweet_type`                   | enum (`PUBLISHED`, `DRAFT`, `SCHEDULED`) | No       | `PUBLISHED` | Which posts to list: PUBLISHED (default), DRAFT, or SCHEDULED. Post IDs from this node can be promoted with x\_ads\_create\_ad.                                                                                                                                                                                                      |
| `timeline_type`                | enum (`ALL`, `NULLCAST`, `ORGANIC`)      | No       | `ALL`       | Which posts to include: ALL (default here), NULLCAST (Promoted-only dark posts), or ORGANIC (posts that appear on the timeline).                                                                                                                                                                                                     |
| `post_ids`                     | string or array of string                | No       | -           | Scope to specific post IDs (list or comma-separated string, up to 200). They must match the selected tweet\_type. Take these from the id\_str or tweet\_id field, never a numeric id: X ids are 64-bit and any tool that stores them as a number rounds them into a post that does not exist.                                        |
| `user_id`                      | string                                   | No       | -           | Only list posts by this X user id. Defaults to all promotable users.                                                                                                                                                                                                                                                                 |
| `name`                         | string                                   | No       | -           | Scope to posts whose internal name matches this value.                                                                                                                                                                                                                                                                               |
| `include_mentions_and_replies` | boolean                                  | No       | `False`     | Include posts that are mentions or replies.                                                                                                                                                                                                                                                                                          |
| `filters`                      | array of FilterItem                      | No       | -           | Additional filters applied to the returned posts. The available fields to filter by are: - tweet\_id: Filter by post ID - full\_text: Filter by the post's text - name: Filter by the post's internal name Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP\_MATCH or IN\_LIST. |
| `limit`                        | integer                                  | No       | `100`       | Maximum number of posts to return. Default: 100.                                                                                                                                                                                                                                                                                     |

### FilterItem

| Field      | Type                       | Required | Default | Description                                                                                                                                                   |
| ---------- | -------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `field`    | string or SelectableOption | Yes      | -       | The field to filter on, must be one of the current selected metrics or dimensions.                                                                            |
| `operator` | string                     | Yes      | -       | The operator to use for filtering. Must be one of the supported values. Use REGEXP\_MATCH to search/filter by multiple OR values like '.*(summer\|holiday).*' |
| `value`    | string                     | Yes      | -       | The value to filter by. Can be a string, number, regex, or a list of strings.                                                                                 |

### SelectableOption

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

## Output

**Type**: `List[Dict]`

Returns the list of posts with full details including text, media, and metrics.

**Fields**: dynamic (depend on the inputs)