Feature Request & Inquiry: Public Availability of Auction Insights Metrics via Google Ads API

[Tony Campos]

Hello Google Ads API Community and Admins,

Our team, and likely many others in the community, would greatly benefit from the ability to access Auction Insights data directly via the Google Ads API.

The Challenge:
Currently, this crucial competitive data is only available through the Google Ads UI. This makes large-scale analysis across numerous accounts, campaigns, or custom date ranges a highly manual and inefficient process. Automating this data retrieval is essential for building scalable reporting, monitoring competitive shifts, and making timely strategic decisions. We previously relied on a Looker (now Looker Studio) integration for this, and its absence has created a significant gap in our analytical capabilities.

What We Know:
We have identified the specific Auction Insights metrics in the API documentation that we need access to. However, our attempts to query them suggest they are not publicly available and may require an allowlist/whitelist. Providing direct API access to these would solve our core challenge.

The specific metrics we require are:

metrics.auction_insight_search_absolute_top_impression_percentage (https://developers.google.com/google-ads/api/fields/v18/metrics#metrics.auction_insight_search_absolute_top_impression_percentage)
metrics.auction_insight_search_impression_share (https://developers.google.com/google-ads/api/fields/v18/metrics#metrics.auction_insight_search_impression_share)
metrics.auction_insight_search_outranking_share (https://developers.google.com/google-ads/api/fields/v18/metrics#metrics.auction_insight_search_outranking_share)
metrics.auction_insight_search_overlap_rate (https://developers.google.com/google-ads/api/fields/v18/metrics#metrics.auction_insight_search_overlap_rate)
metrics.auction_insight_search_position_above_rate (https://developers.google.com/google-ads/api/fields/v18/metrics#metrics.auction_insight_search_position_above_rate)
metrics.auction_insight_search_top_impression_percentage (https://developers.google.com/google-ads/api/fields/v18/metrics#metrics.auction_insight_search_top_impression_percentage)
Our Questions:

Roadmap: Is there a public roadmap or an estimated timeline for when these specific Auction Insights metrics will be made generally available to all users of the Google Ads API?
Whitelist Program: Does the whitelisting program for accessing these metrics still exist? If so, what are the criteria for participation, and what is the official process to apply for access?
Alternatives: Are there any recommended alternative methods or partner tools that can currently provide automated access to this data?

Thank you for your time and consideration. Making this data accessible via the API would be a significant enhancement for many advertisers and agencies who rely on data-driven decision-making.

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team. 

Please find the answers for your questions below: 

1. Roadmap: Is there a public roadmap or an estimated timeline for when these specific Auction Insights metrics will be made generally available to all users of the Google Ads API?

• Note that the 'auction insights metrics' feature is available only for the allowlisted accounts in the Google Ads API. The following metrics are not accessible through the Google Ads API: 
• auction_insight_search_absolute_top_impression_percentage
• auction_insight_search_impression_share
• auction_insight_search_outranking_share
• auction_insight_search_overlap_rate
• auction_insight_search_position_above_rate
• auction_insight_search_top_impression_percentage
• I would recommend you to follow our Release Notes and Blog Post for future updates regarding the accessibility of these auction insight metrics.

2. Whitelist Program: Does the whitelisting program for accessing these metrics still exist? If so, what are the criteria for participation, and what is the official process to apply for access?

• Unfortunately, the whitelisting program for this particular feature is currently closed, so we're unable to add new people to have access at this time. 

3. Alternatives: Are there any recommended alternative methods or partner tools that can currently provide automated access to this data?

• Although these metrics are not currently available through the API, you can still access them in the Google Ads UI by going to Insights > Reports > Auction Insights. Alternatively, you can generate an Auction Insights report in the UI and download it periodically as a workaround for programmatic access.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-06-12 02:07:06Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01rf2MQ:ref" (ADR-00313935)