google_ad_library_company_ads
Google publishes spend and impression ranges only for election ads; commercial advertisers omit both. isActive is true when lastShown is within 7 UTC days. Costs 2 credits. Empty results and failures are never charged. Pass cache=true for a free 24h cache hit (default always fresh).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Client-side sort: last_shown (recent activity first) or first_shown. Default is ATC order. | |
| cache | No | Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. | |
| limit | No | Max items to return (default 20, max 200). Flat 2 credits when results are returned; 0 credits when totalReturned is 0. | |
| topic | No | Only "all" is supported (commercial ATC). Google publishes spend and impression ranges only for election ads; commercial advertisers omit both. isActive is true when lastShown is within 7 UTC days. | |
| cursor | No | Pagination cursor from nextCursor. | |
| region | No | Alias for country. | |
| country | No | Two-letter ISO country / region code (soft filter). Default US. Alias: region. | |
| end_date | No | YYYY-MM-DD — keep creatives whose shown window overlaps this end. | |
| advertiser | Yes | Advertiser name, domain (e.g. nike.com), or Google advertiser ID (AR…). Prefer AR… from advertiser-search. | |
| start_date | No | YYYY-MM-DD — keep creatives whose shown window overlaps this start. |