API
API endpoint registry
All 102 API route modules, including product, OAuth, MCP, webhook, cron, and retired surfaces.
LiveAll plans
MCP
| Method | Path | Access | Purpose |
|---|---|---|---|
| GET · POST · DELETE | /api/mcp | OAuth bearer token; Pro | Remote Streamable HTTP MCP transport. |
Account
| Method | Path | Access | Purpose |
|---|---|---|---|
| DELETE | /api/account | Signed-in user | Delete the account, owned data, and stored files. |
Analysis
| Method | Path | Access | Purpose |
|---|---|---|---|
| GET · POST | /api/analyze/[id]/chat | Analysis owner | Read or continue analysis-aware coaching chat. |
| POST | /api/analyze/[id]/chat/welcome | Analysis owner | Generate the contextual chat welcome message. |
| POST | /api/analyze/[id]/comment-diagnosis | Analysis owner; Pro | Correlate audience comments with predicted retention drops. |
| GET | /api/analyze/[id]/frame-patterns | Analysis owner | Return frame-level semantic patterns. |
| GET | /api/analyze/[id]/progress | Analysis owner | Return creator-memory and progress comparisons. |
| GET | /api/analyze/[id] | Analysis owner | Return the plan-gated analysis result. |
| GET | /api/analyze/[id]/similar | Analysis owner | Find semantically similar owned analyses. |
| GET | /api/analyze/chats/list | Signed-in user | List analysis conversations for the current user. |
| POST | /api/analyze/trigger | Signed-in user | Reserve quota and queue uploaded-video analysis. |
| POST | /api/analyze/youtube | Signed-in user | Import and analyze a public YouTube URL. |
Research
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/analyze-competitor | Signed-in user; Pro | Run a detailed competitor-video teardown. |
| POST | /api/audience-questions/analyze | Signed-in user; Pro | Mine and group YouTube audience questions. |
| POST | /api/competitors/scan | Signed-in user; Pro | Scan and save competitor intelligence. |
| POST | /api/competitors/watchlist | Signed-in user; Pro | Create or update a competitor watchlist. |
| POST | /api/gap-finder/search | Signed-in user; Pro | Run grounded content-gap research. |
| POST | /api/missions/generate | Signed-in user; Pro | Generate weekly missions on demand. |
| POST | /api/radar/scan | Signed-in user; Pro | Scan YouTube Shorts for objective breakouts. |
| POST | /api/radar/translate | Signed-in user; Pro | Translate research content. |
| POST | /api/radar/understand-video | Signed-in user; Pro | Summarize and understand a radar video. |
| POST | /api/trend-match/search | Signed-in user; Pro | Run grounded trend matching. |
Authentication
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/auth/fingerprint | Signed-in user | Record signup abuse signals and enforce free limits. |
| POST | /api/auth/signout | Signed-in user | Revoke the Supabase session globally. |
| GET | /api/auth/tiktok/authorize | Signed-in user | Start TikTok library OAuth. |
| GET | /api/auth/tiktok/callback | OAuth callback | Complete TikTok OAuth and store encrypted credentials. |
| POST | /api/auth/validate-email | Public; rate limited | Validate an email during signup. |
| GET | /api/auth/youtube/authorize | Signed-in user | Start YouTube library OAuth. |
| GET | /api/auth/youtube/callback | OAuth callback | Complete YouTube OAuth and store encrypted credentials. |
Billing
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/billing/cancel | Signed-in subscriber | Schedule Stripe subscription cancellation. |
| POST | /api/billing/checkout | Signed-in user | Create a Stripe checkout session with double-billing guard. |
| POST | /api/billing/portal | Signed-in subscriber | Create a Stripe customer-portal session. |
| POST | /api/billing/reactivate | Signed-in subscriber | Reactivate a canceling Stripe subscription. |
| POST | /api/billing/reconcile | Signed-in user | Reconcile stored entitlement with Stripe. |
| POST | /api/billing/sync | Signed-in user | Synchronize current Stripe subscription state. |
| POST | /api/billing/upgrade | Signed-in subscriber | Upgrade an existing Stripe subscription. |
Performance
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/blueprint-tracking/verify | Signed-in user; Pro | Verify published blueprint performance. |
| POST | /api/comparisons/create | Signed-in user; Pro | Create a before-versus-after comparison. |
| GET | /api/comparisons | Signed-in user | List owned video comparisons. |
| POST | /api/experiments/conclude | Signed-in user; Pro | Conclude an experiment using real metrics. |
| POST | /api/experiments/design | Signed-in user; Pro | Design a controlled content experiment. |
| POST | /api/retention-lab/score-idea | Signed-in user; Pro | Score idea-stage retention readiness. |
Communications
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/contact | Public; abuse protected | Validate and send a contact request. |
| POST | /api/email/welcome | Signed-in user | Send the post-signup welcome email. |
| GET · POST | /api/unsubscribe | Signed preference token | Render or apply a signed email-preference change. |
Creative DNA
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/creative-dna/visual-analysis | Signed-in user; Pro | Start creator visual-DNA analysis. |
| GET | /api/creative-dna/visual-status | Signed-in user; Pro | Read visual-DNA analysis status. |
| POST | /api/creator-dna/analyze | Signed-in user; Pro | Build or refresh the creator DNA profile. |
| POST | /api/creator-dna/measure-retention-accuracy | Signed-in user; Pro | Measure predicted versus observed retention accuracy. |
| POST | /api/creator-dna/sync-tiktok | Signed-in user; Pro | Synchronize the connected TikTok library. |
| POST | /api/creator-dna/sync-youtube | Signed-in user; Pro | Synchronize the connected YouTube library. |
Operations
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/cron/competitor-scan | Cron secret | Run scheduled competitor-watchlist scans. |
| POST | /api/cron/deliver-webhooks | Cron secret | Claim and deliver pending outbound webhook events. |
| GET | /api/cron/enforce-downgrades | Cron secret | Verify Stripe and RevenueCat entitlements and enforce downgrades. |
| POST | /api/cron/generate-missions | Cron secret | Generate scheduled weekly missions. |
| POST | /api/cron/maintenance-sweep | Cron secret | Clean expired OAuth, idempotency, and delivery records. |
| GET | /api/cron/progress-announcement | Cron secret | Send eligible creator progress announcements. |
| POST | /api/cron/reconcile-analyses | Cron secret | Reconcile stale and orphaned analysis jobs. |
| GET | /api/cron/reset-monthly-usage | Cron secret | Reset monthly usage counters. |
| GET | /api/cron/retention-emails | Cron secret | Send eligible retention lifecycle emails. |
| GET | /api/cron/trial-reminders | Cron secret | Compatibility no-op after trials were removed. |
| GET · POST | /api/cron/upgrade-nudge | Cron or queue authentication | Process upgrade-nudge delivery batches. |
| GET | /api/cron/weekly-digest | Cron secret | Send weekly creator digests. |
Create
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/hook-generator/generate | Signed-in user; Pro | Generate ranked hook scripts. |
| POST | /api/script-coach/analyze | Signed-in user; Pro | Analyze and score a script. |
| POST | /api/script-coach/rewrite | Signed-in user; Pro | Rewrite a script with iteration lineage. |
| POST | /api/thumbnail-lab/analyze | Signed-in user | Analyze a thumbnail, script, or YouTube reference. |
| GET | /api/thumbnail-lab/credits | Signed-in user | Return current thumbnail-generation credits. |
| POST | /api/thumbnail-lab/generate-image | Signed-in user with credit | Generate a thumbnail image and consume a credit. |
| POST | /api/title-lab/generate | Signed-in user; Pro | Generate and rank title variations. |
| POST | /api/version-lab/generate | Signed-in user; Pro | Generate and rank creative variants. |
| POST | /api/viral-planner/generate | Signed-in user; Pro | Generate a full viral blueprint. |
| POST | /api/viral-planner/publish | Plan owner | Associate a plan with a published video. |
| POST | /api/viral-planner/refine | Plan owner; Pro | Refine a complete plan or selected scope. |
Integrations
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/integrations/[id]/test | Connection owner; Pro | Send a safe test event to an integration. |
| POST | /api/integrations | Signed-in user; Pro | Create, update, or delete an outbound integration. |
OAuth
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/oauth/authorize | Signed-in resource owner | Approve or deny an MCP authorization request. |
| GET · OPTIONS | /api/oauth/metadata/authorization-server | Public | RFC 8414 authorization-server metadata. |
| GET · OPTIONS | /api/oauth/metadata/protected-resource | Public | RFC 9728 protected-resource metadata. |
| POST | /api/oauth/register | Public; rate limited | Dynamically register an OAuth client. |
| POST | /api/oauth/token | OAuth client | Exchange authorization codes or rotate refresh tokens. |
Storage
| Method | Path | Access | Purpose |
|---|---|---|---|
| GET | /api/storage/health | Operational health | Check storage-service availability. |
| POST | /api/storage/signed-url | Object owner | Create a short-lived playback URL. |
| POST | /api/storage/upload | Signed-in user | Handle supported multipart uploads. |
| GET · POST | /api/storage/upload-url | Signed-in user | Create a presigned R2 upload URL. |
Team
| Method | Path | Access | Purpose |
|---|---|---|---|
| GET · POST | /api/team/accept | Invite recipient | Inspect or accept a signed team invitation. |
| DELETE | /api/team/invite/[id] | Team owner | Revoke a pending invitation. |
| POST | /api/team/invite | Active Team-plan owner | Invite a teammate. |
| POST | /api/team/leave | Team member | Leave a joined workspace. |
| DELETE | /api/team/members/[id] | Team owner | Remove a workspace member. |
| GET | /api/team | Signed-in user | Return the caller’s effective team and seats. |
Retired media
| Method | Path | Access | Purpose |
|---|---|---|---|
| GET · DELETE | /api/video-generator/[id] | Record owner | Read or delete a legacy generation record. |
| POST | /api/video-generator/clone-voice | Disabled | Disabled voice-cloning endpoint. |
| GET | /api/video-generator/credits | Signed-in user | Return legacy video-generation credits. |
| POST | /api/video-generator/generate | Disabled | Disabled video-generation endpoint. |
| POST | /api/video-generator/render | Disabled | Disabled render-dispatch endpoint. |
| GET | /api/video-generator/voices/preview | Disabled | Disabled voice-preview endpoint. |
| GET | /api/video-generator/voices | Disabled | Disabled voice-catalog endpoint. |
Videos
| Method | Path | Access | Purpose |
|---|---|---|---|
| PATCH · DELETE | /api/videos/[id] | Video owner | Update ownership or delete an owned video. |
Webhooks
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/webhooks/revenuecat | RevenueCat signature | Apply signed mobile entitlement events idempotently. |
| POST | /api/webhooks/stripe | Stripe signature | Apply signed Stripe subscription events idempotently. |
YouTube
| Method | Path | Access | Purpose |
|---|---|---|---|
| POST | /api/youtube/metadata | Signed-in or supported bearer caller | Resolve safe YouTube metadata and duration. |