Read Google Ads search terms
get_google_ads_search_termsThe connected Google Ads account's paid search terms for a date range, from what the daily pull stored: impressions, clicks, cost, conversions, conversion value and cost per conversion, most spend first, with each term's organic clicks, impressions and average position from Search Console over the same days (null where Search Console has none for the term; organicState says whether it was read). Also the account's campaign spend (accountSpend) and, for Performance Max campaigns, Google's Performance Max search categories (searchCategories): groups of similar searches with impressions, clicks and conversions but no cost. Money is in the account's currency (currencyCode). Days are in the account's time zone; at most 90 days. Read-only; uses no credits.
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": {
"projectId": "<projectId>"
},
"name": "get_google_ads_search_terms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to return (default 100, max 500). | |
| endDate | No | Last day (YYYY-MM-DD). Use with startDate. Without both, the last 30 stored days. At most 90 days. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| startDate | No | First day (YYYY-MM-DD, the Ads account's time zone). Use with endDate. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| meta | No | ||
| note | No | ||
| rows | No | ||
| reason | No | ||
| endDate | No | ||
| hasMore | No | ||
| message | No | ||
| failedAt | No | ||
| rowCount | No | ||
| startDate | No | ||
| connectUrl | No | ||
| accountName | No | ||
| accountSpend | No | ||
| currencyCode | No | ||
| organicState | No | ||
| storedThrough | No | ||
| searchCategories | No |