Waverunner
Browse the docs

Catalog Video

Turn a product catalog into per-SKU videos from one approved look. Connect a shop, pick a look, approve it, quote, launch, then download feeds or a Google activation kit.

What it is

Unlike persona ads (one creative set per ideal customer), Catalog Video produces a video for each product in a catalog from a shared approved template. You stay in Waverunner for the whole loop: connect a shop, pick a look, approve it, quote, launch, then download feeds or a Google activation kit.

Catalog Video is available in early access. Open your business, then Catalog, or contact support if you do not see it yet.

How it works

  1. Open your business → Catalog and paste your shop URL, connect a feed, or upload a product CSV (sku, title, price, link, image_url columns).
  2. Pick products (or use the whole catalog once synced).
  3. Pitch a look, review the preview, then Approve the template.
  4. Quote a sample (~5 SKUs) or the full run, then launch. The first charge covers one production tranche.
  5. Review ready videos, grab supplemental feeds, or download the Google video-link handoff CSV.

Pricing and fair use

Catalog Video is metered like other creation: concept pitch $0.13, template master $12, per-SKU variants from $0.15 (S) up to $12 (L). Creation credit applies first, then your wallet. Failed variants refund their units.

  • Up to 500 SKUs per run.
  • Up to 2000 Catalog Video units per organization per day.

Running ads (optional)

You can use Catalog Video for exports and feeds without launching a Waverunner campaign, including a Google video-link activation kit (download and apply in Google Ads yourself). With early access, you can also link a completed run to a campaign so per-product video can serve on supported channels alongside your persona ads.

Meta catalog ads never run as broad prospecting. They only deliver to people already in this campaign's reach audiences or your customer list, under the same Preparing → Starting → Live model as other channels.

Product ads from a shop URL

Pass a merchant-owned shop URL (Shopify, WooCommerce, or any scrapeable storefront) and Waverunner handles the rest: scrape the catalog, select top products, generate per-product personas, pitch a look for your approval, then prepare a draft you can quote and launch. One call starts the whole pipeline.

  1. POST /api/v1/catalog-video/from-url with businessId, url, and optional topN (default 5). Or use the Catalog→ “Create from shop URL” on the business.
  2. The pipeline moves through syncing, product selection, persona generation, and pitching until it reaches awaiting_approval. Check status via GET /api/v1/catalog-video/runs/:id or the Catalog UI.
  3. Approve the pitched template once the preview is ready. Approving before the pitch finishes returns a clear error. Approving triggers a sample quote and advances the run to quoted.
  4. Review the sample quote, then launch the full run from Catalog or via launch_catalog_video_run on the MCP server.
If a Catalog Video run is already active for the business, the endpoint returns 409 active_run. A previously scraped catalog for the same URL is reused automatically (no duplicate scrape). These endpoints require Catalog Video early access.

API and MCP

The same flow is available on the REST API under /api/v1/catalogs and /api/v1/catalog-video/*, and as snake_case tools on the MCP server (for example create_catalog, quote_catalog_video_run, launch_catalog_video_run). Launching accepts the quote's mode and quoteHash so a launch call can never silently drift from the quote you were shown.

Typical agent path: create_catalog → poll items ready → pitch_catalog_video_template → approve_catalog_video_template → create_catalog_video_run → quote_catalog_video_run (sample) → launch_catalog_video_run with mode + quoteHash → poll get_catalog_video_run → export_catalog_video_run. Optional segmentKeys (max 3) on create enables persona×SKU variants.

Next

Persona creatives first? See Creating ads. Ready to spend media? Launch a campaign.