Get Advertiser
Ads Transparency
Get Advertiser
Advertiser identity plus Google’s disclosed spend, ad-format mix and per-day spend curve for one region.
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.
string
The advertiser’s Transparency Center page.
AdvertiserAdMix[]
Share of disclosed spend by creative format.
AdvertiserSpendPoint[]
One point per day of the window.
Example
Response

