Use Case: URL to Video

Full end-to-end use case for transforming a URL into a video using the Creatify API, mirroring the in-app flow.

URL to Video

This use case demonstrates how to replicate the “URL to Video” flow from Creatify App.
It demonstrates how to use Creatify’s APIs to transform a product URL into a complete marketing video — from link scraping, AI script generation, video preview creation, to final video rendering.

For example, given the input URL:

https://www.amazon.com/ATTITUDE-Mineral-Based-Ingredients-Cruelty-free-Moisturizer/dp/B09JZXHJM7

The flow will generate a video:

---

1. Create Link from URL

Extract content (title, description, images, videos, etc.) from a product URL.

POST /api/links/

Example Request

Example request and response:

curl --request POST \
  --url https://api.creatify.ai/api/links/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
    "url": "https://www.amazon.com/ATTITUDE-Mineral-Based-Ingredients-Cruelty-free-Moisturizer/dp/B09JZXHJM7"
}'

{
    "id": "e63ce1e4-97cb-4ba6-937a-50e88925a321",
    "url": "https://www.amazon.com/ATTITUDE-Mineral-Based-Ingredients-Cruelty-free-Moisturizer/dp/B09JZXHJM7",
    "link": {
        "id": "839668ff-ae2a-4500-8f53-c76a1840ed74",
        "url": "https://www.amazon.com/ATTITUDE-Mineral-Based-Ingredients-Cruelty-free-Moisturizer/dp/B09JZXHJM7",
        "title": "ATTITUDE Body Cream, Moisturizer for Dry Skin, EWG Verified, Vegan & Dermatologist-Tested, Deep Hydration, Pear & Amber Scent, 8 Fl Oz (Pack of 6)",
        "description": "About this item    EWG VERIFIED: This body cream for women and men is certified EWG Verified and made with clean ingredients that meet the Environmental Working Group's strict health and safety standards so you can feel confident that it does not contain any potentially concerning ingredients.    CLEAN FORMULA: This ATTITUDE body cream is made with 98% natural-origin ingredients, and free from SLS, SLES, petrolatum, mineral oil, and artificial colors, for a worry-free experience.    HIGH PERFORMANCE: Infused with watercress and Indian cress extracts, this fast-absorbing, non-greasy and non-sticky EWG Verified hand cream leaves hands soft and smooth. Suitable for both women and men.    PEAR & AMBER: This bright and delicate fragrance features juicy pear with vibrant notes of nectarine and ginger for a naturally energizing and refreshing experience.    RESPONSIBLE BEAUTY: Dermatologically tested, 100% vegan, and packaged in an easily recyclable reusable HDPE plastic bottle for a routine that’s kind to everything.    \n ›  See more product details",
        "image_urls": [
            "https://m.media-amazon.com/images/I/71xB-ss26gL._SL1500_.jpg",
            "https://m.media-amazon.com/images/I/71H9i6r9TUL._SL1500_.jpg",
            "https://m.media-amazon.com/images/I/71PHtZce95L._SL1500_.jpg",
            "https://m.media-amazon.com/images/I/81rjeQ6iLOL._SL1500_.jpg",
            "https://m.media-amazon.com/images/I/61YO5awH0OL._SL1500_.jpg",
            "https://m.media-amazon.com/images/I/61uAyKZ1WFL.jpg",
            "https://m.media-amazon.com/images/I/71O3xDdrjTL.jpg",
            "https://m.media-amazon.com/images/I/91BJZbo4nAL.jpg"
        ],
        "video_urls": [
            "https://d35ghwdno3nak3.cloudfront.net/videos/1984d47b-7110-86c3-f38d-b7b3daff27db.mp4",
            "https://d35ghwdno3nak3.cloudfront.net/videos/ebf4c8b5-b774-55f1-28d9-f24a4aa436db.mp4",
            "https://d35ghwdno3nak3.cloudfront.net/videos/3f036f62-d4e1-9a31-6257-6dfb93567cc9.mp4"
        ],
        "reviews": [
            "I can't get enough of this lotion. It's very moisturizing. It glides on without any stickiness and it has a very mild scent. The absolute best feature of this lotion is that it is EWG verified and is easy to apply. I also like that they include olive leaves and watercress leaves in their ingredients. I'm glad I gave this lotion a try.",
            "Fresh scent, not overpowering. Goes on smooth and soaks in and leaves skin soft, not greasy. Love that it's EWG approved so no dangerous ingredients to worry about.",
            "Smells nice. Goes on skin smooth and isn’t greasy. But requires more than other lotions I’ve used for even coverage.",
            "great lotion and non toxic",
            "This is a lovely moisturizer with a fantastic, subtle scent. It is very emollient and leaves my skin soft and moisturized. It goes on white, though, and takes a while for that to soak in, so you wouldn't want to put it on right before going out in shorts or a sundress. I highly recommend!",
            "I have purchased this product multiple times in the past, and was a satisfied customer. It had a nice viscosity and slightly pleasant aroma. As others have noted, recent purchase was different with a viscosity slightly above water (calling this a “body cream” is laughable), and an aroma that is a little off putting, though the scent wears off after a while. Unfortunately, I will not re-order. And the search continues.",
            "Why did you pick this product vs others?:Absorbs well, glad that it is EWG verified.",
            "Leaves my skin so smooth and moisturized. I love how light yet still fragrant the scent is. I also love the non-toxic ingredients! Great value for the price!",
            "Smells great, feels nice on the skin, not greasy. Love that it's a Canadian company",
            "Great for hands, pleasant light smell. Cruelty free and low EWG!",
            "It’s a nice big bottle and doesn’t leave a greasy feel like some lotions do. I use it mostly on my hands and arms, but will rub it on my face too. It’s gentle and has a very mild scent. It’s rated excellent on the Yuka app so I know it’s a healthy product. I will keep buying this.",
            "I was looking for something that did not have chemicals and was good for your skin additude gives you that and more",
            "I was looking for a thicker moisturizing cream but this is almost the consistency of soup, although not as bad as their regular hand cream. If you tip the tube upside down it will just pour out. Goes on nice though and is not greasy. Good for when you need a little moisture on your hands but not a good body cream, doesn't last very long. On the positive end it contains no harmful ingredients, which is why I buy a lot of products from this brand."
        ],
        "logo_url": null,
        "ai_summary": "The ATTITUDE Body Cream is an EWG Verified moisturizer designed for dry skin, made with 98% natural-origin ingredients and free from SLS, SLES, petrolatum, mineral oil, and artificial colors. Suitable for both women and men, this dermatologist-tested, 100% vegan cream offers deep hydration with a fast-absorbing, non-greasy, and non-sticky formula enriched with watercress and Indian cress extracts. It features a refreshing pear and amber scent with notes of nectarine and ginger, providing an energizing fragrance. Packaged in a recyclable HDPE plastic bottle, this moisturizer combines effective skincare with environmental responsibility. This pack contains six 8 fl oz bottles.",
        "ai_industry": "Beauty & Personal Care",
        "ai_target_audiences": [
            "Clean beauty enthusiasts",
            "Vegan skincare users",
            "EWG-conscious consumers",
            "Dry skin sufferers",
            "Eco-friendly shoppers",
            "Fragrance lovers",
            "Dermatology tested users"
        ],
        "brand_color": null,
        "qrcode_url": null,
        "primary_image_url": null
    },
    "credits_used": 1
}

💡 Errors:

1. Successfully scraped the URL but it contains no images or videos.
   status_code: 400
   body: [“Link must have at least one image or one video.”]
2. Failed to scrape the URL (due to anti-scraping or other issues).
   status_code: 400
   body: [“Failed to scrape url: “]

---

2. (Optional) Create Link with Parameters

If you don’t have a URL but have product data, create a link directly using parameters.

POST /api/links/link_with_params/

Example Request

curl --request POST \
  --url https://api.creatify.ai/api/link_with_params/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
    "title": "ATTITUDE Body Cream, Moisturizer for Dry Skin, EWG Verified, Vegan & Dermatologist-Tested, Deep Hydration, Pear & Amber Scent, 8 Fl Oz (Pack of 6)",
    "description": "About this item    EWG VERIFIED: This body cream for women and men is certified EWG Verified and made with clean ingredients that meet the Environmental Working Group's strict health and safety standards so you can feel confident that it does not contain any potentially concerning ingredients.    CLEAN FORMULA: This ATTITUDE body cream is made with 98% natural-origin ingredients, and free from SLS, SLES, petrolatum, mineral oil, and artificial colors, for a worry-free experience.    HIGH PERFORMANCE: Infused with watercress and Indian cress extracts, this fast-absorbing, non-greasy and non-sticky EWG Verified hand cream leaves hands soft and smooth. Suitable for both women and men.    PEAR & AMBER: This bright and delicate fragrance features juicy pear with vibrant notes of nectarine and ginger for a naturally energizing and refreshing experience.    RESPONSIBLE BEAUTY: Dermatologically tested, 100% vegan, and packaged in an easily recyclable reusable HDPE plastic bottle for a routine that’s kind to everything.    \n ›  See more product details",
    "image_urls": [
        "https://m.media-amazon.com/images/I/71xB-ss26gL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71H9i6r9TUL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71PHtZce95L._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/81rjeQ6iLOL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/61YO5awH0OL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/61uAyKZ1WFL.jpg",
        "https://m.media-amazon.com/images/I/71O3xDdrjTL.jpg",
        "https://m.media-amazon.com/images/I/91BJZbo4nAL.jpg"
    ],
    "video_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/videos/1984d47b-7110-86c3-f38d-b7b3daff27db.mp4",
        "https://d35ghwdno3nak3.cloudfront.net/videos/ebf4c8b5-b774-55f1-28d9-f24a4aa436db.mp4",
        "https://d35ghwdno3nak3.cloudfront.net/videos/3f036f62-d4e1-9a31-6257-6dfb93567cc9.mp4"
    ]
}'

{
    "id": "21ce43ad-ae5e-4f3d-96fa-58a1e5b966f0",
    "url": "placeholder-21ce43ad-ae5e-4f3d-96fa-58a1e5b966f0",
    "link": {
        "id": "e6bea53f-1f03-42a8-aee8-637f69714afd",
        "url": "placeholder-21ce43ad-ae5e-4f3d-96fa-58a1e5b966f0",
        "title": "ATTITUDE Body Cream, Moisturizer for Dry Skin, EWG Verified, Vegan & Dermatologist-Tested, Deep Hydration, Pear & Amber Scent, 8 Fl Oz (Pack of 6)",
        "description": "About this item    EWG VERIFIED: This body cream for women and men is certified EWG Verified and made with clean ingredients that meet the Environmental Working Group's strict health and safety standards so you can feel confident that it does not contain any potentially concerning ingredients.    CLEAN FORMULA: This ATTITUDE body cream is made with 98% natural-origin ingredients, and free from SLS, SLES, petrolatum, mineral oil, and artificial colors, for a worry-free experience.    HIGH PERFORMANCE: Infused with watercress and Indian cress extracts, this fast-absorbing, non-greasy and non-sticky EWG Verified hand cream leaves hands soft and smooth. Suitable for both women and men.    PEAR & AMBER: This bright and delicate fragrance features juicy pear with vibrant notes of nectarine and ginger for a naturally energizing and refreshing experience.    RESPONSIBLE BEAUTY: Dermatologically tested, 100% vegan, and packaged in an easily recyclable reusable HDPE plastic bottle for a routine that’s kind to everything.    \n ›  See more product details",
        "image_urls": [
            "https://m.media-amazon.com/images/I/71xB-ss26gL._SL1500_.jpg",
            "https://m.media-amazon.com/images/I/71H9i6r9TUL._SL1500_.jpg",
            "https://m.media-amazon.com/images/I/71PHtZce95L._SL1500_.jpg",
            "https://m.media-amazon.com/images/I/81rjeQ6iLOL._SL1500_.jpg",
            "https://m.media-amazon.com/images/I/61YO5awH0OL._SL1500_.jpg",
            "https://m.media-amazon.com/images/I/61uAyKZ1WFL.jpg",
            "https://m.media-amazon.com/images/I/71O3xDdrjTL.jpg",
            "https://m.media-amazon.com/images/I/91BJZbo4nAL.jpg"
        ],
        "video_urls": [
            "https://d35ghwdno3nak3.cloudfront.net/videos/1984d47b-7110-86c3-f38d-b7b3daff27db.mp4",
            "https://d35ghwdno3nak3.cloudfront.net/videos/ebf4c8b5-b774-55f1-28d9-f24a4aa436db.mp4",
            "https://d35ghwdno3nak3.cloudfront.net/videos/3f036f62-d4e1-9a31-6257-6dfb93567cc9.mp4"
        ],
        "reviews": null,
        "logo_url": null,
        "ai_summary": "ATTITUDE Body Cream is an EWG Verified moisturizer designed for dry skin, made with 98% natural-origin ingredients and free from SLS, SLES, petrolatum, mineral oil, and artificial colors, ensuring a clean and safe formula. Suitable for both women and men, this fast-absorbing, non-greasy, and non-sticky cream is infused with watercress and Indian cress extracts to provide deep hydration, leaving skin soft and smooth. It features a bright, delicate pear and amber scent with notes of nectarine and ginger for a refreshing experience. Dermatologist-tested, 100% vegan, and packaged in a recyclable HDPE plastic bottle, this product supports a responsible and sustainable beauty routine. The pack contains six 8 fl oz bottles.",
        "ai_industry": "Skincare",
        "ai_target_audiences": [
            "Clean beauty enthusiasts",
            "Vegan skincare users",
            "Dry skin sufferers",
            "Eco-conscious consumers",
            "Natural ingredient advocates",
            "Fragrance lovers",
            "Dermatologist-tested product users"
        ],
        "brand_color": null,
        "qrcode_url": null,
        "primary_image_url": null
    },
    "credits_used": 0
}

💡 If no videos are included, provide at least 3 images.

---

3. (Optional) Update Link

Modify an existing link’s metadata (title, description, images, videos).

PUT /api/links/{id}/

Example Request

curl --request PUT \
  --url https://api.creatify.ai/api/links/21ce43ad-ae5e-4f3d-96fa-58a1e5b966f0/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
    "title": "ATTITUDE Body Cream, Moisturizer for Dry Skin, EWG Verified, Vegan & Dermatologist-Tested, Deep Hydration, Pear & Amber Scent, 8 Fl Oz (Pack of 6)",
    "description": "About this item    EWG VERIFIED: This body cream for women and men is certified EWG Verified and made with clean ingredients that meet the Environmental Working Group's strict health and safety standards so you can feel confident that it does not contain any potentially concerning ingredients.    CLEAN FORMULA: This ATTITUDE body cream is made with 98% natural-origin ingredients, and free from SLS, SLES, petrolatum, mineral oil, and artificial colors, for a worry-free experience.    HIGH PERFORMANCE: Infused with watercress and Indian cress extracts, this fast-absorbing, non-greasy and non-sticky EWG Verified hand cream leaves hands soft and smooth. Suitable for both women and men.",
    "image_urls": [
        "https://m.media-amazon.com/images/I/71xB-ss26gL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71H9i6r9TUL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71PHtZce95L._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/81rjeQ6iLOL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/61YO5awH0OL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/61uAyKZ1WFL.jpg",
        "https://m.media-amazon.com/images/I/71O3xDdrjTL.jpg"
    ],
    "video_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/videos/1984d47b-7110-86c3-f38d-b7b3daff27db.mp4",
        "https://d35ghwdno3nak3.cloudfront.net/videos/ebf4c8b5-b774-55f1-28d9-f24a4aa436db.mp4"
    ]
}'

{
    "id": "e6bea53f-1f03-42a8-aee8-637f69714afd",
    "url": "placeholder-21ce43ad-ae5e-4f3d-96fa-58a1e5b966f0",
    "title": "ATTITUDE Body Cream, Moisturizer for Dry Skin, EWG Verified, Vegan & Dermatologist-Tested, Deep Hydration, Pear & Amber Scent, 8 Fl Oz (Pack of 6)",
    "description": "About this item    EWG VERIFIED: This body cream for women and men is certified EWG Verified and made with clean ingredients that meet the Environmental Working Group's strict health and safety standards so you can feel confident that it does not contain any potentially concerning ingredients.    CLEAN FORMULA: This ATTITUDE body cream is made with 98% natural-origin ingredients, and free from SLS, SLES, petrolatum, mineral oil, and artificial colors, for a worry-free experience.    HIGH PERFORMANCE: Infused with watercress and Indian cress extracts, this fast-absorbing, non-greasy and non-sticky EWG Verified hand cream leaves hands soft and smooth. Suitable for both women and men.",
    "image_urls": [
        "https://m.media-amazon.com/images/I/71xB-ss26gL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71H9i6r9TUL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71PHtZce95L._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/81rjeQ6iLOL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/61YO5awH0OL._SL1500_.jpg",
        "https://m.media-amazon.com/images/I/61uAyKZ1WFL.jpg",
        "https://m.media-amazon.com/images/I/71O3xDdrjTL.jpg"
    ],
    "video_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/videos/1984d47b-7110-86c3-f38d-b7b3daff27db.mp4",
        "https://d35ghwdno3nak3.cloudfront.net/videos/ebf4c8b5-b774-55f1-28d9-f24a4aa436db.mp4"
    ],
    "reviews": null,
    "logo_url": null,
    "ai_summary": "ATTITUDE Body Cream is an EWG Verified moisturizer designed for dry skin, made with 98% natural-origin ingredients and free from SLS, SLES, petrolatum, mineral oil, and artificial colors, ensuring a clean and safe formula. Suitable for both women and men, this fast-absorbing, non-greasy, and non-sticky cream is infused with watercress and Indian cress extracts to provide deep hydration, leaving skin soft and smooth. It features a bright, delicate pear and amber scent with notes of nectarine and ginger for a refreshing experience. Dermatologist-tested, 100% vegan, and packaged in a recyclable HDPE plastic bottle, this product supports a responsible and sustainable beauty routine. The pack contains six 8 fl oz bottles.",
    "ai_industry": "Skincare",
    "ai_target_audiences": [
        "Clean beauty enthusiasts",
        "Vegan skincare users",
        "Dry skin sufferers",
        "Eco-conscious consumers",
        "Natural ingredient advocates",
        "Fragrance lovers",
        "Dermatologist-tested product users"
    ],
    "brand_color": null,
    "qrcode_url": null,
    "primary_image_url": null
}

---

4. Generate Recommended Scripts

Generate AI-powered marketing scripts for the product.

POST /api/ai_scripts/

Example Request

ccurl --request POST \
  --url https://api.creatify.ai/api/ai_scripts/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
    "title": "ATTITUDE Body Cream, Moisturizer for Dry Skin, EWG Verified, Vegan & Dermatologist-Tested, Deep Hydration, Pear & Amber Scent, 8 Fl Oz (Pack of 6)",
    "description": "About this item    EWG VERIFIED: This body cream for women and men is certified EWG Verified and made with clean ingredients that meet the Environmental Working Group's strict health and safety standards so you can feel confident that it does not contain any potentially concerning ingredients.    CLEAN FORMULA: This ATTITUDE body cream is made with 98% natural-origin ingredients, and free from SLS, SLES, petrolatum, mineral oil, and artificial colors, for a worry-free experience.    HIGH PERFORMANCE: Infused with watercress and Indian cress extracts, this fast-absorbing, non-greasy and non-sticky EWG Verified hand cream leaves hands soft and smooth. Suitable for both women and men.",
    "language": "en",
    "target_audience": "young adults",
    "video_length": 15
}'

{
    "id": "29284339-ad8c-4db2-bb76-0ff6d8511c40",
    "language": "en",
    "target_audience": "young adults",
    "video_length": 15,
    "min_chars": null,
    "max_chars": null,
    "script_styles": [],
    "generated_scripts": [
        {
            "paragraphs": "Healing begins with self-care. I found this truth with ATTITUDE's Body Cream. Its pure, hydrating caress rescued my skin, proving that small changes can bring profound happiness. Experience this joy today.",
            "script_name": "V2Writer",
            "script_style": "EmotionalWriter",
            "title": "Emotional"
        },
        {
            "paragraphs": "Ever felt your skin begging for hydration after a long day? I found the ultimate moisture-mate in ATTITUDE's Body Cream. It's vegan, dermatologist-tested, and free from harsh chemicals. Ready for supple skin? Get yours today!",
            "script_name": "V2Writer",
            "script_style": "DontWorryWriter",
            "title": "Don't Worry"
        },
        {
            "paragraphs": "Imagine uncovering a treasure that transforms the way your skin feels daily. That's ATTITUDE's Pear & Amber Body Cream. Certified by EWG and crafted from 98% natural origins, it’s an adventure in each application. Dive in, feel the richness, and let your skin's journey of deep hydration begin. Buy now and experience the same joy.",
            "script_name": "V2Writer",
            "script_style": "DiscoveryWriter",
            "title": "Discovery"
        },
        {
            "paragraphs": "Yo, peeps! 🌟 Just got my hands on the ATTITUDE Body Cream. It's vegan, clean, and super hydrating. Trust, your skin will thank you. Cop yours and get that pear & amber glow-up! 💫",
            "script_name": "V2Writer",
            "script_style": "GenzWriter",
            "title": "Gen Z"
        },
        {
            "paragraphs": "Own your skin’s happiness, feel the joy! Imagine soothing your skin with ATTITUDE’s Pear & Amber Body Cream. As a vegan and allergic-friendly option, it was life-changing for me. See for yourself how nurturing it feels!",
            "script_name": "V2Writer",
            "script_style": "MotivationalWriter",
            "title": "Motivational"
        }
    ],
    "failed_reason": null,
    "status": "done",
    "created_at": "2025-10-23T22:09:22.802150-07:00",
    "updated_at": "2025-10-23T22:09:25.040008-07:00",
    "user": 18165,
    "workspace": "a1240918-1f02-47f1-bebe-832a555507f3",
    "product": {
        "id": "ee906d0a-6cdc-488a-b870-d8edd81f2ee9",
        "url": null,
        "slug": "66f299e9-833f-4089-b8ab-9c871f2a81f2",
        "title": "ATTITUDE Body Cream, Moisturizer for Dry Skin, EWG Verified, Vegan & Dermatologist-Tested, Deep Hydration, Pear & Amber Scent, 8 Fl Oz (Pack of 6)",
        "description": "About this item    EWG VERIFIED: This body cream for women and men is certified EWG Verified and made with clean ingredients that meet the Environmental Working Group's strict health and safety standards so you can feel confident that it does not contain any potentially concerning ingredients.    CLEAN FORMULA: This ATTITUDE body cream is made with 98% natural-origin ingredients, and free from SLS, SLES, petrolatum, mineral oil, and artificial colors, for a worry-free experience.    HIGH PERFORMANCE: Infused with watercress and Indian cress extracts, this fast-absorbing, non-greasy and non-sticky EWG Verified hand cream leaves hands soft and smooth. Suitable for both women and men.",
        "image_urls": [],
        "video_urls": [],
        "image_selected": null,
        "video_selected": null,
        "reviews": null,
        "created_with": "link_to_video",
        "logo_url": null,
        "price": null,
        "original_price": null,
        "promo_price": null,
        "use_promotional_info": false,
        "highlight_features": null,
        "brand_info": null,
        "promotional_details": null,
        "trigger_insights": false,
        "ai_summary": null,
        "ai_target_audiences": [],
        "ai_key_features": [],
        "ai_keywords": [],
        "ai_industry": null,
        "ai_product_type": null,
        "updated_at": "2025-10-23T22:09:22.811978-07:00",
        "primary_image_url": null
    },
    "credits_used": 1
}

💡 The title and description are the same as those in the link.

---

5. Generate Preview Videos

Generate video previews for the link.

POST /api/link_to_videos/preview_list_async/

⚠️ Costs 1 credit per 30 seconds preview video. Even if multiple previews are generated, you’ll only be charged once. For example, 8 previews of 30 seconds each still cost just 1 credit.

Example Request

curl --request POST \
  --url https://api.creatify.ai/api/link_to_videos/preview_list_async/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
    "target_platform": "Instagram",
    "target_audience": "young adults",
    "language": "en",
    "video_length": 30,
    "aspect_ratio": "1x1"
    "visual_styles": [
        "VanillaTemplate",
        "GreenScreenEffectTemplate",
        "AvatarBubbleTemplate",
        "FullScreenTemplate",
        "DynamicProductTemplate",
        "QuickTransitionTemplate",
        "ScribbleTemplate",
        "SideBySideTemplate"
    ],
    "override_script": "Are you ready for an unforgettable adventure? Discover the best Iceland tour packages and immerse yourself in stunning landscapes, from majestic volcanoes to breathtaking glaciers. Did you know that 7 out of 10 travelers say Iceland is a top destination for adventure seekers? Explore the magic of Iceland and start your journey today!",
    "link": "e63ce1e4-97cb-4ba6-937a-50e88925a321",
    "model_version": "aurora_v1_fast",
    "webhook_url": "https://webhook.site/541a19ea-ebb0-4521-9cb3-558c11182938"
}'

{
    "id": "20b5d452-89f4-4245-9480-10defaa8fb4d",
    "name": null,
    "target_platform": "Instagram",
    "target_audience": "young adults",
    "language": "en",
    "video_length": 30.0,
    "aspect_ratio": "1x1",
    "script_style": "DIY",
    "override_avatar": null,
    "override_voice": null,
    "override_script": "Are you ready for an unforgettable adventure? Discover the best Iceland tour packages and immerse yourself in stunning landscapes, from majestic volcanoes to breathtaking glaciers. Did you know that 7 out of 10 travelers say Iceland is a top destination for adventure seekers? Explore the magic of Iceland and start your journey today!",
    "background_music_url": null,
    "background_music_volume": null,
    "voiceover_volume": null,
    "webhook_url": "https://webhook.site/541a19ea-ebb0-4521-9cb3-558c11182938",
    "link": "e63ce1e4-97cb-4ba6-937a-50e88925a321",
    "media_job": null,
    "status": "pending",
    "failed_reason": null,
    "is_hidden": false,
    "video_output": null,
    "video_thumbnail": null,
    "credits_used": 0,
    "progress": 0,
    "no_background_music": false,
    "no_caption": false,
    "no_emotion": false,
    "no_cta": false,
    "no_stock_broll": false,
    "preview": null,
    "previews": [],
    "caption_style": null,
    "caption_offset_x": null,
    "caption_offset_y": null,
    "caption_setting": null,
    "visual_styles": [
        "VanillaTemplate",
        "GreenScreenEffectTemplate",
        "AvatarBubbleTemplate",
        "FullScreenTemplate",
        "DynamicProductTemplate",
        "QuickTransitionTemplate",
        "ScribbleTemplate",
        "SideBySideTemplate"
    ]
}

💡 link param is the response id of create link

override_script is the response paragraphs of ai_scripts

---

6. Get Preview Videos Result

🔄 Webhook Callback Example

If you provide a webhook_url, Creatify will notify your backend of the preview generation result:

{
  "id": "20b5d452-89f4-4245-9480-10defaa8fb4d",
  "status": "pending",
  "failed_reason": null,
  "previews": [
    {
      "media_job": "43e2b17c-e272-453a-96d4-c047acd2ab0e",
      "visual_style": "FullScreenTemplate",
      "url": "https://app.creatify.ai/preview?layout=videos/20250521/bdc461ad-cc18-449c-b4b2-43cc12db0013.json",
      "aspect_ratio": "9x16"
    },
    {
      "media_job": "cd08733a-5067-4643-9237-346998c5849c",
      "visual_style": "EnhancedVanillaTemplate",
      "url": "https://app.creatify.ai/preview?layout=videos/20250521/5ce154f9-6954-4c58-bc17-e33bb077e2f5.json",
      "aspect_ratio": "9x16"
    },
    {
      "media_job": "02cdc0a9-17dc-44dc-9560-e8fd0b2f78a1",
      "visual_style": "FeatureHighlightTemplate",
      "url": "https://app.creatify.ai/preview?layout=videos/20250521/c3341e4a-531d-48f1-b426-87e45f0badd2.json",
      "aspect_ratio": "9x16"
    },
    {
      "media_job": "8323b4bc-d5c3-4976-9e04-f86c0cea7ee8",
      "visual_style": "SimpleAvatarOverlayTemplate",
      "url": "https://app.creatify.ai/preview?layout=videos/20250521/61b40cc5-2cfb-4afb-81fe-0698ad796eb4.json",
      "aspect_ratio": "9x16"
    },
    {
      "media_job": "50036921-ffbe-4b3f-ad1d-ef367847db7d",
      "visual_style": "QuickTransitionTemplate",
      "url": "https://app.creatify.ai/preview?layout=videos/20250521/ae100137-e12f-4f0f-86d9-4b54e041ac4d.json",
      "aspect_ratio": "9x16"
    },
    {
      "media_job": "188f92ac-6281-41e5-ac4b-94d0af4b2493",
      "visual_style": "GreenScreenEffectTemplate",
      "url": "https://app.creatify.ai/preview?layout=videos/20250521/13cda7fd-e54f-44d3-acc3-5cc6c34beba7.json",
      "aspect_ratio": "9x16"
    },
    {
      "media_job": "198080fa-6369-4724-829f-2e57bb8538b8",
      "visual_style": "DynamicProductTemplate",
      "url": "https://app.creatify.ai/preview?layout=videos/20250521/41601095-6549-4898-89ab-b62879dbf88d.json",
      "aspect_ratio": "9x16"
    },
    {
      "media_job": "0c6a5fda-e58a-442c-9681-a431b6195203",
      "visual_style": "DynamicGreenScreenEffect",
      "url": "https://app.creatify.ai/preview?layout=videos/20250521/1f39ca8e-bdf8-4423-81c1-1629fcaeabbd.json",
      "aspect_ratio": "9x16"
    },
    {
      "media_job": "d2110d2d-b2b5-4f0a-99dd-7d0ee07b8b13",
      "visual_style": "AvatarBubbleTemplate",
      "url": "https://app.creatify.ai/preview?layout=videos/20250521/a67532d0-0764-40c3-b1f4-36d645b935f5.json",
      "aspect_ratio": "9x16"
    }
  ]
}

🔄 Poll API to get Result without Webhook

If you did not provide a webhook_url, you will have to pool Creatify API to the preview generation result:

GET /api/link_to_videos/{id}/

Example Request

curl --request GET \
  --url https://api.creatify.ai/api/link_to_videos/20b5d452-89f4-4245-9480-10defaa8fb4d/ \
  --header 'X-API-ID: <your-api-id>' \
  --header 'X-API-KEY: <your-api-key>'

{
    "id": "20b5d452-89f4-4245-9480-10defaa8fb4d",
    "name": null,
    "target_platform": "Instagram",
    "target_audience": "Young Adults",
    "language": "en",
    "video_length": 30.0,
    "aspect_ratio": "9x16",
    "script_style": "DIY",
    "visual_style": "GreenScreenEffectTemplate",
    "override_avatar": null,
    "override_voice": null,
    "override_script": null,
    "background_music_url": null,
    "background_music_volume": null,
    "voiceover_volume": null,
    "webhook_url": "https://webhook.site/d94ac4fd-2384-4c21-b35d-2feb4f698cbc",
    "link": "1d28aebc-3c23-43f7-8ce1-f5e522387ab4",
    "media_job": null,
    "status": "pending",
    "failed_reason": null,
    "is_hidden": false,
    "video_output": null,
    "video_thumbnail": null,
    "credits_used": 1,
    "progress": 0,
    "no_background_music": false,
    "no_caption": false,
    "no_emotion": false,
    "no_cta": false,
    "no_stock_broll": false,
    "preview": null,
    "previews": [
        {
            "media_job": "43e2b17c-e272-453a-96d4-c047acd2ab0e",
            "visual_style": "FullScreenTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/bdc461ad-cc18-449c-b4b2-43cc12db0013.json"
        },
        {
            "media_job": "cd08733a-5067-4643-9237-346998c5849c",
            "visual_style": "EnhancedVanillaTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/5ce154f9-6954-4c58-bc17-e33bb077e2f5.json"
        },
        {
            "media_job": "02cdc0a9-17dc-44dc-9560-e8fd0b2f78a1",
            "visual_style": "FeatureHighlightTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/c3341e4a-531d-48f1-b426-87e45f0badd2.json"
        },
        {
            "media_job": "8323b4bc-d5c3-4976-9e04-f86c0cea7ee8",
            "visual_style": "SimpleAvatarOverlayTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/61b40cc5-2cfb-4afb-81fe-0698ad796eb4.json"
        },
        {
            "media_job": "50036921-ffbe-4b3f-ad1d-ef367847db7d",
            "visual_style": "QuickTransitionTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/ae100137-e12f-4f0f-86d9-4b54e041ac4d.json"
        },
        {
            "media_job": "188f92ac-6281-41e5-ac4b-94d0af4b2493",
            "visual_style": "GreenScreenEffectTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/13cda7fd-e54f-44d3-acc3-5cc6c34beba7.json"
        },
        {
            "media_job": "198080fa-6369-4724-829f-2e57bb8538b8",
            "visual_style": "DynamicProductTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/41601095-6549-4898-89ab-b62879dbf88d.json"
        },
        {
            "media_job": "0c6a5fda-e58a-442c-9681-a431b6195203",
            "visual_style": "DynamicGreenScreenEffect",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/1f39ca8e-bdf8-4423-81c1-1629fcaeabbd.json"
        },
        {
            "media_job": "d2110d2d-b2b5-4f0a-99dd-7d0ee07b8b13",
            "visual_style": "AvatarBubbleTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/a67532d0-0764-40c3-b1f4-36d645b935f5.json"
        }
    ],
    "caption_style": null,
    "caption_offset_x": null,
    "caption_offset_y": null,
    "caption_setting": null,
    "visual_styles": [
        "GreenScreenEffectTemplate",
        "SimpleAvatarOverlayTemplate",
        "DynamicProductTemplate",
        "FullScreenTemplate",
        "QuickTransitionTemplate",
        "EnhancedVanillaTemplate",
        "DynamicGreenScreenEffect",
        "FeatureHighlightTemplate",
        "AvatarBubbleTemplate"
    ],
    "aspect_ratios": []
}

ℹ️ You can embed the preview URLs using <iframe> tags in your UI to display them.

---

7. Render Selected Preview

Render a chosen preview video into a final output.

POST /api/link_to_videos/{id}/render_single_preview/

Example Request

curl --request POST \
  --url https://api.creatify.ai/api/link_to_videos/20b5d452-89f4-4245-9480-10defaa8fb4d/render_single_preview/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <your-api-id>' \
  --header 'X-API-KEY: <your-api-key>' \
  --data '{
    "media_job": "0c6a5fda-e58a-442c-9681-a431b6195203"
  }'

{
    "id": "20b5d452-89f4-4245-9480-10defaa8fb4d",
    "name": null,
    "target_platform": "Instagram",
    "target_audience": "Young Adults",
    "language": "en",
    "video_length": 30.0,
    "aspect_ratio": "9x16",
    "script_style": "DIY",
    "override_avatar": null,
    "override_voice": null,
    "override_script": null,
    "background_music_url": null,
    "background_music_volume": null,
    "voiceover_volume": null,
    "webhook_url": "https://webhook.site/d94ac4fd-2384-4c21-b35d-2feb4f698cbc",
    "link": "1d28aebc-3c23-43f7-8ce1-f5e522387ab4",
    "media_job": "0c6a5fda-e58a-442c-9681-a431b6195203",
    "status": "pending",
    "failed_reason": null,
    "is_hidden": true,
    "video_output": null,
    "video_thumbnail": null,
    "credits_used": 1,
    "progress": 0,
    "no_background_music": false,
    "no_caption": false,
    "no_emotion": false,
    "no_cta": false,
    "no_stock_broll": false,
    "preview": "https://app.creatify.ai/preview?layout=videos/20250521/1f39ca8e-bdf8-4423-81c1-1629fcaeabbd.json",
    "previews": [
        {
            "media_job": "43e2b17c-e272-453a-96d4-c047acd2ab0e",
            "visual_style": "FullScreenTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/bdc461ad-cc18-449c-b4b2-43cc12db0013.json"
        },
        {
            "media_job": "cd08733a-5067-4643-9237-346998c5849c",
            "visual_style": "EnhancedVanillaTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/5ce154f9-6954-4c58-bc17-e33bb077e2f5.json"
        },
        {
            "media_job": "02cdc0a9-17dc-44dc-9560-e8fd0b2f78a1",
            "visual_style": "FeatureHighlightTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/c3341e4a-531d-48f1-b426-87e45f0badd2.json"
        },
        {
            "media_job": "8323b4bc-d5c3-4976-9e04-f86c0cea7ee8",
            "visual_style": "SimpleAvatarOverlayTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/61b40cc5-2cfb-4afb-81fe-0698ad796eb4.json"
        },
        {
            "media_job": "50036921-ffbe-4b3f-ad1d-ef367847db7d",
            "visual_style": "QuickTransitionTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/ae100137-e12f-4f0f-86d9-4b54e041ac4d.json"
        },
        {
            "media_job": "188f92ac-6281-41e5-ac4b-94d0af4b2493",
            "visual_style": "GreenScreenEffectTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/13cda7fd-e54f-44d3-acc3-5cc6c34beba7.json"
        },
        {
            "media_job": "198080fa-6369-4724-829f-2e57bb8538b8",
            "visual_style": "DynamicProductTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/41601095-6549-4898-89ab-b62879dbf88d.json"
        },
        {
            "media_job": "0c6a5fda-e58a-442c-9681-a431b6195203",
            "visual_style": "DynamicGreenScreenEffect",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/1f39ca8e-bdf8-4423-81c1-1629fcaeabbd.json"
        },
        {
            "media_job": "d2110d2d-b2b5-4f0a-99dd-7d0ee07b8b13",
            "visual_style": "AvatarBubbleTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/a67532d0-0764-40c3-b1f4-36d645b935f5.json"
        }
    ],
    "caption_style": null,
    "caption_offset_x": null,
    "caption_offset_y": null,
    "caption_setting": null,
    "visual_styles": [
        "GreenScreenEffectTemplate",
        "SimpleAvatarOverlayTemplate",
        "DynamicProductTemplate",
        "FullScreenTemplate",
        "QuickTransitionTemplate",
        "EnhancedVanillaTemplate",
        "DynamicGreenScreenEffect",
        "FeatureHighlightTemplate",
        "AvatarBubbleTemplate"
    ],
    "aspect_ratios": []
}

---

8. Get Render result

🔄 Webhook Callback Example

If you provide a webhook_url, Creatify will notify your backend of the render result:

{
  "id": "20b5d452-89f4-4245-9480-10defaa8fb4d",
  "status": "done",
  "failed_reason": null,
  "video_output": "https://s3.us-west-2.amazonaws.com/remotionlambda-uswest2-30tewi8y5c/renders/phnafddwja/output.mp4",
  "video_thumbnail": "https://dpbavq092lwjh.cloudfront.net/amzptv/0c6a5fda-e58a-442c-9681-a431b6195203-1747847145/thumbnail.jpg"
}

🔄 Poll API to get Result without Webhook

If you did not provide a webhook_url, you will have to pool Creatify API to the render result:

GET /api/link_to_videos/{id}/

Example Request

curl --request GET \
  --url https://api.creatify.ai/api/link_to_videos/20b5d452-89f4-4245-9480-10defaa8fb4d/ \
  --header 'X-API-ID: <your-api-id>' \
  --header 'X-API-KEY: <your-api-key>'

{
    "id": "20b5d452-89f4-4245-9480-10defaa8fb4d",
    "name": null,
    "target_platform": "Instagram",
    "target_audience": "Young Adults",
    "language": "en",
    "video_length": 30.0,
    "aspect_ratio": "9x16",
    "script_style": "DIY",
    "visual_style": "GreenScreenEffectTemplate",
    "override_avatar": null,
    "override_voice": null,
    "override_script": null,
    "background_music_url": null,
    "background_music_volume": null,
    "voiceover_volume": null,
    "webhook_url": "https://webhook.site/d94ac4fd-2384-4c21-b35d-2feb4f698cbc",
    "link": "1d28aebc-3c23-43f7-8ce1-f5e522387ab4",
    "media_job": "0c6a5fda-e58a-442c-9681-a431b6195203",
    "status": "done",
    "failed_reason": null,
    "is_hidden": true,
    "video_output": "https://s3.us-west-2.amazonaws.com/remotionlambda-uswest2-30tewi8y5c/renders/phnafddwja/output.mp4",
    "video_thumbnail": "https://dpbavq092lwjh.cloudfront.net/amzptv/0c6a5fda-e58a-442c-9681-a431b6195203-1747847145/thumbnail.jpg",
    "credits_used": 5,
    "progress": 1,
    "no_background_music": false,
    "no_caption": false,
    "no_emotion": false,
    "no_cta": false,
    "no_stock_broll": false,
    "preview": "https://app.creatify.ai/preview?layout=videos/20250521/97c2fa32-ec44-4c52-8c28-32a7b59e7614.json",
    "previews": [
        {
            "media_job": "43e2b17c-e272-453a-96d4-c047acd2ab0e",
            "visual_style": "FullScreenTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/bdc461ad-cc18-449c-b4b2-43cc12db0013.json"
        },
        {
            "media_job": "cd08733a-5067-4643-9237-346998c5849c",
            "visual_style": "EnhancedVanillaTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/5ce154f9-6954-4c58-bc17-e33bb077e2f5.json"
        },
        {
            "media_job": "02cdc0a9-17dc-44dc-9560-e8fd0b2f78a1",
            "visual_style": "FeatureHighlightTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/c3341e4a-531d-48f1-b426-87e45f0badd2.json"
        },
        {
            "media_job": "8323b4bc-d5c3-4976-9e04-f86c0cea7ee8",
            "visual_style": "SimpleAvatarOverlayTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/61b40cc5-2cfb-4afb-81fe-0698ad796eb4.json"
        },
        {
            "media_job": "50036921-ffbe-4b3f-ad1d-ef367847db7d",
            "visual_style": "QuickTransitionTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/ae100137-e12f-4f0f-86d9-4b54e041ac4d.json"
        },
        {
            "media_job": "188f92ac-6281-41e5-ac4b-94d0af4b2493",
            "visual_style": "GreenScreenEffectTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/13cda7fd-e54f-44d3-acc3-5cc6c34beba7.json"
        },
        {
            "media_job": "198080fa-6369-4724-829f-2e57bb8538b8",
            "visual_style": "DynamicProductTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/41601095-6549-4898-89ab-b62879dbf88d.json"
        },
        {
            "media_job": "0c6a5fda-e58a-442c-9681-a431b6195203",
            "visual_style": "DynamicGreenScreenEffect",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/97c2fa32-ec44-4c52-8c28-32a7b59e7614.json"
        },
        {
            "media_job": "d2110d2d-b2b5-4f0a-99dd-7d0ee07b8b13",
            "visual_style": "AvatarBubbleTemplate",
            "aspect_ratio": "9x16",
            "url": "https://app.creatify.ai/preview?layout=videos/20250521/a67532d0-0764-40c3-b1f4-36d645b935f5.json"
        }
    ],
    "caption_style": null,
    "caption_offset_x": null,
    "caption_offset_y": null,
    "caption_setting": null,
    "visual_styles": [
        "GreenScreenEffectTemplate",
        "SimpleAvatarOverlayTemplate",
        "DynamicProductTemplate",
        "FullScreenTemplate",
        "QuickTransitionTemplate",
        "EnhancedVanillaTemplate",
        "DynamicGreenScreenEffect",
        "FeatureHighlightTemplate",
        "AvatarBubbleTemplate"
    ],
    "aspect_ratios": []
}

---

Status values in url to video response:

status	description
pending and previews is empty	Created
pending and previews is not empty	Previews generated
failed	Failed (check failed_reason)
done	Successfully completed
rejected	Rejected (content is moderated by our system)

---

✅ Summary of Endpoints

Step	Endpoint	Description
1	/api/links/	Create link from URL
2	/api/links/link_with_params/	(Optional) Create link from parameters
3	/api/links/{id}/	(Optional) Update link
4	/api/ai_scripts/	Generate scripts
5	/api/link_to_videos/preview_list_async/	Generate preview videos
6	/api/link_to_videos/{id}/ (GET)	Get preview videos
7	/api/link_to_videos/{id}/render_single_preview/	Render selected preview
8	/api/link_to_videos/{id}/ (GET)	Check job status