ToolzerHub Docs

Get advertiser details (v1)

Returns one advertiser record, including verification and disclosure information. Requires advertiser_id_or_url; report_type is optional.

1 credit / requestBilled only on success
GET
/v1/google-ads/advertisers/get

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

advertiser_id_or_url*string

The advertiser's adstransparency.google.com link, or its AR-prefixed id from a search or suggestion result.

Lengthlength <= 1000
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/get?advertiser_id_or_url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR13536189912721653761%3Fregion%3DUS" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "1": {      "property1": null,      "property2": null    },    "property1": null,    "property2": null  },  "details": {    "reason": "no_results",    "message": "string"  }}