List Custom Audiences - Markifact

List custom audiences and lookalike audiences from a Meta Ads account. Use name_search to have Meta find audiences by name instead of paging through the account, and include_definition only when the audience rule or lookalike specification is needed.


App	Meta Ads
Operation ID	`meta_list_custom_audiences`
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
`audience_type`	string or SelectableOption	Yes	-	Type of audiences to list. ‘all’ returns both custom and lookalike audiences. ‘custom’ returns custom audiences (website, app, engagement, customer list, etc.). ‘lookalike’ returns lookalike audiences.
`name_search`	string	No	-	Return only audiences whose name contains this text. Meta applies this search itself, so it also finds audiences beyond the first page. Meta supports ‘contains’ only, not ‘starts with’, so searching ‘PN’ returns every audience containing ‘PN’ anywhere in the name.
`include_definition`	boolean	No	`False`	Include the audience rule and lookalike specification in the response. These can be large, and requesting them for many audiences at once can make Meta reject the request with ‘Please reduce the amount of data you’re asking for’. Enable it only when the definitions are needed, ideally together with name_search or a small limit.
`limit`	integer	No	`100`	Maximum number of audiences to return (1-1000). Default: 100

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: List[Dict] Returns list of custom/lookalike audiences with id, name, subtype, approximate count, delivery status, etc. Fields: dynamic (depend on the inputs)