Skip to content
Get MCP AdsGet MCP Ads, home
Start free

google_ads_get_search_terms

Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.

Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.

Kind
Read
Discovery
Announced in the tool list
Account parameter
customerId
Endpoint
https://mcp.getmcpads.com/google-ads/mcp

ParametersLink to this section

NameTypeRequiredNotes
customerIdstringRequiredGoogle Ads customer ID (without dashes, e.g., 1234567890)
reportTypestringOptionalOne of: search_term_view, campaign_search_term_insight. Default: "search_term_view".
startDatestringRequiredStart date YYYY-MM-DD.
endDatestringRequiredEnd date YYYY-MM-DD.
campaignIdstringOptionalOptional campaign ID filter.
adGroupIdstringOptionalOptional ad group ID filter. Applies directly to search_term_view and via segments.ad_group for insight reports.
searchTermContainsstringOptionalOptional substring filter for search_term_view.
limitintegerOptionalDefault: 1000.

Calling itLink to this section

jsonDirectly, since it is announced
{
  "name": "google_ads_get_search_terms",
  "arguments": {
    "customerId": "<string>",
    "startDate": "<string>",
    "endDate": "<string>"
  }
}
Esc

Type to search