List Media

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

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.

Get Started

Guides

Operations

Inputs

FilterItem

SelectableOption

Output

​Inputs

​FilterItem

​SelectableOption

​Output

Inputs

FilterItem

SelectableOption

Output