Skip to main content
The get_keywords tool returns all keywords within a specified ad group, including each keyword’s text, match type, status, and current CPC bid. Use add_keywords to add new keywords to an ad group.

​
get_keywords

​
Parameters

​
ad_group_id
string
required
The ad group ID to retrieve keywords for. Your AI assistant resolves ad group names to IDs automatically.
​
status
string
Filter by keyword status. Accepted values: ENABLED, PAUSED. Returns all keywords if omitted.
​
customer_id
string
The 10-digit Google Ads account ID. Uses configured default if not specified.

​
Example prompts

Show me all keywords in the "Branded" ad group in the "Summer Sale" campaign

List paused keywords in the "Non-Brand" ad group

​
Example response

[
  {
    "id": "111222333",
    "text": "running shoes",
    "match_type": "PHRASE",
    "status": "ENABLED",
    "cpc_bid": 1.50,
    "currency": "USD"
  },
  {
    "id": "111222334",
    "text": "buy running shoes online",
    "match_type": "EXACT",
    "status": "ENABLED",
    "cpc_bid": 2.00,
    "currency": "USD"
  }
]

​
add_keywords

The add_keywords tool adds one or more keywords to an existing ad group.

​
Parameters

​
ad_group_id
string
required
The ad group ID to add keywords to.
​
keywords
array
required
List of keyword objects to add.
​
keywords[].text
string
required
The keyword text.
​
keywords[].match_type
string
required
Match type: BROAD, PHRASE, or EXACT.
​
keywords[].cpc_bid
number
Max CPC bid in account currency. If omitted, the ad group default bid is used.
​
customer_id
string
The 10-digit Google Ads account ID.

​
Example prompts

Add "running shoes", "best running shoes", and "buy running shoes" as phrase match keywords to the "Non-Brand" ad group

Add [running shoes] as exact match with a $2 bid to the "Branded" ad group

​
Match type reference

Match typeSyntaxWhen to use
BROADrunning shoesWidest reach; includes synonyms and related searches
PHRASE"running shoes"Searches that include the phrase in order
EXACT[running shoes]Searches that match exactly (or close variants)
Start with phrase and exact match keywords to maintain control over which searches trigger your ads. Add broad match only when you want to expand reach.