> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Suggest Brands

> Find Google Ads brand IDs by name prefix for Performance Max brand exclusions and Search brand inclusions or exclusions

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`