Get video history
Retrieve a list of videos, with an optional ids param to filter vdieo by their UUIDs.
Authorizations
API ID, from your settings page.
API Key, from your settings page.
Query Parameters
Comma-separated list of UUIDs to filter. Maximum 100 entries allowed.
1
Response
Link associated with the video.
Media job associated with the video. Default is null.
Reason for failure. Default is null.
Generated Video URL
Generated Video Thumbnail URL
Credits used in this api call
Preview URL
List of previews
AvatarBubbleTemplate
- Avatar Bubble (Applicable to aspect_ratio 9x16, 16x9, 1x1)DramaticTemplate
- Dramatic (Applicable to aspect_ratio 9x16)DynamicGreenScreenEffect
- Dynamic Green Screen Effect (Applicable to aspect_ratio 9x16, 16x9, 1x1)DynamicProductTemplate
- Product (Applicable to aspect_ratio 9x16, 16x9, 1x1)DynamicResponseBubbleTemplate
- Response Bubble (Applicable to aspect_ratio 9x16)EnhancedVanillaTemplate
- Dynamic Vanilla (Applicable to aspect_ratio 9x16, 16x9, 1x1)FullScreenTemplate
- Full Screen (Applicable to aspect_ratio 9x16, 16x9, 1x1)FullScreenV2Template
- Full Screen V2 (Applicable to aspect_ratio 9x16, 16x9, 1x1)GreenScreenEffectTemplate
- Green Screen Effect (Applicable to aspect_ratio 9x16, 16x9, 1x1)LegoTemplate
- Lego (Applicable to aspect_ratio 9x16, 16x9, 1x1)MotionCardsTemplate
- Motion Cards (Applicable to aspect_ratio 9x16, 16x9, 1x1)OverCardsTemplate
- Over Cards (Applicable to aspect_ratio 9x16, 16x9, 1x1)QuickTransitionTemplate
- Quick Transition (Applicable to aspect_ratio 9x16, 16x9, 1x1)ScribbleTemplate
- Scribble (Applicable to aspect_ratio 9x16, 16x9, 1x1)SideBySideTemplate
- Side by Side (Applicable to aspect_ratio 9x16, 16x9, 1x1)SimpleAvatarOverlayTemplate
- Product Presenter (Applicable to aspect_ratio 9x16, 16x9, 1x1)TopBottomTemplate
- Top & Bottom (Applicable to aspect_ratio 9x16, 1x1)TwitterFrameTemplate
- Twitter Frame (Applicable to aspect_ratio 9x16, 16x9, 1x1)VanillaTemplate
- Vanilla (Applicable to aspect_ratio 9x16, 16x9, 1x1)VlogTemplate
- Vlog (Applicable to aspect_ratio 9x16)LegoVisualEmotional
- Emotional (Applicable to aspect_ratio 9x16, 16x9, 1x1)LegoVisualCutePets
- Cute Pets (Applicable to aspect_ratio 9x16, 16x9, 1x1)LegoVisualAvatarFocusIntro
- Avatar Focus Intro (Applicable to aspect_ratio 9x16, 16x9, 1x1)LegoScriptNegativeHook
- Don’t Use This If You Want... (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptNumberOneHook
- The #1 Hack You Need (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptEverWonderHook
- Ever Wonder Why? (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptSecretHook
- Wish I Could Keep This Secret (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptWhatHappensHook
- What Happens If You Try This? (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptAnyoneElseHook
- That One Thing We All Have (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptAmazedHook
- Still Amazed by This (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScript2025Hook
- Hack 2025 Like This (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptHateMeHook
- They’ll Hate Me for This (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptResponseBubbleTextOverlay
- Response bubble (Applicable to aspect_ratio 9x16, 1x1)LegoScriptHeyAlgorithmHook
- Hey Algorithm (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptCannotBelieveHook
- Cannot Believe This (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptFinallyConfidentHook
- Finally Confident (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptPremiumFeelingHook
- Premium Feeling (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptFirstTimeFullHook
- First Time Full (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptLongLineReasonHook
- Long Line Reason (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptMissingOutAlertHook
- Missing Out Alert (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptBetterTodayVersionHook
- Better Today Version (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptBigHappeningHook
- Big Happening (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptPriceDropRegretHook
- Price Drop Regret (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptGroupBuyFrustrationHook
- Group Buy Frustration (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptStopAffordExcuseHook
- Stop Afford Excuse (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptLifeTooShortDiscountHook
- Life Too Short Discount (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptHugePriceDropRushHook
- Huge Price Drop Rush (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptPriceCouldGoLowerHook
- Price Could Go Lower (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptStillFullPriceHook
- Still Full Price (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptSecretDiscountShareHook
- Secret Discount Share (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptVoucherSavingsAlertHook
- Voucher Savings Alert (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptCouponDiscoveryRegretHook
- Coupon Discovery Regret (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptBestDealEverHook
- Best Deal Ever (Applicable to aspect_ratio 9x16, 1x1, 16x9)
AvatarBubbleTemplate
, DramaticTemplate
, DynamicGreenScreenEffect
, DynamicProductTemplate
, DynamicResponseBubbleTemplate
, EnhancedVanillaTemplate
, FullScreenTemplate
, FullScreenV2Template
, GreenScreenEffectTemplate
, LegoTemplate
, MotionCardsTemplate
, OverCardsTemplate
, QuickTransitionTemplate
, ScribbleTemplate
, SideBySideTemplate
, SimpleAvatarOverlayTemplate
, TopBottomTemplate
, TwitterFrameTemplate
, VanillaTemplate
, VlogTemplate
, LegoVisualEmotional
, LegoVisualCutePets
, LegoVisualAvatarFocusIntro
, LegoScriptNegativeHook
, LegoScriptNumberOneHook
, LegoScriptEverWonderHook
, LegoScriptSecretHook
, LegoScriptWhatHappensHook
, LegoScriptAnyoneElseHook
, LegoScriptAmazedHook
, LegoScript2025Hook
, LegoScriptHateMeHook
, LegoScriptResponseBubbleTextOverlay
, LegoScriptHeyAlgorithmHook
, LegoScriptCannotBelieveHook
, LegoScriptFinallyConfidentHook
, LegoScriptPremiumFeelingHook
, LegoScriptFirstTimeFullHook
, LegoScriptLongLineReasonHook
, LegoScriptMissingOutAlertHook
, LegoScriptBetterTodayVersionHook
, LegoScriptBigHappeningHook
, LegoScriptPriceDropRegretHook
, LegoScriptGroupBuyFrustrationHook
, LegoScriptStopAffordExcuseHook
, LegoScriptLifeTooShortDiscountHook
, LegoScriptHugePriceDropRushHook
, LegoScriptPriceCouldGoLowerHook
, LegoScriptStillFullPriceHook
, LegoScriptSecretDiscountShareHook
, LegoScriptVoucherSavingsAlertHook
, LegoScriptCouponDiscoveryRegretHook
, LegoScriptBestDealEverHook
Name of the video. Default is null.
255
Target platform for the video. Default is 'tiktok'.
255
Target audience for the video. Default is 'young adults'.
Language of the video. Default is 'en'.
ar
- Arabicbg
- Bulgariancs
- Czechda
- Danishde
- Germanel
- Greek, Modernen
- Englishes
- Spanish; Castilianfi
- Finnishfr
- Frenchhi
- Hindihr
- Croatianid
- Indonesianit
- Italianja
- Japaneseko
- Koreanms
- Malaynl
- Dutchpl
- Polishpt
- Portuguesero
- Romanian, Moldavian, Moldovanru
- Russiansk
- Slovaksv
- Swedishta
- Tamiltl
- Tagalogtr
- Turkishuk
- Ukrainianzh
- Chinese
ar
, bg
, cs
, da
, de
, el
, en
, es
, fi
, fr
, hi
, hr
, id
, it
, ja
, ko
, ms
, nl
, pl
, pt
, ro
, ru
, sk
, sv
, ta
, tl
, tr
, uk
, zh
Length of the video in seconds. Default is 15.
15
- 1530
- 3060
- 60
15
, 30
, 60
Aspect ratio of the video. Default is '16x9'.
16x9
- 16x91x1
- 1x19x16
- 9x16
16x9
, 1x1
, 9x16
Script style of the video. Default is DiscoveryWriter.
BenefitsV2
- BenefitsBrandStoryV2
- Brand StoryCallToActionV2
- Call To ActionDiscoveryWriter
- DiscoveryDontWorryWriter
- Don't WorryEmotionalWriter
- EmotionalGenzWriter
- Gen ZHowToV2
- How ToLetMeShowYouWriter
- Let Me Show YouMotivationalWriter
- MotivationalProblemSolutionV2
- Problem SolutionProblemSolutionWriter
- Problem-SolutionProductHighlightsV2
- Product HighlightsProductLifestyleV2
- Product LifestyleResponseBubbleWriter
- Response BubbleSpecialOffersV2
- Special OffersStoryTimeWriter
- StorytimeThreeReasonsWriter
- 3 Reasons WhyTrendingTopicsV2
- Trending TopicsDIY
- DIY
BenefitsV2
, BrandStoryV2
, CallToActionV2
, DiscoveryWriter
, DontWorryWriter
, EmotionalWriter
, GenzWriter
, HowToV2
, LetMeShowYouWriter
, MotivationalWriter
, ProblemSolutionV2
, ProblemSolutionWriter
, ProductHighlightsV2
, ProductLifestyleV2
, ResponseBubbleWriter
, SpecialOffersV2
, StoryTimeWriter
, ThreeReasonsWriter
, TrendingTopicsV2
, DIY
Visual style of the video. Default is AvatarBubbleTemplate.
AvatarBubbleTemplate
- Avatar Bubble (Applicable to aspect_ratio 9x16, 16x9, 1x1)DramaticTemplate
- Dramatic (Applicable to aspect_ratio 9x16)DynamicGreenScreenEffect
- Dynamic Green Screen Effect (Applicable to aspect_ratio 9x16, 16x9, 1x1)DynamicProductTemplate
- Product (Applicable to aspect_ratio 9x16, 16x9, 1x1)DynamicResponseBubbleTemplate
- Response Bubble (Applicable to aspect_ratio 9x16)EnhancedVanillaTemplate
- Dynamic Vanilla (Applicable to aspect_ratio 9x16, 16x9, 1x1)FullScreenTemplate
- Full Screen (Applicable to aspect_ratio 9x16, 16x9, 1x1)FullScreenV2Template
- Full Screen V2 (Applicable to aspect_ratio 9x16, 16x9, 1x1)GreenScreenEffectTemplate
- Green Screen Effect (Applicable to aspect_ratio 9x16, 16x9, 1x1)LegoTemplate
- Lego (Applicable to aspect_ratio 9x16, 16x9, 1x1)MotionCardsTemplate
- Motion Cards (Applicable to aspect_ratio 9x16, 16x9, 1x1)OverCardsTemplate
- Over Cards (Applicable to aspect_ratio 9x16, 16x9, 1x1)QuickTransitionTemplate
- Quick Transition (Applicable to aspect_ratio 9x16, 16x9, 1x1)ScribbleTemplate
- Scribble (Applicable to aspect_ratio 9x16, 16x9, 1x1)SideBySideTemplate
- Side by Side (Applicable to aspect_ratio 9x16, 16x9, 1x1)SimpleAvatarOverlayTemplate
- Product Presenter (Applicable to aspect_ratio 9x16, 16x9, 1x1)TopBottomTemplate
- Top & Bottom (Applicable to aspect_ratio 9x16, 1x1)TwitterFrameTemplate
- Twitter Frame (Applicable to aspect_ratio 9x16, 16x9, 1x1)VanillaTemplate
- Vanilla (Applicable to aspect_ratio 9x16, 16x9, 1x1)VlogTemplate
- Vlog (Applicable to aspect_ratio 9x16)LegoVisualEmotional
- Emotional (Applicable to aspect_ratio 9x16, 16x9, 1x1)LegoVisualCutePets
- Cute Pets (Applicable to aspect_ratio 9x16, 16x9, 1x1)LegoVisualAvatarFocusIntro
- Avatar Focus Intro (Applicable to aspect_ratio 9x16, 16x9, 1x1)LegoScriptNegativeHook
- Don’t Use This If You Want... (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptNumberOneHook
- The #1 Hack You Need (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptEverWonderHook
- Ever Wonder Why? (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptSecretHook
- Wish I Could Keep This Secret (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptWhatHappensHook
- What Happens If You Try This? (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptAnyoneElseHook
- That One Thing We All Have (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptAmazedHook
- Still Amazed by This (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScript2025Hook
- Hack 2025 Like This (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptHateMeHook
- They’ll Hate Me for This (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptResponseBubbleTextOverlay
- Response bubble (Applicable to aspect_ratio 9x16, 1x1)LegoScriptHeyAlgorithmHook
- Hey Algorithm (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptCannotBelieveHook
- Cannot Believe This (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptFinallyConfidentHook
- Finally Confident (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptPremiumFeelingHook
- Premium Feeling (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptFirstTimeFullHook
- First Time Full (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptLongLineReasonHook
- Long Line Reason (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptMissingOutAlertHook
- Missing Out Alert (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptBetterTodayVersionHook
- Better Today Version (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptBigHappeningHook
- Big Happening (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptPriceDropRegretHook
- Price Drop Regret (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptGroupBuyFrustrationHook
- Group Buy Frustration (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptStopAffordExcuseHook
- Stop Afford Excuse (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptLifeTooShortDiscountHook
- Life Too Short Discount (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptHugePriceDropRushHook
- Huge Price Drop Rush (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptPriceCouldGoLowerHook
- Price Could Go Lower (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptStillFullPriceHook
- Still Full Price (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptSecretDiscountShareHook
- Secret Discount Share (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptVoucherSavingsAlertHook
- Voucher Savings Alert (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptCouponDiscoveryRegretHook
- Coupon Discovery Regret (Applicable to aspect_ratio 9x16, 1x1, 16x9)LegoScriptBestDealEverHook
- Best Deal Ever (Applicable to aspect_ratio 9x16, 1x1, 16x9)
AvatarBubbleTemplate
, DramaticTemplate
, DynamicGreenScreenEffect
, DynamicProductTemplate
, DynamicResponseBubbleTemplate
, EnhancedVanillaTemplate
, FullScreenTemplate
, FullScreenV2Template
, GreenScreenEffectTemplate
, LegoTemplate
, MotionCardsTemplate
, OverCardsTemplate
, QuickTransitionTemplate
, ScribbleTemplate
, SideBySideTemplate
, SimpleAvatarOverlayTemplate
, TopBottomTemplate
, TwitterFrameTemplate
, VanillaTemplate
, VlogTemplate
, LegoVisualEmotional
, LegoVisualCutePets
, LegoVisualAvatarFocusIntro
, LegoScriptNegativeHook
, LegoScriptNumberOneHook
, LegoScriptEverWonderHook
, LegoScriptSecretHook
, LegoScriptWhatHappensHook
, LegoScriptAnyoneElseHook
, LegoScriptAmazedHook
, LegoScript2025Hook
, LegoScriptHateMeHook
, LegoScriptResponseBubbleTextOverlay
, LegoScriptHeyAlgorithmHook
, LegoScriptCannotBelieveHook
, LegoScriptFinallyConfidentHook
, LegoScriptPremiumFeelingHook
, LegoScriptFirstTimeFullHook
, LegoScriptLongLineReasonHook
, LegoScriptMissingOutAlertHook
, LegoScriptBetterTodayVersionHook
, LegoScriptBigHappeningHook
, LegoScriptPriceDropRegretHook
, LegoScriptGroupBuyFrustrationHook
, LegoScriptStopAffordExcuseHook
, LegoScriptLifeTooShortDiscountHook
, LegoScriptHugePriceDropRushHook
, LegoScriptPriceCouldGoLowerHook
, LegoScriptStillFullPriceHook
, LegoScriptSecretDiscountShareHook
, LegoScriptVoucherSavingsAlertHook
, LegoScriptCouponDiscoveryRegretHook
, LegoScriptBestDealEverHook
Override avatar for the video. Default is null.
255
Override voice for the video. Default is null.
255
Override script for the video. Default is null.
Background music URL for the video. Default is null, video will use random music.
255
Volume of the background music, ranging from 0.0 to 1.0. Default is null, video will use default music volume of visual_style.
0 <= x <= 1
Volume of the voiceover, ranging from 0.0 to 1.0. Default is null, video will use default voiceover volume of visual_style.
0 <= x <= 1
Webhook URL for status updates. Default is null.
200
No background music for the video. Default is false, video with background music.
No caption for the video. Default is false, video with caption.
No emotion for the video. Default is false, video with emotion.
No call to action for the video. Default is false, video with call to action.
No stock broll for the video. Default is false, video with stock broll.
Deprecated, use style in caption_setting instead. Caption style for the video. Default is 'normal-black'.
normal-black
- NORMAL_BLACKnormal-white
- NORMAL_WHITEnormal-red
- NORMAL_REDnormal-blue
- NORMAL_BLUEneo
- NEObrick
- BRICKfrenzy
- FRENZYverana
- VERANAmustard
- MUSTARDglow
- GLOWmint
- MINTcoolers
- COOLERSbilo
- BILOtoons
- TOONSdeep-blue
- DEEP_BLUEmystique
- MYSTIQUEcaution
- CAUTIONduality
- DUALITY
normal-black
, normal-white
, normal-red
, normal-blue
, neo
, brick
, frenzy
, verana
, mustard
, glow
, mint
, coolers
, bilo
, toons
, deep-blue
, mystique
, caution
, duality
Deprecated, use offset in caption_setting instead. Caption offset x is horizontally relative to the center of the canvas in percentage, range from -0.5 to 0.5. Default is null, video with default caption position of visual_style.
Deprecated, use offset in caption_setting instead. Caption offset y is vertically relative to the center of the canvas in percentage, range from -0.5 to 0.5. Default is null, video with default caption position of visual_style.
Caption setting, default null and default caption setting will be used