tubetext/video-ad-analyzer
tubetext--video-ad-analyzerDestructive
This tool calls the Actor "tubetext/video-ad-analyzer" and retrieves its output results. Actor description: Analyze competitors' video ads from a brand name or domain, or from ad video links. Returns hook, angle, offer, CTA, script and shot list per ad, pulled from Meta Ad Library or Google Ads Transparency (YouTube). No analysis fee on failure; Actor Start and Meta fetching fees may apply. · by TubeText
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| adUrls | No | Optional: ad videos you already have – YouTube, TikTok, Instagram, Facebook links or direct .mp4 links (e.g. video URLs from the Meta Ad Library). | |
| region | No | Only ads shown in this country. Example values: "anywhere" | anywhere |
| 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. | |
| datasetId | No | Optional: chain an ad library scraper (Meta / Facebook Ad Library, TikTok ads, Google transparency). We find each row's video, advertiser, ad copy, CTA, landing page and dates automatically. Image and text ads are skipped for free. Pick the dataset (or paste its ID via API); read-only access to this one dataset is requested. | |
| metaBrands | No | Competitors to research in the Meta Ad Library (Facebook & Instagram video ads): a brand name (HelloFresh), a Facebook page link (facebook.com/HelloFreshUS) or a numeric page ID. Only the brand's own active video ads are used; ads by other advertisers that mention the brand are left out. | |
| advertisers | No | Provide at least one of: advertisers / metaBrands / adUrls / datasetId. Competitors to research in the Google Ads Transparency Center (YouTube video ads): a brand name (HelloFresh), a domain (grammarly.com), an advertiser ID (AR…) or an adstransparency.google.com advertiser link. Example values: ["grammarly.com"] | |
| metaCountry | No | Two-letter country code where the Meta ads ran (US, GB, DE…). Example values: "US" | US |
| maxConcurrency | No | Ads analyzed in parallel. Example values: 5 | |
| outputLanguage | No | Language of the analysis. Example values: "English" | English |
| maxVideoMinutes | No | Longer videos are skipped (free). Example values: 10 | |
| translateQuotes | No | Off: quotes stay in the ad's original language. On: they are translated into the output language too. | |
| includeTranscript | No | Adds the ad's spoken words as plain and timestamped text. Example values: true | |
| maxAdsPerAdvertiser | No | Video ads analyzed per brand, newest first as listed by Google. For a dataset, the maximum number of ads read from it is 20× this value. Example values: 2 |
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 |