google ads get paid organic search terms
google_ads_get_paid_organic_search_termsRetrieve paid and organic search terms from Google Ads for a date range; falls back to paid-only data when organic fields are unavailable.
Instructions
Read-only paid/organic search terms report. Uses paid_organic_search_term_view when available and falls back to paid-only search_term_view if organic fields are unavailable.
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": {
"customerId": "<customerId>",
"startDate": "<startDate>",
"endDate": "<endDate>"
},
"name": "google_ads_get_paid_organic_search_terms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. | |
| endDate | Yes | End date YYYY-MM-DD | |
| serpType | No | Optional search engine results page type segment filter | |
| adGroupId | No | Optional ad group ID filter | |
| startDate | Yes | Start date YYYY-MM-DD | |
| campaignId | No | Optional campaign ID filter | |
| customerId | Yes | Google Ads customer ID (without dashes, e.g., 1234567890) | |
| searchTermContains | No | Optional search term substring filter |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query. |