tubetext/video-breakdown-ai
tubetext--video-breakdown-aiDestructive
This tool calls the Actor "tubetext/video-breakdown-ai" and retrieves its output results. Actor description: Turn TikTok, Instagram and YouTube videos into references for your next creative brief. Get the opening hook, script, visual breakdown and pacing in structured output—ready to compare across videos or use with ChatGPT and Claude.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| urls | No | YouTube videos, Shorts, playlists and channels (e.g. youtube.com/@name or youtube.com/@name/shorts), TikTok videos and photo slideshows (incl. tiktok.com/t/… share links), public Instagram Reels, and public videos from other sites (Reddit, Facebook, Dailymotion, direct .mp4 links…). One per line. Optional if you use a dataset, search or trending input below. Example values: ["https://www.tiktok.com/@okc.dad/video/7682492258666515726","https://www.tiktok.com/@herbi.app/video/7693531155685215521"] | |
| 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 | A dataset from another Actor run, e.g. a TikTok trending, hashtag or profile scraper (pick it, or paste its ID via API). The video links in it are broken down; 'Sort dataset by' decides which come first and 'Max videos per source' how many. Read-only access to this one dataset is requested. | |
| proxyMode | No | Datacenter (default): base price. Residential: YouTube videos are fetched through residential IPs first, which pass YouTube's bot checks far more often (useful for popular videos and large batches), billed extra per started MB of residential traffic: typically 5-15 MB per video (about $0.08-0.23 at $0.015/MB). Other platforms are not affected. Example values: "datacenter" | datacenter |
| channelSort | No | For channel links (including /shorts and /streams tabs): take the newest videos, or the channel's most viewed ones. Example values: "newest" | newest |
| searchSortBy | No | 'Most viewed' re-sorts the results by their actual view count. Example values: "views" | views |
| datasetSortBy | No | How to pick videos from the dataset when it has more than 'Max videos per source'. Example values: "views" | views |
| searchQueries | No | YouTube search terms, e.g. 'skincare routine'. Each search takes the top videos for the time range and sort below (up to 'Max videos per source'). | |
| accountSummary | No | For a YouTube channel or Instagram profile input, adds one extra row (rowType 'account_summary') that condenses the account's analyzed videos into persona, content pillars, hook patterns, formats, pacing, CTAs, products, what performs best, posting cadence and a style guide. Needs at least 3 analyzed videos. Free during the beta. Example values: true | |
| maxConcurrency | No | How many videos to analyze in parallel. Example values: 5 | |
| outputLanguage | No | Language of the analysis (summary, hook, scenes, actions, notes). 'Same as video' follows the video's own language. Example values: "English" | English |
| maxVideoMinutes | No | Longer videos are skipped (not charged). Example values: 60 | |
| translateQuotes | No | By default quotes stay in their original language. Turn on to translate them into the output language too (the full original transcript is still included). | |
| includeTranscript | No | Adds 'transcript' and 'timestampedTranscript' (platform captions, or Whisper AI when people speak without captions). Example values: true | |
| trendingCountries | No | Two-letter country codes, e.g. us, jp, de, br, in, kr, fr, gb. Takes the top of each country's daily trending list (source: kworb.net; YouTube retired its own trending page). | |
| maxVideosPerSource | No | For channel, playlist, dataset, search and trending inputs: how many videos to take from each (each is billed like a single video). Single video links are not affected. Example values: 10 | |
| searchPublishedWithin | No | Only videos uploaded within this time range (YouTube's own upload-date filter). Example values: "week" | week |
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 |