Google Ads API: Search advertisers

Returns advertisers matching query. Optionally filter by country, choose ordering, set the report type, and continue with page_token.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

Free-text advertiser name search.

Length1 <= length <= 200

country?string

Two-letter ISO-3166 country code to narrow advertiser search results.

Match^[A-Za-z]{2}$

num_results?integer

Page size, 1-100.

Range1 <= value <= 100

Default20

page_token?string

Opaque cursor from a previous response's next_page_token. Omit for the first page.

Lengthlength <= 2000

sort_key?string

unknown keeps Google's default relevance ordering.

Default"unknown"

Value in

"unknown"
"revenue"
"name"
"creative_count"
"impressions"

descending?|

Defaulttrue

report_type?string

all covers every advertiser/creative; political scopes to Google's separate election-ads transparency report.

Default"all"

Value in

"all"
"political"

curl -X GET "https://example.com/v1/google-ads/advertisers/search?query=nike" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "1": [      {        "property1": null,        "property2": null      }    ],    "2": "string",    "3": "string",    "property1": null,    "property2": null  }}