Skip to main content
GET
Get Advertiser
Advertiser identity plus the spend Google discloses for one region: total spend and currency, ad count, the share of spend by creative format, and a per-day spend curve across the requested window. Credits: 5
Spend disclosure exists for political advertisers. A commercial advertiser with no disclosure returns 404 rather than a row of zeroes.

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
required
Advertiser ID, e.g. AR01614014350098432001. Resolve a name with /ads/advertisers.
string
default:"US"
ISO 3166-1 alpha-2 region. Disclosure is region-scoped — anywhere returns nothing, so it falls back to US.
string
Window start, YYYY-MM-DD. Defaults to 30 days ago.
string
Window end, YYYY-MM-DD. Defaults to today.

Response

string
string
string
boolean
integer
Ads disclosed for the region.
string
e.g. USD.
number
Disclosed spend for the region and window.
string
Echo of the requested window start.
string
Echo of the requested window end.
The advertiser’s Transparency Center page.
AdvertiserAdMix[]
Share of disclosed spend by creative format.
AdvertiserSpendPoint[]
One point per day of the window.

Example

Response

Errors