# Google Ads Transparency API – Competitor Ads & Advertiser Check (`henryklimes/google-ads-transparency`) Actor

Check whether companies run Google Ads and export their ads from Google Ads Transparency Center: format, first/last shown dates, days running, images and links. Bulk domains, brand names or advertiser IDs, any country. No login, no proxy needed.

- **URL**: https://apify.com/henryklimes/google-ads-transparency.md
- **Developed by:** [Jindrich Klimes](https://apify.com/henryklimes) (community)
- **Categories:** Lead generation, SEO tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Ads Transparency API – Competitor Ads & Advertiser Check

Check **whether a company runs Google Ads** and export **every ad it runs** from the [Google Ads Transparency Center](https://adstransparency.google.com/), in bulk. Paste domains, brand names or Google advertiser IDs and get clean rows: is the company advertising, how many ads Google shows, which advertiser accounts are behind them, the latest ad date, plus one row per ad with its **format (text, image, video), first and last shown dates, days running, image and a direct link**. Any country, last-N-days filter, no login, no cookies, no proxy needed.

Built for **competitor ad research, PPC agencies prospecting companies that spend on Google Ads, sales teams qualifying leads, and AI agents** that need a Google Ads Transparency Center API.

### What you get

- **Advertiser check (summary row per query)** – `is_advertising`, Google's total ad count (for example `1000-2000`), advertiser accounts with legal names and countries, latest ad shown, formats mix, and a Transparency Center link
- **Ads (one row per ad)** – advertiser, creative ID, format, target domain, first shown, last shown, days shown, creative image or preview URL, ad link
- **Three ways to search** – a domain (`hubspot.com`), a brand name (`Canva`), an advertiser ID (`AR17828074650563772417`) or a pasted Transparency Center URL
- **Brand names just work** – Google's own search returns nothing for a plain brand keyword; this Actor resolves the brand to its advertiser accounts or its website for you
- **Filters** – region (any country, or anywhere), only ads shown in the last N days, formats
- **Bulk and cheap** – up to 1,000 queries per run; set `maxAdsPerQuery` to 0 to only check who advertises
- **Not-found and failed lookups are free** – only successful checks and returned ads are charged

### Use cases

- **Competitor ad monitoring** – export all Google Search, YouTube and Display ads a competitor ran in the last 30 days, with run dates, to spot new campaigns and long-running winners (ads running for months are usually the ones that convert)
- **PPC and marketing agency prospecting** – upload a list of local businesses or SaaS domains and keep only the ones that currently run Google Ads (they already have budget) or the ones that don't (they need help)
- **Lead scoring and enrichment** – add "runs Google Ads, ~400 ads, latest ad yesterday" to CRM records next to tech stack and hiring signals
- **Market and creative research** – collect ad creatives across a category, by country, for swipe files and AI analysis
- **AI agents and automations** – call it from n8n, Make, Zapier, Clay, LangChain or via MCP to answer "is this company advertising on Google?"

### Input

```json
{
  "queries": ["hubspot.com", "Canva", "AR17828074650563772417"],
  "region": "US",
  "maxAdsPerQuery": 50,
  "shownInLastDays": 30
}
```

| Field | Default | Description |
| --- | --- | --- |
| `queries` | — | Domains or URLs, brand names, advertiser IDs (`AR...`) or Ads Transparency Center URLs. Up to 1,000; duplicates removed. |
| `region` | anywhere | 2-letter country code (`US`, `GB`, `DE`, `CZ` …). A country in a pasted Transparency Center URL (`region=DE`) wins over this field. |
| `maxAdsPerQuery` | `50` | Ads per query, newest first (up to 10,000). `0` = advertiser check only. |
| `shownInLastDays` | `0` (all time) | Only ads Google showed in the last 1–365 days. Also applies to `is_advertising`. |
| `formats` | all | `TEXT`, `IMAGE`, `VIDEO` |
| `maxAdvertisersPerBrand` | `1` | A brand can have several advertiser accounts (regional entities); include up to 10, biggest first |
| `includeSummary` | `true` | Add the advertiser check row per query |
| `maxConcurrency` | `3` | Parallel queries (1–10) |
| `proxyConfiguration` | off | Not needed normally |

### Output

Advertiser check row:

```json
{
  "type": "summary",
  "query": "hubspot.com",
  "query_type": "domain",
  "region": "US",
  "status": "ok",
  "is_advertising": true,
  "ads_total_label": "1000-2000",
  "ads_total_min": 1000,
  "ads_total_max": 2000,
  "advertisers": [
    { "advertiser_id": "AR10072600183532683265", "name": "Hubspot, Inc.", "country": null, "ads_in_sample": 31 }
  ],
  "latest_ad_shown": "2026-11-17T20:07:28Z",
  "formats_in_sample": { "TEXT": 26, "VIDEO": 9, "IMAGE": 5 },
  "transparency_url": "https://adstransparency.google.com/?region=US&domain=hubspot.com"
}
```

Ad row:

```json
{
  "type": "ad",
  "query": "hubspot.com",
  "advertiser_id": "AR10072600183532683265",
  "advertiser_name": "Hubspot, Inc.",
  "creative_id": "CR03796768999677624321",
  "format": "TEXT",
  "target_domain": "hubspot.com",
  "first_shown": "2026-10-28T05:02:23Z",
  "last_shown": "2026-11-17T20:07:28Z",
  "days_shown": 22,
  "image_url": "https://tpc.googlesyndication.com/archive/simgad/3304477454343969253",
  "preview_url": null,
  "ad_url": "https://adstransparency.google.com/advertiser/AR10072600183532683265/creative/CR03796768999677624321?region=US"
}
```

The dataset has two views: **Advertiser check** and **Ads**. Export to JSON, CSV, Excel, or read it through the API. A run summary (queries checked, ads, requests) is saved as `OUTPUT` in the key-value store.

#### Good to know

- **Dates** are ISO 8601 in UTC. `days_shown` is Google's count of days the ad ran.
- **Ad counts are ranges** because Google only publishes ranges (`3000-4000`); small counts are exact.
- **Domain searches** return every advertiser whose ads point to that domain, which can include resellers and partners. Use the advertiser ID for one account only.
- **Creatives**: image ads and many text ads come with an `image_url`. Responsive, video and some text ads come with Google's `preview_url` (a script that renders the ad); open `ad_url` to see it in the Transparency Center. Ad copy text and per-country impression ranges are not extracted.
- **Brand names** are matched to advertiser names as whole words ("Canva Pty Ltd" for Canva, not "Canvasso"). If no advertiser matches but the brand's website does (canva.com), the website is searched instead. If nothing matches, the row is `not_found` (free) and lists Google's closest advertisers so you can rerun with an ID.
- The data is what Google publishes in its public Ads Transparency Center. No login, no personal data.

### Examples

**Who in my lead list runs Google Ads right now?**

```json
{ "queries": ["acme-dental.com", "brightsmile.com", "cityortho.com"], "maxAdsPerQuery": 0, "region": "US", "shownInLastDays": 30 }
```

**Export a competitor's video ads in Germany**

```json
{ "queries": ["Canva"], "region": "DE", "formats": ["VIDEO"], "maxAdsPerQuery": 200 }
```

**All ads an advertiser ran in the last 90 days**

```json
{ "queries": ["AR17828074650563772417"], "shownInLastDays": 90, "maxAdsPerQuery": 1000 }
```

### Pricing

Pay per event, no start fee:

- **Advertiser check**: one per successful summary row (including "not advertising" answers)
- **Ad**: one per ad row

Not-found and failed lookups are free. See the Pricing tab for current prices.

### FAQ

**Is there an official Google Ads Transparency Center API?**
Google offers API access only for ads served in the EU/EEA and to regulators. This Actor reads the same public data the Transparency Center website shows, for any country.

**Does it need a Google account, cookies or proxies?**
No.

**How fresh is the data?**
Live: every run reads the Transparency Center at that moment. Schedule the Actor daily or weekly to monitor competitors.

**Can I use it from n8n, Make, Zapier or an AI agent?**
Yes. Use the Apify integration or call the Actor's run-sync API endpoint; it also works through the Apify MCP server.

### More from Cleanrows

- [Company Website Enricher](https://apify.com/henryklimes/company-enricher) – emails, phones, socials and tech stack for a list of domains
- [Careers Page & ATS Detector](https://apify.com/henryklimes/careers-ats-detector) – which ATS a company uses and how many jobs are open
- [Google Trends API](https://apify.com/henryklimes/google-trends) – bulk keyword trends, compare more than 5 keywords

Questions or a missing field? Open an issue on the Actor page.

# Actor input Schema

## `queries` (type: `array`):

One per line: a domain or website URL (hubspot.com), a brand name (Nike), a Google advertiser ID (AR17828074650563772417) or an Ads Transparency Center URL. Up to 1,000 per run; duplicates are removed.

## `region` (type: `string`):

2-letter country code (US, GB, DE, CZ...) to see only ads shown in that country. Leave empty for anywhere.

## `maxAdsPerQuery` (type: `integer`):

How many ads to return for each query, newest first. Set 0 to only check whether the company advertises (one summary row per query, the cheapest option).

## `shownInLastDays` (type: `integer`):

Limit to ads Google showed in the last N days (1-365). 0 = all time. Also applies to the 'is advertising' check.

## `formats` (type: `array`):

Only return these formats. Empty = all.

## `maxAdvertisersPerBrand` (type: `integer`):

A brand name can match several Google advertiser accounts (for example regional entities). How many of the best matches to include.

## `includeSummary` (type: `boolean`):

One row per query with is_advertising, the total ad count range, advertisers, latest ad date and formats. Turn off to get ads only.

## `maxConcurrency` (type: `integer`):

Queries processed at the same time. Lower it if you see rate limiting.

## `proxyConfiguration` (type: `object`):

Not needed normally. Turn on a proxy only if you see repeated rate limiting on very large runs.

## Actor input object example

```json
{
  "queries": [
    "hubspot.com",
    "notion.so",
    "Canva"
  ],
  "region": "",
  "maxAdsPerQuery": 50,
  "shownInLastDays": 0,
  "formats": [],
  "maxAdvertisersPerBrand": 1,
  "includeSummary": true,
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Summary rows and ad rows

## `summary` (type: `string`):

Queries checked, ads returned, requests and rate limits

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "hubspot.com",
        "notion.so",
        "Canva"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("henryklimes/google-ads-transparency").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "queries": [
        "hubspot.com",
        "notion.so",
        "Canva",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("henryklimes/google-ads-transparency").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "hubspot.com",
    "notion.so",
    "Canva"
  ]
}' |
apify call henryklimes/google-ads-transparency --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,henryklimes/google-ads-transparency"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/sk5xHhcpyo4cjsA5I/builds/P4siztBE80CHoHSK3/openapi.json
