guides
Generate from a product URL
Turn a product page into an on-brand directed ad, with the extracted facts editable before anything renders.
Last updated 2026-07-10 · beta
What this does
ad_from_url reads the product page you submit, drafts Brand Memory facts from it (name, palette, call to action, hero image), locks the hero image as a continuity reference, and directs an ad around the real product.
Prerequisites
- A key with
brandandgeneratescopes - A product page URL you have the right to use
Request
curl -X POST https://cadenza.media/api/v1/ad_from_url \
-H "Authorization: Bearer cadk_..." -H "Content-Type: application/json" \
-d '{"product_url": "https://yourshop.example/products/kettle", "raw_intent": "premium 15s launch ad"}'The draft is yours to correct
Extraction is a draft, never silently trusted. In the studio the draft opens for editing before saving; over the API you can update the created brand profile with set_brand_profile. If the page cannot be read, the response says so and falls back to manual brand entry rather than inventing facts.
Security considerations
Only the URL you explicitly submit is read, through a scraping service seam, not arbitrary server-side fetching. Respect the page's terms and robots directives; do not submit pages you have no rights to.
Billing implications
URL ingestion itself is free. The generation that follows bills as a normal sequence.