CaptapiInstall

Summary

Fetches Google Ads Transparency Center ads for a company or advertiser, with optional country, date, sort, topic, pagination, result-limit, and cache settings. Commercial advertiser results omit spend and impression ranges; the operation returns a response envelope with pagination details.

Inputs

• Advertiser (required) — Advertiser name, domain (such as nike.com), or Google advertiser ID (AR…). Prefer an AR… ID from advertiser search.
• Country — Two-letter ISO country or region code. Alias: Region. Defaults to US.
• Region — Alias for Country.
• Start Date — YYYY-MM-DD; keeps creatives whose shown window overlaps this date.
• End Date — YYYY-MM-DD; keeps creatives whose shown window overlaps this date.
• Sort — Client-side sort by last_shown (recent activity first) or first_shown. Defaults to the API's ATC order.
• Cursor — Pagination cursor returned as nextCursor.
• Topic — Only "all" is supported for commercial Ads Transparency Center results. isActive is true when lastShown is within the prior 7 UTC days.
• Limit — Maximum number of ads to return; defaults to 20 and is capped at 200.
• Cache — Set true to use the 24-hour response cache; defaults to false, which fetches fresh results. Cache hits include cached and cachedAt in the response envelope.

Output shape

A response envelope containing matching company ads and pagination information.

Use nextCursor to request another page. Commercial advertisers omit spend and impression ranges. The declared credit behavior is a flat 2 credits when results are returned and 0 credits when totalReturned is 0.

Links

• n8n community nodes installation guide