> ## 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.

# Keyword Planner

> Researches keyword suggestions and search volume data for Google Ads campaigns

Researches keyword suggestions and search volume data for Google Ads campaigns

| | |
| - | - |
| **App** | Google Ads |
| **Operation ID** | `gads_keyword_planner` |
| **Type** | Action |
| **Connection** | None |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |
| **Versions** | 1, 2 (default: 2) |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | GadsAccountItem or object or array of object or string or integer | Yes | - | Select the Google Ads account, ask user for it if not provided |
| `action_type` | string or SelectableOption | Yes | - | Choose which keyword planner action to perform. Available options: 'discover' (Discover Keywords), 'historical' (Historical Metrics) |
| `seed_type` | string or SelectableOption | No | - | Choose how to provide seed data for keyword discovery. Available options: 'keywords' (Keyword List), 'url' (Website URL) |
| `seed_keywords` | string | No | - | Enter keywords to use as seeds for discovery. Use only when 'discover' action is selected. Separate multiple keywords with newlines or commas (e.g., 'keyword1, keyword2') |
| `seed_url` | string | No | - | Enter a website URL to discover related keywords (e.g., `https://example.com`). Use only when 'discover' action is selected |
| `keywords` | string | No | - | Enter keywords to get historical metrics for. Use only when 'historical' action is selected. Separate multiple keywords with newlines or commas (e.g., 'keyword1, keyword2') |
| `monthly_breakdown` | boolean | No | `False` | Show search volume metrics broken down by month, only applicable for 'historical' action |
| `countries` | array of string or SelectableOption | Yes | - | Locations to target for keyword planning. Use 2-letter ISO country codes (e.g. 'US', 'GB') or Google Ads location IDs (e.g. '2840'), which the 'gads\_search\_geo\_targets' operation returns for cities and regions. Google Ads allows at most 10 locations per request; run the operation once per group of 10 to cover more. |
| `language` | string or SelectableOption | Yes | - | The language for the keywords, 2-letter language code (e.g., 'EN' for English, 'ES' for Spanish') |
| `limit` | integer | No | `100` | Maximum number of keywords to return (1-10000) |

### 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. |

### SelectableOption

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

## Output

**Type**: `List[Dict]`

Returns keyword ideas with search volume and competition data.

**Fields**: dynamic (depend on the inputs)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.