Submagic

Submagic Create Magic Clips

Generate viral short clips from a long YouTube video. Requires youtube_url, title, and language. Optional min_clip_length (10–300s, default 15), max_clip_length (15–300s, default 60), and webhook_url for completion callbacks. Processing can take 5–30 minutes — poll project status by id or use a webhook.

Submagic Create User Media

Add media to your Submagic library from a public URL. Returns userMediaId for B-roll items and background music on projects.

Submagic Export Project

Start final video export with subtitles and effects burned in. Call after project status shows transcription is complete. Export takes a few minutes — poll project status for the download URL.

Submagic Get Profile Stats

Publishing analytics scoped to one profile (brand). Same shape as aggregate stats but filtered to a single profile.

Submagic Get Project

Get a Submagic project by ID. Returns status, transcription progress, video metadata, template settings, and download URLs when ready. Use the project wait tool to block until processing, transcription, or export completes.

Submagic Get Publication

Get a single publication by id with per-platform post URLs, delivery status, and analytics totals.

Submagic Get Publishing Stats

Aggregate publishing analytics across all connected accounts. Returns summary totals with prior-period comparison and a daily timeseries.

Submagic Health Check

Check Submagic API availability and confirm your API key is accepted. Returns service status and timestamp. Use before starting a long workflow.

Submagic List Hook Title Templates

List hook title animation templates for the opening seconds of a video. Use template names in hook_title when creating or updating projects.

Submagic List Languages

List supported transcription languages. Returns language codes and display names. Use the code field when creating projects (for example en, es, fr). Lightweight endpoint — safe to call before every create.

Submagic List Published Projects

List published or scheduled social posts with per-platform status and analytics. Filter by platform, profile, or date range. Use cursor for pagination.

Submagic List Templates

List caption style templates (Hormozi, Beast, Sara, and others). Pass a template name to template_name when creating a project. Default when omitted is Hormozi 2.

Submagic List User Media

List video, audio, and image files in your Submagic media library. Use returned ids as userMediaId in project items or music settings.

Submagic Publish Project

Publish or schedule an exported Submagic project to connected social accounts. Project must be exported (have downloadUrl). Connect accounts in the Submagic publishing dashboard first. Supports YouTube, TikTok, Instagram, X, Facebook, LinkedIn.

Submagic Upload Magic Clips

Generate short-form clips by uploading a long-form video file. Requires a Magic Clips subscription. Provide exactly one of: file_content_base64 (max 1 MB inline), file_url (public video URLs), or local_path (absolute path on the user's computer). Use list_local_directory to discover paths, then pass local_path on upload tools. Install MCPBundles Desktop at https://www.mcpbundles.com/desktop if it is not connected yet.

Submagic Upload Project

Create a subtitle project by uploading a video file. Supports the same styling and B-roll options as create-or-update from a public video URL. Provide exactly one of: file_content_base64 (max 1 MB inline), file_url (public video URLs), or local_path (absolute path on the user's computer). Use list_local_directory to discover paths, then pass local_path on upload tools. Install MCPBundles Desktop at https://www.mcpbundles.com/desktop if it is not connected yet.

Submagic Upload User Media

Upload a video, audio, or image file directly to your Submagic media library. Returns userMediaId for use in project items. Provide exactly one of: file_content_base64 (max 1 MB inline), file_url (media files), or local_path (absolute path on the user's computer). Use list_local_directory to discover paths, then pass local_path on upload tools. Install MCPBundles Desktop at https://www.mcpbundles.com/desktop if it is not connected yet.

Submagic Upsert Project

Create a new subtitle project from a public video URL, or update an existing project. Create mode (no id): requires title, language, video_url. Update mode (with id): send only fields to change. magic_zooms, magic_brolls, and magic_brolls_percentage apply on create/upload only. Optional on update: template_name, user_theme_id, webhook_url, dictionary, remove_silence_pace, remove_bad_takes, clean_audio, hook_title, music, and items (user-media or ai-broll insertions). Poll project status until pr

Submagic Wait For Project

Poll a Submagic project until status is completed or failed. Use after create, upload, magic clips, or export instead of manual get loops.