Keywords report
keywords_reportRetrieve Google Ads keyword status, match type, Quality Score, bids, and performance for an account, campaign, or ad group, including why keywords are not serving and negative keywords.
Instructions
The account's keywords with match type, status and why one isn't serving, Quality Score and its three parts, bid, and results in the window, plus ad-group negative keywords. Whole account, or one campaign or ad group.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"customer_id": "<customer_id>"
},
"name": "keywords_report"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Look-back window in days, ending yesterday | |
| limit | No | Keywords to list, by cost | |
| ad_group_id | No | Only this ad group (from campaign_details) | |
| campaign_id | No | Only this campaign (campaign_id from account_overview) | |
| customer_id | Yes | Google Ads customer ID, with or without dashes (from list_accounts) | |
| include_paused | No | Also list paused keywords |