Get technical metadata for a video

Probes a video file or HLS playlist via ffprobe and returns a key-value map of
technical properties: codec, resolution, frame rate, duration, bitrate, and more.
Use this to inspect source recordings before scheduling an export, or to validate
output files after export.

This is a synchronous endpoint — it returns immediately with the result.

videoUrl must be a publicly reachable HTTP(S) URL. HLS playlists (.m3u8) and
direct video files (.mp4, .ts, etc.) are both supported. The probe may time out
for very large or slow-to-open sources, in which case errorCode: -1 is returned
with a descriptive message.

The exact keys in data depend on the source format; all values are returned as-is
from ffprobe output.

Error Codes

Code	Message	Cause
`0`	success	Metadata is in the `data` field
`-1`	get video format failed, err: ...	`videoUrl` is unreachable, unsupported format, or timed out
`-1`	json unmarshal failed, err: ...	Probe output could not be parsed; contact TVU Support

curl --location 'https://api.tvunetworks.com/metadata?videoUrl=https%3A%2F%2Fmedia-export-bucket.s3.us-east-1.amazonaws.com%2Fexport%2Fclip_20231114_30s.mp4' \ --header 'SID: 92575d36dcb631ac94745e6b157de17a5a13d65b31e44869f06854ab928dd80235d4daae8696b4a92a7be5f802c45a219648701fc9ca59f44e9c0f022d5d38a7'

{ "errorCode": 0, "errorMessage": "success", "data": { "duration": 30.5, "width": 1920, "height": 1080, "codec": "h264", "framerate": "29.97", "bitrate": 5000000 } }

Error Codes

Request

Responses

Get technical metadata for a video

Error Codes#

Request

Responses

Error Codes