Skip to main content

​
Overview

The MediaMagic API allows you to programmatically submit media assets for processing and retrieve detailed analysis results through webhooks or polling.

​
What you can do

  • Upload files — Generate presigned URLs for direct client-side upload or stream files directly through the API
  • Submit assets — Create submissions with one or more pre-uploaded assets
  • Poll status — Check submission progress, versions, and processing results
  • Receive webhooks — Get real-time notifications when processing completes
  • Access results — Retrieve detailed analysis including topics, issues, evidence, and contributor information

​
Key features

  • Secure authentication — Workspace-scoped API keys with tier-based rate limiting
  • Flexible upload — Presigned URLs for large files or direct streaming for small files
  • Real-time updates — Standard Webhooks for event-driven architectures
  • Comprehensive results — Topic extraction, issue detection, evidence links, and contributor analysis

​
Getting started in 5 minutes

1

Get your API key

Create an API key in the MediaMagic control plane. You’ll need it for all API requests.
2

Upload a file

Generate a presigned URL and upload your media asset to Azure Blob Storage.
3

Submit for processing

Create a submission with your uploaded asset.
4

Check the results

Poll GET /api/submissions/{id} or set up webhooks for real-time updates.

​
Common use cases

Batch processing

Submit multiple assets and track progress with polling

Real-time updates

Receive instant notifications via webhooks

Large file uploads

Upload files with presigned URLs

Error recovery

Handle failures and retries gracefully

​
Next steps