tubetext/meta-ad-library-videos
tubetext--meta-ad-library-videosDestructive
This tool calls the Actor "tubetext/meta-ad-library-videos" and retrieves its output results. Actor description: Facebook Ad Library scraper API: get Meta ads (Facebook, Instagram) from brand names, page links or keywords. Returns video URL, thumbnail, ad copy, CTA, landing page, platforms and dates; optional image, carousel and text ads. $1.50 per 1,000 ads; brands with no ads are free. · by TubeText
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brands | No | Provide at least one of: brands / keywords. Brand names (HelloFresh), Facebook page links (facebook.com/HelloFreshUS) or numeric page IDs. Brand names are matched to the advertiser's page, so ads from other advertisers that mention the brand are left out. Example values: ["HelloFresh"] | |
| adTypes | No | Video ads only (default), or every ad format. Image, carousel and text ads come with imageUrls and adFormat; each ad is billed the same. Example values: "video" | video |
| country | No | Two-letter country code where the ads ran (US, GB, DE…), or ALL. Example values: "US" | US |
| onlyNew | No | Skip ads already delivered by your earlier runs for the same brand or keyword and country (ad IDs are remembered in a named key-value store in your account). Nothing new = a free 'no_new_ads' row and no search fee. | |
| keywords | No | Search the Ad Library like its search box (e.g. meal kit, protein powder): video ads from every advertiser whose ads match, newest first. Use Brands above to get one brand's own ads only. | |
| 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. | |
| activeOnly | No | Only ads that are currently running. Example values: true | |
| maxAdsPerBrand | No | Newest-first as the Ad Library lists them. Example values: 30 | |
| debugCheckDownloads | No | Internal test: tries to download 3 video URLs and records size and link expiry. |
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 |