List Ads - Markifact

Lists ads in a Meta ad account, optionally only the ads of one ad set or campaign, with any status including paused, plus creative details, review feedback (disapproval reasons) and delivery issues when Meta reports them


App	Meta Ads
Operation ID	`meta_ads_list_ads`
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
`campaign_effective_status`	array of string or SelectableOption	No	-	Filter ads by parent campaign effective status. Multiple statuses can be selected. Supported values: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES
`adset_effective_status`	array of string or SelectableOption	No	-	Filter ads by parent ad set effective status. Multiple statuses can be selected. Supported values: ACTIVE, PAUSED, DELETED, CAMPAIGN_PAUSED, ARCHIVED, IN_PROCESS, WITH_ISSUES
`ad_effective_status`	array of string or SelectableOption	No	-	Filter ads by ad effective status. Multiple statuses can be selected. Supported values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES
`filters`	array of FilterItem	No	-	Additional filters to apply when retrieving ads. The available fields to filter by are: - campaign_id: Filter by parent campaign ID - campaign_name: Filter by parent campaign name - adset_id: Filter by parent ad set ID - adset_name: Filter by parent ad set name - ad_id: Filter by ad ID - ad_name: Filter by ad name Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP_MATCH or IN_LIST. campaign_id, adset_id, and ad_id with EQUALS/IN_LIST, and ad_name with CONTAINS, are applied by Meta at the source, so they are fast on any account size. Other combinations are applied after fetching, scanning a bounded number of ads. Prefer the server-side combinations on large accounts.
`limit`	integer	No	`500`	Maximum number of matching ads to return (1-1000), counted after all filters are applied
`include_creative`	boolean	No	`True`	Include each ad’s creative payload (image URLs, story spec, asset feed spec, degrees of freedom spec). Set to false for lightweight results with ids, names, campaign/ad set info, statuses, and the preview link only; much faster and recommended for lookups on large accounts.
`response_format`	enum (`flattened`, `raw`)	No	`flattened`	Shape of the returned ads. ‘flattened’ (default) flattens nested Meta objects into top-level fields (for example campaign_id, adset_name, creative_image_url). ‘raw’ returns Meta’s response untouched, with campaign, ad set, and creative kept as nested objects. Status and client-side filters work the same in both modes.

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 list of ads with creative details. Fields: dynamic (depend on the inputs)