Import a product from its page URL
import_product_from_urlImport a product from its storefront URL to begin creating short-form videos. Returns a product ID instantly, runs scraping and video drafting in the background, and avoids duplicate imports.
Instructions
Start a new InstantClips product from a product page URL (a storefront listing, e.g. a Shopify product page).
Returns immediately with a product_id — the scrape, the image download
and the first video-direction draft all run in the background. Poll
get_product until import_status is "imported" and
video_direction.drafting is false, which usually takes under a minute.
Pasting a URL that was already imported on this account returns that existing product instead of creating a duplicate.
If the storefront name does not exactly match a brand this account has
already reviewed, the import stops on a brand decision instead of
guessing: get_product will report brand_decision_required, and no
video direction is drafted until it is resolved with create_brand or
set_product_brand. Do not assume the account's existing brand — a
product from a different company drafted under the wrong brand's voice
is the failure this prevents. Pass brand_id only when the user has
told you which brand this product belongs to.
This does not spend credits. Only generate_video does.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The product page URL, e.g. https://store.example.com/products/wool-runner | |
| brand_id | No | Optional, and only when the user has said which brand this is. Omit it to let the import match the storefront against the account's brands and ask when it cannot. Use `list_brands` to see what exists. |