Suggest Brands - Markifact

Find Google Ads brand IDs by name prefix for Performance Max brand exclusions and Search brand inclusions or exclusions. This is a read-only lookup; use gads_mutate to manage brand lists and their targeting.


App	Google Ads
Operation ID	`gads_suggest_brands`
Type	Action
Connection	`gads` (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`account`	GadsAccountItem or object or array of object or string or integer	Yes	-	Google Ads account for the brand lookup.
`brand_prefix`	string	Yes	-	Brand name or starting characters to search for, for example ‘Nike’. Returns matching brands from Google’s brand library, not competitor recommendations.
`selected_brands`	string or array of string	No	-	Brand IDs to exclude from suggestions because they are already selected. Use IDs returned by this operation, not brand names. Accepts a list, a JSON array, or comma/newline-separated IDs. This only filters the lookup results; it does not change any brand list or campaign.

GadsAccountItem

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-
`managerId`	string	Yes	-	The manager ID for the Google Ads account. Ask user to use the dropdown to select accounts, this manager id is selected background and not shown to the user.

Output

Type: List[Dict] Returns Google’s matching brands unchanged: id (Commercial Knowledge Graph entity ID), name, identifying urls, and state. Use id as SharedCriterion.brand.entity_id when managing a brand list. Returns an empty list when no brands match. Fields: id, name, urls, state