Skip to main content

​
🚀 Introduction

The Ad Clone API helps you recreate winning ads by combining your product assets (via a Link) with a reference ad video.
By analyzing the structure, pacing, and style of the reference ad, Creatify generates a new ad tailored to your product.
Extract content (title, description, images, videos, etc.) from a product URL. POST /api/links/ 
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."
        ],
        "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: “]
If you don’t have a URL but have product data, create a link directly using parameters. POST /api/links/link_with_params/ 
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 1 image..
Modify an existing link’s metadata (title, description, images, videos). PUT /api/links/{id}/ 
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. Create Ad Clone Task

Create an Ad Clone task using the above Link ID and a reference ad video URL. POST /api/ads_clone/ 
curl --request POST \
  --url https://api.creatify.ai/api/ads_clone/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
    "link": "e63ce1e4-97cb-4ba6-937a-50e88925a321,
    "video_url": "https://d35ghwdno3nak3.cloudfront.net/media_file/18165/2caea2fb194664e5d736c0d8f73bf802.mp4",
    "aspect_ratio": "9x16",
    "language": null
  }'

{
    "id": "a1cbde83-1be7-4ecd-9ee3-4c72f17af8e9",
    "created_at": "2025-12-24T02:56:42.926254-08:00",
    "updated_at": "2025-12-24T02:56:42.926303-08:00",
    "link": "e63ce1e4-97cb-4ba6-937a-50e88925a321",
    "video_url": null,
    "aspect_ratio": "9x16",
    "language": null,
    "webhook_url": null,
    "video_output": null,
    "credits_used": 0,
    "media_job": "a48e8d3a-1045-4830-90dd-c65792747bad",
    "status": "running"
}
🎬 Save the returned id and use it to check the task status.

​
5. Check Ad Clone Status

Poll the status endpoint until status becomes done. GET /api/ads_clone/{id}/ 
curl --request GET \
  --url https://api.creatify.ai/api/ads_clone/a1cbde83-1be7-4ecd-9ee3-4c72f17af8e9/ \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>'

{
        "id": "a1cbde83-1be7-4ecd-9ee3-4c72f17af8e9",
        "created_at": "2025-12-23T23:13:31.791310-08:00",
        "updated_at": "2025-12-24T01:39:15.442115-08:00",
        "link": "e63ce1e4-97cb-4ba6-937a-50e88925a321",
        "video_url": "https://d35ghwdno3nak3.cloudfront.net/media_file/18165/2caea2fb194664e5d736c0d8f73bf802.mp4",
        "aspect_ratio": "9x16",
        "language": null,
        "webhook_url": null,
        "video_output": "https://s3.us-west-2.amazonaws.com/remotionlambda-uswest2-30tewi8y5c/renders/qlkkz11bn8/output.mp4",
        "credits_used": 15,
        "media_job": "3fedc33e-fcd7-4655-9585-6896167c0508",
        "status": "done"
    }
✅ When status is done, retrieve your video from the video_output field.

​
6. Webhook Option

Instead of polling, you can provide a webhook_url in the request to receive the result automatically when the video is ready.
When processing completes, Aurora will send a POST request to your webhook with a payload like this: 
{
  "id": "a1cbde83-1be7-4ecd-9ee3-4c72f17af8e9",
  "status": "done",
  "failed_reason": "",
  "video_output": "https://s3.us-west-2.amazonaws.com/remotionlambda-uswest2-30tewi8y5c/renders/qlkkz11bn8/output.mp4"
}

​
🎯 Summary

StepEndpoint
Create LinkPOST /api/links/
Create TaskPOST /api/ads_clone/
Check StatusGET /api/ads_clone/{id}/
API ReferenceAd Clone Reference

​
💳 Pricing

Creating an Ad Clone video through this endpoint costs 12 credits per 5 seconds of the reference video length.
For example, a 30-second reference video costs 72 credits.

​
🤝 Need Help?

If you run into any issues, check out our API Reference or contact api@creatify.ai.