Google Ads / API Reference
gads_get_ad_performance_by_date
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 impressions, clicks, cost, CTR, CPC, and conversions for ads within a date range. Optionally filter by campaign or ad group.
This is a read-only tool: it retrieves ad performance by date 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 ad performance by date in my Google Ads account for [start date], [end date].
It takes 2 required and 5 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
start_date | string | Yes | Start Date |
end_date | string | Yes | End Date |
campaign_id | string | No | Campaign Id |
ad_group_id | string | No | Ad Group Id |
ad_id | string | No | Ad Id |
segment_by_date | boolean | No | Segment By Date |
customer_id | string | No | Customer Id |
Related Google Ads tools
gads_get_ad_asset_field_performancegads_get_ad_change_historygads_get_ad_conversion_breakdowngads_get_ad_detailsgads_get_ad_group_ads_summarygads_get_ad_group_cpa_simulation
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: