Google Ads / API Reference
gads_get_keyword_forecast
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 traffic forecast for keywords. keywords: list of {text, match_type} dicts. geo_target_ids: list of NUMERIC geo target constant IDs, e.g. ['2840'] for the United States, ['2376'] for Israel. language_id: '1000' = English. Forecasts a 30-day window starting tomorrow; Keyword Planner cannot forecast the past.
This is a read-only tool: it retrieves keyword forecast 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 keyword forecast in my Google Ads account for [keywords].
It takes 1 required and 4 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
keywords | array | Yes | Keywords |
geo_target_ids | array | No | Geo Target Ids |
language_id | string | No | Language Id |
daily_budget_micros | integer | No | Daily Budget Micros |
customer_id | string | No | Customer Id |
Related Google Ads tools
gads_get_keyword_bid_estimatesgads_get_keyword_detailsgads_get_keyword_ideasgads_get_keyword_quality_scoregads_get_keyword_simulationgads_get_account_budget
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:
- Google Ads — Audits & Health
- Google Ads — Keywords
- Google Ads — Negative Keywords
- Google Ads — Bids & Budgets
Start free — 30 tool calls a month
No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.