> ## 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 Media

> Lists the Meta ad account's media library (videos and images) with optional name/filename search applied by Meta at the source

Lists the Meta ad account's media library (videos and images) with optional name/filename search applied by Meta at the source. Returns video IDs, image hashes, names, dimensions, duration, status, and thumbnails. Use it to find existing media by filename before referencing them in creatives; pair with meta\_ads\_get\_media\_details for full details on specific assets.

|                      |                       |
| -------------------- | --------------------- |
| **App**              | Meta Ads              |
| **Operation ID**     | `meta_ads_list_media` |
| **Type**             | Action                |
| **Connection**       | `meta_ads` (required) |
| **Credits per run**  | 1                     |
| **Agent / MCP tool** | Yes                   |

## Inputs

| Field         | Type                       | Required | Default                            | Description                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------- | -------------------------- | -------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`     | DynamicAccount             | Yes      | -                                  | Select Meta Ads account, ask the user for it if not provided                                                                                                                                                                                                                                                                                                                                            |
| `media_type`  | string or SelectableOption | No       | `{'value': 'ALL', 'label': 'All'}` | Which media library assets to list: ALL (default), VIDEO, or IMAGE.                                                                                                                                                                                                                                                                                                                                     |
| `name_search` | string                     | No       | -                                  | Optional name/filename search applied by Meta at the source (substring match). Uploaded assets are usually named after their original filename, for example 'summer\_sale.mp4'.                                                                                                                                                                                                                         |
| `filters`     | array of FilterItem        | No       | -                                  | Additional filters to apply when retrieving media. The available fields to filter by are: - media\_type: VIDEO or IMAGE - name: The asset name/filename - status: Asset status (for example ready or ACTIVE) - video\_id: Filter by video ID - image\_hash: Filter by image hash Filters are combined using AND logic. Prefer name\_search for name lookups, since it is applied by Meta at the source. |
| `limit`       | integer                    | No       | `100`                              | Maximum number of matching assets to return (1-500), counted after all filters are applied                                                                                                                                                                                                                                                                                                              |

### 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 media library assets with media\_type, video\_id or image\_hash, name, status, dimensions, duration, thumbnail, and created\_time.