What it returns
See **every Google ad a competitor is running**: Search, Display and YouTube. The data comes straight from Google's public Ads Transparency Center.
Advertiser name, advertiser ID and verified domain. Ad format: text (Search), image (Display) or video (YouTube). First shown and last shown** dates, and the number of days shown. Preview image URL, preview/render URL, and a direct link to the ad in the Transparency Center. Optional details: **every variation** of the ad and **the countries it ran in**, with the last date shown in each.
Common uses
Competitor ad research, creative inspiration and swipe files, agency pitches, brand-safety and trademark monitoring, and tracking when competitors launch or pause campaigns.
Request
POST https://api.pushbuild.com/google-ads-transparency/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
searchTerms | list of strings | Brand or company names, e.g. 'Nike'. Each is matched to its verified Google advertiser account. |
domains | list of strings | Get all ads pointing to these website domains, e.g. 'shopify.com'. |
advertiserIds | list of strings | Google advertiser IDs (start with AR…), taken from an adstransparency.google.com URL. |
advertisersPerSearchTerm | integer | How many matching advertiser accounts to include for each name (brands often have several). Default: 1. |
region | string: , US, GB, CA, AU, DE, FR, IN, BR, JP, ES, IT, NL, MX, SE, PL, IE, NZ, SG, ZA, AE, CH, AT, BE, DK, NO, FI, PT, TR, KR, PH, ID, AR | Only ads shown in this country. Default: "". |
format | string: , text, image, video | Only ads of this format. Default: "". |
dateFrom | string | Only ads shown on or after this date (YYYY-MM-DD). |
dateTo | string | Only ads shown on or before this date (YYYY-MM-DD). |
maxAdsPerTarget | integer | Stop after this many ads for each advertiser or domain. Default: 100. |
includeDetails | boolean | Also fetch every variation of each ad and the list of countries it ran in (one extra request per ad). Default: false. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/google-ads-transparency/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"searchTerms": ["Shopify"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $1.20 per 1,000 ad scrapeds. No charge for errors or empty searches.
Related APIs
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Cboe Put/Call Ratios & VIX Futures Term Structure API
Daily Cboe options statistics: total, equity, index, SPX and VIX put/call ratios with call and put volume and open interest by product, plus the VIX futures curve with settlements, open interest and contango versus spot VIX..
CFPB Consumer Complaints: Banks, Lenders, Fintech API
Search 18 million+ official CFPB consumer complaints against banks, lenders, card issuers, debt collectors, credit bureaus and fintechs.
CFTC Commitments of Traders (COT) Reports API
Weekly CFTC Commitments of Traders positioning for every futures market: legacy, disaggregated (managed money, producers, swap dealers) and financial (leveraged funds, asset managers).
ClinicalTrials.gov API
Search 500,000+ clinical studies from ClinicalTrials.gov by condition, drug, sponsor, location, phase and status.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com