Skip to main content
Glama
Google Ads Transparency

Google Ads Transparency

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
APIFY_TOKENNoOptional Apify token used only for the paid get_ads_with_copy tool. Without it, the free list_ads tool works and the paid tool returns a message explaining how to add a token. Get a token at console.apify.com/settings/integrations.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_adsA

List the ads an advertiser runs, from the Google Ads Transparency Center (Google's ad library). Free, no API key.

Returns one row per ad: advertiser name and ID, format, first shown, last shown,
days shown and a link to the ad. It does NOT return the ad text (headline,
description); use get_ads_with_copy for that.

Args:
    domain: advertiser website, e.g. "nike.com".
    region: 2-letter country code where the ad was shown, e.g. "US", "GB", "DE". Empty = all countries.
    ad_format: "text", "image" or "video". Empty = all formats.
    max_ads: how many ads to fetch, 1-200 (40 per page from Google).
    min_days_shown: keep only ads shown on at least this many days. Use 30+ to find long-running ads.
    sort: "recent" (most recently shown first) or "longest" (most days shown first).
get_ads_with_copyA

Get Google ads WITH their ad copy (headline, description, display URL), including text ads that Google stores only as screenshots, plus the countries each ad ran in.

Runs the hosted Apify Actor "datalume/google-ads-transparency-scraper" with your own
Apify account. Requires the APIFY_TOKEN environment variable. It is PAID per result
(about $0.002 per ad, $0.0035 per ad with copy on Apify's free plan; failed rows are free).
The run stops at max_total_charge_usd. Prefer list_ads when the ad text is not needed.

Args:
    domains: advertiser websites, e.g. ["booking.com"].
    advertiser_names: advertiser names to look up, e.g. ["Samsung Electronics"].
    region: 2-letter country code (e.g. "US") or "anywhere".
    platform: "all", "search", "youtube", "shopping", "maps" or "play".
    ad_format: "all", "text", "image" or "video".
    min_days_running: keep ads shown on at least this many days.
    sort_by: "recentlyShown", "longestRunning" or "newest".
    max_ads_per_target: maximum ads per domain or name (keep small to control cost).
    max_total_charge_usd: hard spending cap for this call, in USD.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.6/5.0

Scored across 2 tools

Disambiguation4/5

The two tools overlap in that both retrieve Google ads, but the split is clear: list_ads is free metadata-only, while get_ads_with_copy is paid and adds ad copy plus country coverage. Descriptions explicitly guide selection, though an agent might still initially hesitate over which to use when ad text is not the primary need.

Naming Consistency5/5

Both names use snake_case with a clear verb_noun structure: list_ads and get_ads_with_copy. The get_ads_with_copy variant is more descriptive but remains predictable and consistent with the list/get action pattern.

Tool Count4/5

The server has a narrow purpose, so two tools is defensible: one free listing tool and one paid copy-enrichment tool. It is slightly thin, but each tool has a distinct role and there is no redundant clutter.

Completeness4/5

The surface covers the main lifecycle of finding ads and retrieving their copy, including filtering by domain, region, format, duration, and spending caps. Minor gaps exist, such as richer advertiser lookup in the free tool or direct ad-detail retrieval, but core workflows are covered.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues