NEWVectors or files. Pick a path.Start →
    media

    Video
    Metadata
    Converter

    Extract comprehensive technical and semantic metadata from video files. Returns codec details, resolution, duration, frame rate, and AI-generated semantic tags including detected objects, scenes, dominant colors, and content categories.

    Max file size: 5 GB
    Estimated: 30 sec - 3 min per video
    5 input formats

    How It Works

    1

    Upload a video file or provide a URL to the Mixpeek API.

    2

    Technical metadata is parsed from the container and codec headers.

    3

    Sampled frames are analyzed by a vision model to extract semantic tags and content categories.

    4

    Audio metadata including language, speaker count, and music detection is extracted.

    5

    All metadata is merged into a structured JSON response with technical and semantic sections.

    Code Examples

    import os, requests
    
    API = "https://api.mixpeek.com"
    H = {"Authorization": f"Bearer {os.environ['MIXPEEK_API_KEY']}",
         "X-Namespace": os.environ["NAMESPACE_ID"]}
    
    # 1. a bucket, with a schema that declares the field you will send
    bucket = requests.post(f"{API}/v1/buckets", headers=H, json={
        "bucket_name": "video-inputs",
        "bucket_schema": {"properties": {"video": {"type": "video"}}},
    }).json()
    
    # 2. land the file as an object. the URL goes in data, on the blob
    requests.post(f"{API}/v1/buckets/{bucket['bucket_id']}/objects", headers=H, json={
        "key_prefix": "run-1",
        "blobs": [{"property": "video", "type": "video",
                   "data": "https://example.com/clip.mp4"}],
    })
    
    # 3. a collection over that bucket, running the extractor
    collection = requests.post(f"{API}/v1/collections", headers=H, json={
        "collection_name": "video-to-metadata",
        "source": {"type": "bucket", "bucket_ids": [bucket["bucket_id"]]},
        "feature_extractor": {"feature_extractor_name": "multimodal_extractor", "version": "v1"},
    }).json()
    
    # 4. run extraction over the bucket
    requests.post(f"{API}/v1/buckets/{bucket['bucket_id']}/batches", headers=H, json={
        "collection_ids": [collection["collection_id"]],
        "auto_submit": True,
    })
    
    # 5. read the output
    docs = requests.get(
        f"{API}/v1/collections/{collection['collection_id']}/documents", headers=H
    ).json()
    print(docs)

    Use Cases

    Enrich media asset management systems with automated metadata
    Build filterable video catalogs with AI-generated tags and categories
    Audit video libraries for technical compliance (codec, resolution, bitrate)
    Pre-process video uploads to validate quality and detect content type before ingestion

    Supported Input Formats

    MP4
    MOV
    AVI
    MKV
    WebM

    Quick Info

    Categorymedia
    Max File Size5 GB
    Est. Time30 sec - 3 min per video

    Processing millions of hours of video?

    Run this as a managed pipeline over your entire video archive, no infrastructure to build or maintain. Talk to us about processing at scale.

    Run it over a library

    Mixpeek runs this conversion as a pipeline over a whole library in your object storage, with the output landing as queryable documents. It is not a single-file converter.

    Frequently Asked Questions

    Ready to convert video to metadata?

    Start using the Mixpeek Video to Metadata in minutes. Sign up for a free API key and follow the documentation to get started.