Google Ads API: Search creatives

Returns creatives for advertiser_id or creatives linking to domain; provide one of those fields. Supports format, surface, ordering, report-type, and pagination filters.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

advertiser_id?string

List creatives for one advertiser. Required unless domain is set.

Match^AR\d+$

domain?string

List creatives linking to this domain, across every advertiser. Required unless advertiser_id is set.

Length1 <= length <= 253

ad_format?string

unknown returns every format.

Default"unknown"

Value in

"unknown"
"text"
"image"
"video"

surfaces?string

Comma-separated platform filter: play, maps, search, shopping, youtube. Omit for every surface.

Lengthlength <= 100

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

Default"unknown"

Value in

"unknown"
"revenue"
"impressions"
"last_activity_date"

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/creatives/search" \  -H "x-api-key: YOUR_API_KEY"

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