Sign in
Ad Insights

Google Ads search terms report

The actual search queries that triggered your ads, with matched-keyword status and spend metrics, the raw material for wasted-spend analysis and negative-keyword lists. Reads Google's search_term_view, cached for the quota window; defaults to the last 30 days. Rows are ordered by cost, descending. Draws on the shared Google Ads operations budget. The response carries cachedAt and stale, set when a quota-exhausted call falls back to the last-good copy instead of a live read.

get/v1/ads/search-terms

Query parameters

accountIdstring required

Google ads SocialAccount id.

customerIdstring

Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.

fromDatestring date

Defaults to 30 days ago.

toDatestring date

Defaults to today.

campaignIdstring

Numeric Google campaign id filter.

adGroupIdstring

Numeric Google ad group id filter.

pageTokenstring

Cursor from paging.nextPageToken of the previous page.

Response

Search terms

customerIdstring
cachedAtstring date-time nullable

When this data was fetched from Google. Null when it was never served from cache.

staleboolean

True when Google's daily API quota was exhausted and this is the last successful fetch, not a live read.

Changes