All toolsvideo metadata API

Get Video Metadata with an API

Read duration, dimensions, codecs and audio tracks from any media URL. Run the preset directly on this page or call the same agent-ready endpoint from your product.

Run this tool View API recipe

LIVE TOOL

Run video metadata

Drop a video, adjust the defaults if you need to, and download the result here.

Useful defaults, typed options.

The tool slug stays stable while your agent supplies named media inputs and a narrow set of documented options.

No FFprobe binary to install
Rotation-corrected dimensions
Typed fields an agent can trust

What this preset does

01Fetch the source media
02Probe streams with FFprobe
03Resolve rotation into display size
04Return one normalized JSON

Stable endpointPOST /api/v1/tools/video-metadata

Live API request

Synced with form

{
  "inputs": [{ "id": "main", "url": "https://example.com/video.mp4" }],
  "options": {}
}

Successful output example

{
  "durationSeconds": 12.48,
  "video": { "codec": "h264", "displayWidth": 1080, "displayHeight": 1920, "frameRate": 30, "aspectRatio": "9:16" },
  "audio": [{ "codec": "aac", "channels": 2 }]
}

Know the boundaries before you run.

Reads stream and format headers; no encode runs

Counts as a regular job, typically one credit

About video metadata

Container, duration, size, bitrate, the video codec with dimensions resolved for rotation into display width and height, frame rate, aspect ratio, pixel format, and every audio track with codec, channels and sample rate.

Over MCP, the get_video_metadata tool returns the same JSON in result.input, so an agent can read the source before choosing a crop, trim or resize.