OpenAPI 3.1.02026-08-205681892.2 MB

26bee5940ef6

Account Groups4

Account Settings9

Accounts13

Ad Accounts20

Ad Audiences6

Ad Campaigns22

Ad Creatives11

Ad Insights10

Ad Targeting5

Analytics24

API Keys4

Blogs10

Broadcasts10

Calls3

Comment Automations6

Comments13

Connect44

Connected Apps2

Contacts7

Conversions12

Custom Fields6

Discord24

GMB Attributes3

GMB Food Menus2

GMB Location Details2

GMB Media3

GMB Place Actions4

GMB Reviews4

GMB Services2

GMB Verifications4

Inbox Analytics7

Instagram5

Invites1

Lead Gen7

LinkedIn Mentions1

Logs1

Media1

Mentions2

Messages15

Messaging Ads3

Phone Numbers25

Posts10

Profiles5

Queue6

Reach and Frequency4

Reddit Search2

Reviews3

Sequences10

Slack1

SMS22

Tracking Tags10

Twitter Engagement8

Usage6

Users2

Validate4

Verify3

Voice11

Webhooks6

WhatsApp35

WhatsApp Calling16

WhatsApp Flows13

WhatsApp Phone Numbers16

WhatsApp Sandbox3

WhatsApp Templates1

Workflows14

Webhooks

Webhook Events49

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 live; defaults to the last 30 days. Rows are ordered by cost, descending. Draws on the shared Google Ads operations budget.

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