Docs menu
Get started
What is Opus GrowthQuickstartAdd to your AIHow it worksSafety and approvalCreditsPlansFAQAI apps
All AI appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOther MCPConnect ad platforms
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencies and MCCConnect data sources
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWebsites and SEO
AI ServerWordPressSEO IntelligenceClick fraudTool reference
All toolsGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceClick fraudCross-channelAccount and billingLanguage
Keyword Report
Keyword performance with Quality Score (and its three components) for every keyword that had impressions in the period, sorted by cost.
- Type
- Reads only
- Credits
- 2
- Platform
- Google Ads
- Approval
- Not needed, nothing changes
What it does
Keyword performance with Quality Score (and its three components) for every keyword that had impressions in the period, sorted by cost. DATE: period ('today', 'last_7_days', ... or 'YYYY-MM-DD[:YYYY-MM-DD]') overrides days; days=0 = today. `active` = the keyword is serving now; paused/removed keywords that had impressions in the period are included as history. include_zero_impressions=true adds keywords with no impressions in the period (the full keyword inventory). Each row has `flags`: low_quality_score (QS 1-3) and/or zero_conversion_spend (cost > 0, no conversions). Summary fields (total_rows, active_count, active_match_types, quality_score_histogram, low_quality_score_total/cost, zero_conversion_spenders_total/cost) cover all rows; only = low_quality_score | zero_conversion_spenders | active returns just those rows. limit = rows in this response (no upper bound; 0 = as many as fit, about 380 KB); when has_more is true, page_token=next_page_token returns the next rows without credits or a new query; offset=next_offset also works.
MCP: keyword_report
How to use it
You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.
Parameters
| Name | Type | Required | Default | |
|---|---|---|---|---|
| customer_id | string | Required | · | Google Ads customer account ID to query or change. Use the numeric ID returned by list_accounts; omit separators unless this tool explicitly says otherwise. |
| days | integer | Optional | 90 | Number of calendar days to look back from now for this analysis or report. |
| period | string | Optional | · | Reporting period or date-range preset accepted by this operation. |
| limit | integer | Optional | 0 | Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete. |
| offset | integer | Optional | 0 | Zero-based position at which to start reading results. Use the next_offset returned by the previous response when present. |
| include_zero_impressions | boolean | Optional | false | Whether to include zero impressions in this operation's result or change. |
| only | string | Optional | · | Exact only value for keyword report. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation. |
| page_token | string | Optional | · | Continuation token returned as next_page_token by a previous call. Leave empty for the first page; pass it unchanged to retrieve the cached next page. |
Related tools
account_auditAccount Snapshotaccount_snapshotAdd Keywordsadd_keywordsAdd Negative Keywordadd_negative_keywordAdd PMax Imagesadd_pmax_imagesApply Recommendationapply_recommendationBudget Pacing Alertsbudget_pacing_alertsCompetitor Adscompetitor_adsConnect Business Profileconnect_business_profile