La tabla que verá el cliente en Apify, definida por Argon (12 columnas):

advertiserId · advertiserName · creativeId · format · firstShown · lastShown · regions · previewUrl · transparencyUrl · query · fetchedAt · source

Apify Store Listing Copy — google-ads-transparency

1. Title (<= 60 characters)

Google Ads Transparency Explorer: Ad Creatives & Dates (54 characters)

2. Short Description (<= 1000 characters)

Extract public ad creative metadata, formats, active date ranges, regional breakdowns, and official preview links from the Google Ads Transparency Center by advertiser name, domain, or AR ID. Includes incremental firstShownAfter date filtering and Apify Proxy support. Data source: Google Ads Transparency Center (https://adstransparency.google.com). (355 characters)

3. Long Description

Google Ads Transparency Explorer: Ad Creatives & Dates extracts structured public ad transparency records from the Google Ads Transparency Center (https://adstransparency.google.com) by advertiser name, domain, or Google Advertiser ID (AR...). Built for competitive intelligence teams, performance marketers, compliance researchers, and AI agents, it communicates directly with Google's public JSON RPC endpoints (/anji/_/rpc/*) without headless browser overhead and without re-hosting third-party creative assets.

Key Capabilities

• Direct Name, Domain, or AR ID Resolution (queries): Pass "Nike, Inc.", "shopify.com", or "AR16735076323512287233"—the Actor resolves advertiser names automatically via SearchService/SearchSuggestions.
• Incremental Launch Date Filtering (firstShownAfter): Specify an ISO date ("2026-01-01"), timestamp, or relative window ("1d", "7d", "24h") to collect only newly launched ads. Unmatched ads scanned during filtering are never billed.
• Region & Format Filters: Filter by ISO 3166-1 alpha-2 country code ("US", "GB", "DE", "ES", etc.) and creative format ("any", "text", "image", "video").
• Optional Per-Creative Regional Breakdown (includeDetails): Enable includeDetails: true to fetch per-country metadata via LookupService/GetCreativeById.
• Apify Proxy Rotation & Safety Controls: Supports "DATACENTER" and "RESIDENTIAL" Apify Proxy groups (proxyGroup) on port 8000 with fresh per-request connections, exponential retry backoff on HTTP 429/503, and an automatic safety stop after 3 consecutive failed queries.

4. Categories & Keywords

• Categories: MARKETING, COMPETITIVE_INTELLIGENCE, AI
• Keywords: google ads transparency, ad library, competitor ad monitoring, ad creatives, advertiser intelligence, paid search monitoring, video ads, display ads, pay per event, ai agent tool

5. Pricing Summary

• Model: Pay-Per-Event (PAY_PER_EVENT)
• Actor Start (apify-actor-start): $0.00 USD
• Dataset Item (apify-default-dataset-item): $0.0025 USD per returned ad creative ($2.50 per 1,000 ads)

6. Frequently Asked Questions (FAQ)

Q1: What does this Actor cost to run?

It costs $0.0025 USD per returned ad creative ($2.50 per 1,000 ads) under Apify's Pay-Per-Event model, with a $0.00 startup fee and $0.00 monthly rental. Platform compute (256 MB) and proxy usage are included in the per-item price.

Q2: Why does this Actor charge per item instead of charging a startup or monthly fee?

Per-item billing (apify-default-dataset-item) aligns cost strictly with delivered results. When you run a daily monitoring schedule (firstShownAfter: "1d"), ads scanned that do not match your date cutoff are not charged, failed queries cost $0.00, and a run with zero new ads costs $0.00.

Q3: What data fields does each output item return?

Every item includes advertiserId (AR...), advertiserName, creativeId (CR...), format (text, image, or video), firstShown and lastShown (UTC ISO-8601 timestamps), regions (country codes or per-country objects when includeDetails: true), previewUrl, transparencyUrl, query, fetchedAt, and source ("Google Ads Transparency Center").

Q4: Do I need a Google API key or logged-in Google account?

No. The Actor queries the unauthenticated public RPC endpoints of https://adstransparency.google.com and requires no API key, no cookies from personal Google accounts, and no login.

Q5: What are the rate limits, proxy options, and operational limits?

The Actor runs at a polite cadence (<= 1 request/second), supports "DATACENTER" and "RESIDENTIAL" Apify Proxy groups (proxyGroup), caps maxItemsPerQuery at 1,000 and maxItems at 5,000, and scans up to maxScanPerQuery (default 400) ads per query when firstShownAfter is active. Note that enabling includeDetails: true adds one extra RPC call per ad (~1.3s/ad).

Q6: What are common usage examples for this Actor?

1. Daily Competitor Ad Monitoring: Schedule a daily run with queries: ["shopify.com", "booking.com"] and firstShownAfter: "1d" to capture newly launched creatives at zero fixed cost.
2. Regional Campaign Audit: Query queries: ["Nike, Inc."], region: "DE", and format: "video" to inspect active video campaigns in Germany.
3. AI Agent Due Diligence: Invoke via MCP with maxItemsPerQuery: 5 to let an AI agent summarize a company's active ad presence for $0.0125.

Google Ads Transparency Explorer: Ad Creatives & Dates

Extract public ad creative metadata, formats (text, image, video), active date ranges (firstShown, lastShown), regional breakdowns, and official preview links from Google Ads Transparency Center (adstransparency.google.com) by advertiser name, domain, or Google Advertiser ID (AR...).

Attribution Notice: All data extracted by this Actor comes from the public Google Ads Transparency Center. Each output item includes "source": "Google Ads Transparency Center" and the direct transparencyUrl link (https://adstransparency.google.com).

Key Features

1. Flexible Advertiser Query Resolution (queries):

• Pass Google Advertiser IDs directly (e.g., "AR16735076323512287233"), domains (e.g., "shopify.com", "booking.com"), or advertiser names (e.g., "Nike, Inc.", "Duolingo").

1. Incremental Monitoring Filter (firstShownAfter):

• Set firstShownAfter to a date ("2026-01-01"), an ISO-8601 UTC timestamp, or a relative window ("1d", "7d", "24h") to retrieve only newly launched ads.
• Ideal for daily or weekly schedules: a run that finds zero new ads finishes cleanly and costs $0.00.

1. Region & Format Filtering:

• Filter by any ISO 3166-1 alpha-2 country code ("US", "GB", "DE", "ES", "FR", "BR", "JP", etc., or "" for all regions) and ad format ("any", "text", "image", "video").

1. Optional Per-Creative Regional Breakdown (includeDetails):

• Keep includeDetails: false (default) for fast bulk extraction (up to 40 ads per RPC call), or enable includeDetails: true to query LookupService/GetCreativeById for per-country date ranges.

1. Apify Proxy Support, Session Rotation & Safety Stop:

• Supports Apify Proxy (proxyGroup: "DATACENTER" or "RESIDENTIAL") on port 8000 with fresh per-request HTTP connections and automatic fallback to direct mode when running locally without credentials.
• Operates at <= 1 request/second, rotates anonymous sessions on HTTP 503 or 429, does not retry permanent 4xx errors, and stops after 3 consecutive failed queries.

1. Zero Re-hosting of Ad Assets:

• Returns Google's official previewUrl and transparencyUrl links without downloading or re-hosting third-party creative images or videos.

Input Parameters

Example Input

{
  "queries": [
    "AR16735076323512287233",
    "shopify.com",
    "Duolingo",
    "booking.com",
    "amazon.com"
  ],
  "region": "US",
  "format": "any",
  "firstShownAfter": "",
  "maxItemsPerQuery": 5,
  "maxItems": 25,
  "includeDetails": false,
  "proxyGroup": "DATACENTER",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Output Schema

Each dataset item represents one public ad creative:

{
  "advertiserId": "AR16735076323512287233",
  "advertiserName": "Nike, Inc.",
  "creativeId": "CR05039561071455633409",
  "format": "text",
  "firstShown": "2023-11-17T03:48:36Z",
  "lastShown": "2026-10-19T19:15:44Z",
  "regions": [
    "US"
  ],
  "previewUrl": "https://tpc.googlesyndication.com/archive/simgad/7270270668040141288",
  "transparencyUrl": "https://adstransparency.google.com/advertiser/AR16735076323512287233/creative/CR05039561071455633409?region=US",
  "query": "AR16735076323512287233",
  "fetchedAt": "2026-10-19T19:40:10Z",
  "source": "Google Ads Transparency Center"
}

Pricing (Pay-Per-Event)

You pay only for successfully extracted ad creative items (apify-default-dataset-item). Startup (apify-actor-start), unmatched ads during firstShownAfter scans, and failed queries cost $0.00:

• Price per ad creative (apify-default-dataset-item): $0.0025 USD per ad ($2.50 per 1,000 ads), all-inclusive of platform compute (256 MB) and proxy usage.
• Spending Cap Enforcement: Checks is_event_charge_limit_reached("apify-default-dataset-item") before emitting every item and stops cleanly when your budget limit is reached.

Technical Reference: Public RPC Endpoints Used

This Actor communicates with the unauthenticated JSON RPC endpoints of https://adstransparency.google.com using URL-encoded f.req payloads:

1. POST /anji/_/rpc/SearchService/SearchSuggestions?authuser= — Resolves advertiser names to AR... IDs or domains.
2. POST /anji/_/rpc/SearchService/SearchCreatives?authuser= — Lists up to 40 ad creatives per page matching an advertiser ID or domain.
3. POST /anji/_/rpc/LookupService/GetCreativeById?authuser= (only when includeDetails: true) — Fetches per-country metadata for a specific creative.

Frequently Asked Questions (FAQ)

1. What does this Actor cost?

This Actor uses Apify's Pay-Per-Event (PPE) model at $0.0025 USD per returned ad creative ($2.50 per 1,000 ads), with a $0.00 startup fee and $0.00 monthly subscription. Platform compute and proxy traffic are included.

2. Why does this Actor charge per item instead of a monthly subscription or startup fee?

Per-item charging (apify-default-dataset-item) lets you run scheduled monitoring (firstShownAfter: "1d") or small AI agent lookups without paying a $10–$20/month fixed rental fee. If an advertiser launches zero new ads today, or if a query fails, your run costs $0.00.

3. What data fields does each output item return?

Each record returns advertiserId (AR...), advertiserName, creativeId (CR...), format (text, image, or video), firstShown and lastShown (UTC ISO-8601 timestamps), regions (country code list, or per-country objects when includeDetails: true), previewUrl, transparencyUrl, query, fetchedAt, and source ("Google Ads Transparency Center").

4. Do I need a Google API key or logged-in Google account?

No. All data comes from the public, unauthenticated Google Ads Transparency Center endpoints (adstransparency.google.com/anji/_/rpc/*). No API key or Google account is required.

5. What are the rate limits, proxy options, and operational limits?

The Actor paces requests at <= 1 request/second (min_interval_seconds = 1.1s), supports "DATACENTER" and "RESIDENTIAL" Apify Proxy groups via proxyGroup, caps maxItemsPerQuery at 1,000 and maxItems at 5,000, and scans up to maxScanPerQuery (default 400) ads when firstShownAfter is set. If 3 queries fail consecutively, a safety stop ends the run cleanly.

6. How can I use this Actor in daily workflows or AI agent pipelines?

• Competitor Launch Alerts: Schedule a daily run with queries: ["shopify.com", "wix.com"], region: "US", and firstShownAfter: "1d" to receive only ads launched in the last 24 hours.
• Format-Specific Creative Audits: Filter by format: "video" and maxItemsPerQuery: 50 to inspect video campaigns across target markets.
• AI Agent / MCP Brand Research: Let an autonomous agent query maxItems: 10 for any company name or domain at $0.025 per call.

Terms of Service, robots.txt & Rule 0 Compliance Verification — google-ads-transparency

• Actor: google-ads-transparency (Google Ads Transparency Explorer: Ad Creatives & Dates)
• Target Source: Google Ads Transparency Center (https://adstransparency.google.com)
• Initial Verification Date: 2026-10-19 (Reviewed & updated for Store kit: 2026-10-21)
• Rule 0 Verdict: APPROVED (GO) — Public advertising transparency metadata only; zero personal data (PII), zero authenticated sessions, robots.txt unrestricted (HTTP 404), and zero re-hosting of third-party creative media.

1. Executive Rule 0 Checklist

2. Literal Quotes & Official Sources

A. Google Terms of Service (https://policies.google.com/terms?hl=en-US)

Under "Respect others / Don't abuse our services", Google states:

"Don't abuse, harm, interfere with, or disrupt the services — for example, by accessing or using them in fraudulent or deceptive ways, introducing malware, or spamming, hacking, or bypassing our systems or protective measures. Note that when you use the services, you shouldn't access them in an automated way in violation of the machine-readable instructions on our web pages (for example, robots.txt files that disallow crawling, training, or other activities)."

B. https://adstransparency.google.com/robots.txt Verification (2026-10-19)

• Checked URL: https://adstransparency.google.com/robots.txt
• Observed HTTP Status: HTTP/2 404 Not Found
• **RFC 9309 Standard Interpretation (RFC 9309 Section 2.3.1.4, "Unavailable" status):**

"If the server returns a 4xx status code for robots.txt, the crawler MAY access any resources on the server."

• Endpoints Queried by This Actor:

1. POST https://adstransparency.google.com/anji/_/rpc/SearchService/SearchSuggestions?authuser=
2. POST https://adstransparency.google.com/anji/_/rpc/SearchService/SearchCreatives?authuser=
3. POST https://adstransparency.google.com/anji/_/rpc/LookupService/GetCreativeById?authuser=

3. Technical Controls & Honest Residual Risk Assessment

1. Zero Asset Re-hosting (Intellectual Property Protection):

• Advertisers retain copyright over their ad images, videos, and copy.
• This Actor never downloads, caches, or re-hosts image files, video streams, or creative HTML bundles. It returns only public metadata (creativeId, format, firstShown, lastShown, regions) and links (previewUrl, transparencyUrl) served directly by Google.

1. Anonymous Public Access Only: No Google accounts, cookies, or CAPTCHA solvers are used.
2. Honest Residual Risk (Upstream Rate Limiting & RPC Field Changes):

• IP Throttling (HTTP 429 / HTTP 503): Google may throttle high-volume requests from shared datacenter IP ranges with HTTP 429 or HTTP 503 ("automated queries").
• Mitigation Without Circumvention: The Actor paces traffic at <= 1 request/second (min_interval_seconds = 1.1s), supports Apify Proxy rotation (DATACENTER and RESIDENTIAL via proxyGroup), stops early after 3 consecutive failed queries, and charges $0.00 for failed queries or unmatched scan items.
• Unversioned Protobuf-JSON RPC Risk: Because /anji/_/rpc/* uses numeric protobuf-JSON field keys ("1", "2", "3", etc.), upstream changes to Google's frontend schema could alter field positions. Offline fixture tests (tests/test_unit.py) and the pre-release canary (batches/B6/canary.py) validate parser compatibility before publication.