Weekly Promo API

Generate a short-form weekly promo video script, scene plan, and rendered artifact from a public URL.

POSThttps://app.cliploop.site/api/public/weekly-promo

Request body

{
  "appName": "ClipLoop",
  "appWebsiteUrl": "https://cliploop.site",
  "weeklyUpdate": "ClipLoop now has a public API for weekly promo generation.",
  "targetAudience": "indie app builders and SaaS founders",
  "callToAction": "Try ClipLoop",
  "channel": "x",
  "tone": "clear, sharp, builder focused"
}

Field	Type	Required	Description
`appName`	string	✅	Your app or product name
`appWebsiteUrl`	url	—	Website for brand extraction
`weeklyUpdate`	string	✅	What's new this week (8–500 chars)
`targetAudience`	string	—	Primary audience description
`callToAction`	string	—	Desired CTA text
`channel`	enum	✅	`instagram`, `tiktok`, `whatsapp`, or `x`
`tone`	string	—	Promo tone (e.g. `professional`, `energetic`)

Response body

{
  "artifactId": "clp_abc123",
  "previewUrl": "https://cdn.cliploop.site/...",
  "downloadUrl": "https://cdn.cliploop.site/.../download",
  "artifactUrl": "https://cdn.cliploop.site/.../video.mp4",
  "script": { "hook": "...", "body": ["..."], "caption": "...", "cta": "..." },
  "scenePlan": ["Scene 1: ..."],
  "creditsCharged": 5,
  "idempotencyKey": "my-campaign-launch-v2",
  "renderStatus": "rendered"
}

Field	Description
`artifactId`	Unique artifact identifier
`previewUrl`	Preview image URL
`downloadUrl`	Direct download link
`artifactUrl`	CDN URL for the rendered video
`script`	Full script object
`scenePlan`	Ordered scene descriptions
`creditsCharged`	Credits deducted from your balance
`renderStatus`	One of: `rendered`, `renderer_unavailable`, `pending`

Renderer fallback: If the video engine is unavailable, the API returns the script and scene plan with renderStatus: "renderer_unavailable". You can retry later or use the script output directly.