tubetext/google-ads-transparency-video
tubetext--google-ads-transparency-videoThis tool calls the Actor "tubetext/google-ads-transparency-video" and retrieves its output results. Actor description: Get any advertiser's YouTube video ads from Google Ads Transparency by brand, domain or advertiser ID. Returns video link, title, views, first/last shown dates, days running and creative IDs; optional transcript. $0.003 per ad (+$0.002 transcript); not-found advertisers are free. · by TubeText
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dateTo | No | Only ads shown on or before this date. | |
| region | No | Only ads shown in this country. Example values: "anywhere" | anywhere |
| onlyNew | No | Skip videos this account already got for the same advertiser and region. Skipped ads are free. | |
| dateFrom | No | Only ads shown on or after this date (2026-09-01) or within a period ('30 days'). | |
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| includeSrt | No | Transcript as SRT subtitles. | |
| advertisers | No | Brand names (Nike), domains (nike.com), advertiser IDs (AR...) or adstransparency.google.com advertiser links. A brand's own domain finds its ads most reliably. Example values: ["Nike"] | |
| maxConcurrency | No | Ads processed in parallel. Example values: 8 | |
| includeTranscript | No | Spoken text from the YouTube video's captions. Charged only when a transcript exists. | |
| includeVideoStats | No | Title, channel, views, likes, publish time and duration of the YouTube video. Example values: true | |
| maxAdsPerAdvertiser | No | Unique videos, newest first. A video that runs as several creatives is one row (all creative IDs are listed). Example values: 20 | |
| transcriptLanguages | No | Preferred caption languages in order. Example values: ["en"] |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Advisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key | |
| runId | Yes | Actor run ID | |
| stats | No | Run statistics | |
| status | Yes | Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED | |
| actorId | Yes | Stable Apify Actor ID from the run record | |
| summary | Yes | Past-tense summary of the run state | |
| exitCode | No | Actor process exit code; populated for terminal states (especially FAILED) | |
| nextStep | Yes | One primary follow-up action with identifiers interpolated | |
| storages | Yes | Dataset and key-value store metadata, keyed by alias. "default" is always the primary entry. | |
| actorName | No | "username/actor-name" | |
| startedAt | No | ISO timestamp when the run started | |
| finishedAt | No | ISO timestamp when the run finished (terminal states only) | |
| statusMessage | No | Pass-through from Apify run.statusMessage | |
| apifyConsoleUrl | No | Personalized Apify Console link to the run; present only for Console sessions |