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
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.
Length
length <= 1000report_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" }}