Step 2 — Generate Content Ideas
With the agent set up in Step 1, you can now ask it to propose videos grounded in real trending data. The Ideas Engine pulls trending content from 10+ platforms (TikTok, Instagram, YouTube, Reddit, X, Hacker News, Perplexity, Gemini, and more), matches it to the agent’s configured keywords and monitored sources, and returns video ideas complete with hooks, full scripts, selected assets, and a project manifest.
Base URL: https://agent.gen.pro/v1 (same X-API-Key PAT)
The flow
Section titled “The flow”You: "generate 5 content ideas about before/after transformations" ↓POST /v1/agent/run — triggers async run ↓GET /v1/agent/runs/:run_id — poll every 5s until completed ↓GET /v1/agent/conversations/:id/messages ↓Each message contains ideas: title, hook, full_script, video_type, selected_assets, project_manifest, rationaleTrigger ideas
Section titled “Trigger ideas”curl -X POST "https://agent.gen.pro/v1/agent/run" \ -H "X-API-Key: $GEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "'"$AGENT_ID"'", "message": "Generate 5 content ideas grounded in this week trends" }'Response (202):
{ "run_id": "run_abc123", "conversation_id": "conv_def456", "status": "running", "firebase_path": "/agent_runs/11/run_abc123/"}Poll the run
Section titled “Poll the run”curl "https://agent.gen.pro/v1/agent/runs/run_abc123" \ -H "X-API-Key: $GEN_API_KEY"Poll every 5 seconds until status is "completed". For real-time streaming, subscribe to the firebase_path directly — no auth needed.
Three layers of control
Section titled “Three layers of control”| Layer | Scope | Example |
|---|---|---|
| Per-batch requirements | this run only | ”focus on before/after”, “under 12 seconds” |
| Long-term preferences | ALL future runs | ”always use statement hooks”, “target women 25-34” |
| Feedback / refinement | specific ideas in one conversation | ”make idea 3 punchier”, “redo idea 1 as montage” |
What each idea contains
Section titled “What each idea contains”{ "id": 901, "title": "The $2 taco at 2am", "hook": "I drove 40 minutes for this.", "full_script": "...", "video_type": "talking_avatar", "video_type_id": 1, "estimated_duration": 14, "selected_assets": [ { "url": "...", "type": "video", "description": "b-roll from @keithlee", "usage": "clip 4-8s", "clip_range": {"start": 4, "end": 8} } ], "project_manifest": { "video_title": "...", "total_duration": 14, "aspect_ratio": "9:16", "timeline_layers": [...] }, "inspiration_sources": [ { "type": "tiktok", "url": "...", "creator": "keithlee", "watch_count": 2100000, "what_was_used": "the reveal shot at 0:04" } ], "rationale": "..."}The project_manifest is a full production spec — timeline layers, asset usage, timing. It slots directly into Step 3 when you convert the idea into a vidsheet.