Google Ads / API Reference
gads_forecast_reach
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. Forecast reach and impressions for a video/display campaign with given budget and targeting.
This is a read-only tool: it returns forecast reach 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:
Forecast reach in my Google Ads account for [budget micros], [start date], [end date].
It takes 3 required and 2 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
budget_micros | number | Yes | Budget Micros |
start_date | string | Yes | Start Date |
end_date | string | Yes | End Date |
targeting | object | No | Targeting |
customer_id | string | No | Customer Id |
Related Google Ads tools
gads_forecast_keywordsgads_account_overviewgads_ad_performancegads_add_ad_group_age_rangegads_add_ad_group_carriergads_add_ad_group_gender
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: