Google Ads / API Reference
google_ads_auction_insights
Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Get competitive pressure per campaign: impression share, and share lost to budget vs rank. Note: Google does not expose the Auction Insights report (competitor domains, overlap rate, outranking share) through the Ads API -- that data is available only in the Google Ads UI. This returns the impression-share metrics the API does provide, which answer the same underlying question: how much of the available auction you are winning, and whether you lose it to budget or rank. Args: start_date: Start date YYYY-MM-DD. Defaults to 28 days ago. end_date: End date YYYY-MM-DD. Defaults to today. customer_id: Google Ads customer ID. Leave blank to use default. campaign_id: Filter by campaign ID. Leave blank for all.
This is a read-only tool: it returns auction insights 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:
Auction insights in my Google Ads account.
It takes 0 required and 4 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
start_date | string | No | Start Date |
end_date | string | No | End Date |
customer_id | string | No | Customer Id |
campaign_id | string | No | Campaign Id |
Related Google Ads tools
google_ads_account_overviewgoogle_ads_ad_performancegoogle_ads_ad_schedule_reportgoogle_ads_add_adgroup_negative_keywordsgoogle_ads_add_audience_to_campaigngoogle_ads_add_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: