REST API to turn any topic into a viral short-form video — script, voice, visuals, captions, render, publish — programmatically.
⚡ Built with Anthropic ClaudeBase URL: https://cp.idea2viral.com/api/v1
All endpoints accept Content-Type: application/json and return JSON. Free demo endpoints under /v1/public/* work without auth (rate-limited per IP, watermarked output). Paid endpoints require a Bearer token from /api-keys.
Authorization: Bearer iv_live_YOUR_API_KEY
Tokens are generated in your dashboard after signup (Pro+ tier required).
No auth · 3 calls/day per IP · watermarked or truncated output · upgrade for full results.
/v1/public/title-suggest FREEGenerate 3 viral YouTube title variants from a topic. Paid plan returns 10 + scoring + chat refinement.
curl -X POST https://cp.idea2viral.com/api/v1/public/title-suggest \
-H "Content-Type: application/json" \
-d '{"topic": "5 feng shui mistakes that drain your wealth"}'
{
"ok": true,
"titles": [
"5 Feng Shui Mistakes Silently Costing You Money",
"These Tiny Feng Shui Errors Are Draining Your Wealth",
"Why Your Feng Shui Isn't Working (And How to Fix It)"
],
"watermark": "Powered by idea2viral.com — upgrade for 10 titles + scoring",
"calls_remaining_today": 2
}
/v1/public/script-preview FREEFirst 30% of an AI-generated short script. Paid plan returns full script + voice + render.
curl -X POST https://cp.idea2viral.com/api/v1/public/script-preview \
-H "Content-Type: application/json" \
-d '{"topic": "How to start a side hustle", "language": "en", "tone": "viral"}'
/v1/public/clip-suggest FREESubmit a YouTube URL → get 1 viral-moment timestamp suggestion. Paid plan returns 3-15 moments + auto-render.
curl -X POST https://cp.idea2viral.com/api/v1/public/clip-suggest \
-H "Content-Type: application/json" \
-d '{"youtube_url": "https://www.youtube.com/watch?v=..."}'
| Endpoint | What it does | Tier |
|---|---|---|
POST /v1/auto-short | Topic → finished narrated 9:16 short | Starter+ |
POST /v1/youtube-studio/titles | 10 title variants + score + chat refine | Starter+ |
POST /v1/youtube-studio/description | SEO description + chapter timestamps | Starter+ |
POST /v1/youtube-studio/thumbnail | 16:9 thumbnail via Flux | Starter+ |
POST /v1/clip-generator/analyze | Long video → 3-15 viral moment timestamps | Creator+ |
POST /v1/clip-generator/render | Render specific moment as 9:16 + subs | Creator+ |
POST /v1/ai-short | URL → UGC actor talking-head short | Creator+ |
POST /v1/voice-clone | Clone voice from 30s sample | Creator+ |
POST /v1/publish/youtube | Auto-upload to YouTube | Pro+ |
POST /v1/publish/tiktok | Auto-publish to TikTok | Pro+ |
GET /v1/jobs/{id} | Poll render job status | Starter+ |
POST /v1/auto-short — full schema, error codes, webhook events available to Starter+
POST /v1/clip-generator/analyze
{
"input_url": "https://www.youtube.com/watch?v=...",
"max_clips": 8
}
— Returns —
{
"ok": true,
"duration": 720.5,
"clips": [
{"start": 12.5, "end": 48.0, "score": 87, "hook": "...", "excerpt": "..."},
...
]
}POST /v1/publish/youtube
{
"project_id": 42,
"kind": "short",
"privacy": "unlisted",
"override_title": "Optional override"
}
— Returns —
{
"ok": true,
"video_id": "Nrij0NJox1U",
"youtube_url": "https://www.youtube.com/watch?v=Nrij0NJox1U"
}| Plan | Calls / month | Concurrency | Watermark |
|---|---|---|---|
| Free trial (no auth) | 3 / day per IP | 1 | yes |
| Starter — $19 | 50 | 2 | no |
| Creator — $49 | 200 | 4 | no |
| Pro — $99 | 600 | 8 | no |
| Empire — $249 | 2000 | 20 | no |
429 responses include X-RateLimit-Reset with seconds until reset.
{
"ok": false,
"error": "rate_limit_exceeded",
"detail": "3 calls/day from this IP. Reset at 00:00 UTC.",
"kind": "rate_limit",
"upgrade_url": "https://cart.melyx.id/pay/idea2viral-starter"
}
Common error kinds: auth, credits, rate_limit, tier_locked, bad_input, llm_failed, render_failed, internal.