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, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b.

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.