request for two read-only reporting endpoints

Our customers want to see which of their Google Ads keywords perform and which don't ("which keywords are wasting money, which should get more budget, which search queries should become negative keywords"). Campaign/ad-group/ad-level metrics via /v1/ads/tree, /v1/ads/campaigns and /v1/ads/timeline work great, but for Google Search campaigns the keyword is the unit that matters, and it's not exposed anywhere today.

Current gaps we ran into

  • keywords[] exists as an input on POST /v1/ads/create, but there's no way to read keywords back β€” GET /v1/ads/{adId} and the tree don't return them.

  • There's no keyword performance report and no search-terms report.

  • The breakdowns parameter on GET /v1/ads/{adId}/analytics is Meta/TikTok only.

Request: two read-only reporting endpoints

GET /v1/ads/keywords?accountId=&adAccountId=&fromDate=&toDate= Per keyword (aggregated over the range, ideally with the same timeIncrement=1 option as /v1/ads/tree for a daily[] series):

  • keyword, matchType, status, platformCampaignId, platformAdGroupId

  • spend, impressions, clicks, conversions, conversionValue

  • if available: qualityScore, searchImpressionShare GET /v1/ads/search-terms?accountId=&adAccountId=&fromDate=&toDate= Same metrics per actual search query, plus matchedKeyword (and matchType), so users can identify negative-keyword candidates.

Both map directly onto the Google Ads API's keyword_view and search_term_view reports, so this should be covered by the adwords scope your Google Ads connection already requests ("campaigns, ad groups, ads, reporting, conversions" per your docs) β€” no new OAuth consent needed for existing connections.

Please authenticate to join the conversation.

Upvoters
Status

Completed

Board
πŸ’‘

Feature Request

Date

2 months ago

Author

JW Stukart

Subscribe to post

Get notified by email when there are changes.