> ## 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 organic TikTok posts & dark posts under a TT_USER identity that supports Spark Ads Pull

Lists organic TikTok posts & dark posts under a TT\_USER identity that supports Spark Ads Pull. Returns item\_id values for creating Spark Ads from existing posts.

|                      |                         |
| -------------------- | ----------------------- |
| **App**              | TikTok Ads              |
| **Operation ID**     | `tiktok_ads_list_posts` |
| **Type**             | Action                  |
| **Connection**       | `tiktok_ads` (required) |
| **Credits per run**  | 1                       |
| **Agent / MCP tool** | Yes                     |

## Inputs

| Field         | Type                       | Required | Default | Description                                                                                                  |
| ------------- | -------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| `account`     | DynamicAccount             | Yes      | -       | Select the TikTok Ads account (advertiser) whose posts should be listed.                                     |
| `identity_id` | string or SelectItem       | Yes      | -       | TikTok User identity ID to pull posts from. The identity must be TT\_USER and can\_pull\_video must be true. |
| `item_type`   | string or SelectableOption | No       | -       | Type of posts to list. Options: VIDEO (default) or CAROUSEL.                                                 |
| `limit`       | integer                    | No       | `100`   | Maximum number of posts to return. Default: 100.                                                             |

### 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 TikTok posts for the selected TT\_USER identity, including item\_id, text, status, url, poster\_url, duration, width, height, format, and auth\_info.