Media Inspector

A simple API to identify and inspect media files. If a media file is identified, the media file will be returned such as resolution, bit rate and duration.

Use Cases

• Detect video, audio images and pictures in user uploads
• Enforce minimum resolution or bitrate requirements
• Display metadata like bitrate and resolution for existing media
• Make encoding decisions

Formats / Codecs

Thousands of formats and codecs are supported. No file size limit.

Common Codecs / Formats

• MP4 / MOV / MPEG-TS / AVI
• H.264 / AVC
• H.265 / HEVC
• VP8 / VP9
• AV1
• JPEG / JPG
• PNG
• WebP

Job Specification

{
“url”: “https://example.com/path/to/video.mp4?auth-if-need=secret”
}

Success Response (Media Not Found)

{
“status”: “ok”,
“timestamp”: “2020-01-01T00:00:00.000Z”,
“url”: “https://example.com/path/to/not_media.pdf”,
“isMedia”: false,
“hasVideo”: false,
“hasAudio”: false,
“streams”: []
}

Success Response (Media Found)

{
“status”: “ok”,
“timestamp”: “2020-01-01T00:00:00.000Z”,
“url”: “https://example.com/path/to/video.mp4”,
“isMedia”: true,
“hasVideo”: true,
“hasAudio”: true,
“format”: “mov,mp4,m4a,3gp,3g2,mj2”,
“duration”: “370.98”,
“startTime”: "0.000"
“size”: “65536”,
“streams”: [
{
“codecType”: “video”,
“codec”: “h264”,
“index”: 0,
“width”: 1920,
“height”: 1080,
“bitRate”: 4000000,
“frameRate”: “23.976”,
“frameRateRational”: “24000/1001”,
“displayAspectRatio”: “16:9”,
“sampleAspectRatio”: “1:1”,
“pixelFormat”: “yuv420p”,
“duration”: “369.3”,
“startTime”: “0.000”
},
{
“codecType”: “audio”,
“codec”: “aac”,
“index”: 1,
“bitRate”: 128,
“sampleRate”: 48000,
“channels”: 2,
“duration”: “368.9”,
“startTime”: “0.000”
}
]
}

Error Response

{
“status”: “error”,
“timestamp”: “2020-01-01T00:00:00.000Z”,
“url”: “https://example.com/path/to/video.mp4”,
“errorMessage”: “Unable to fetch URL”,
“isMedia”: false,
“hasVideo”: false,
“hasAudio”: false,
“streams”: []
}