List Ads - Markifact

Lists Meta ads by account, ad set or campaign, including paused ads, creative details, review feedback and delivery issues. Returns preview_shareable_link for browser viewing and client sharing; use this for shareable previews.


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, post IDs effective_object_story_id and object_story_id, 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.
`include_tracking`	boolean	No	`False`	Also return each ad’s tracking_specs, conversion_specs and tracking_and_conversion_with_defaults, for bulk tracking audits. Off by default because these fields enlarge every ad. The creative’s url_tags come with include_creative.
`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)