Google Ads / API Reference
google_ads_keyword_forecast
Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Forecast clicks, impressions, and cost for a list of keywords using Keyword Planner. Args: customer_id: Google Ads customer ID keywords: Comma-separated keywords to forecast average_cpc_micros: Target CPC in micros (1_000_000 = $1.00) language_id: Language criterion ID (1000=English) country_code: Two-letter country code (default: 'US')
This is a read-only tool: it returns keyword forecast for 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:
Keyword forecast in my Google Ads account for [keywords].
It takes 2 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | Yes | Customer Id |
keywords | string | Yes | Keywords |
average_cpc_micros | integer | No | Average Cpc Micros |
language_id | string | No | Language Id |
country_code | string | No | Country Code |
Related Google Ads tools
google_ads_keyword_ideasgoogle_ads_keyword_performancegoogle_ads_account_overviewgoogle_ads_ad_performancegoogle_ads_ad_schedule_reportgoogle_ads_add_adgroup_negative_keywords
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: