Google Ads / API Reference
gads_get_search_terms_report
Google Ads tool (extended/low-level coverage). For common tasks prefer the RECOMMENDED google_ads_* actions; use these only for advanced operations those don't cover. Get actual search queries (search terms report) that triggered ads. Args: campaign_id: Filter by campaign ID (optional). ad_group_id: Filter by ad group ID (optional). start_date: YYYY-MM-DD (default last 30 days). end_date: YYYY-MM-DD. min_clicks: Minimum clicks threshold to filter results. customer_id: Google Ads customer ID.
This is a read-only tool: it retrieves search terms report from your Google Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Get search terms report in my Google Ads account.
It takes 0 required and 6 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | No | Campaign Id |
ad_group_id | string | No | Ad Group Id |
start_date | string | No | Start Date |
end_date | string | No | End Date |
min_clicks | integer | No | Min Clicks |
customer_id | string | No | Customer Id |
Related Google Ads tools
gads_get_search_term_insightsgads_get_account_budgetgads_get_account_conversion_idgads_get_account_infogads_get_account_statusgads_get_ad_asset_field_performance
Before you can call it
This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: