▣ DATA EXTRACTION · FILE CONVERSION

Extract Video Metadata API

Hosted on ApyHub

What it does

Video Metadata Extractor reads a video file or video URL and returns its metadata as JSON. Send a binary video upload to /multi-part/download, or pass a video_url to /url/download.

The response contains structured metadata sections for audio, video, and file details. That makes it useful when you need to inspect media properties before processing, storing, or transcoding a video. For example, you can validate an incoming upload, build a media library index, or branch workflows based on codec, duration, or container information.

Use it when your application needs metadata without decoding the video itself. If you already have a file in your system, upload it directly. If the asset is hosted elsewhere, provide the URL and get the same JSON structure back.

Video Metadata Extractor is designed for straightforward media inspection: one input, one structured response containing audio, video, and file metadata sections.

▣ ENDPOINT 01 / 02

POST

Extract video metadata (upload → JSON)

http://localhost:8080/apyhub/extract-video-metadata/multi-part/download

QUICKSTARTGUIDE

Quickstart

Upload a video file to extract its metadata.

curl -X POST "http://localhost:8080/apyhub/extract-video-metadata/multi-part/download" \
  -H "apy-token: $APY_TOKEN" \
  -F "video=@/path/to/video.mp4"

What you'll get back

Returns a JSON object containing the extracted metadata, grouped into audio, video, and file sections.

{
    "audio": {},
    "video": {},
    "file": {}
}

TRY ITLIVE · 250 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

About this endpoint

What it does

Uploads a video file and returns a JSON response containing extracted metadata in a audio, video, and file sections.

Request Body

Parameter	Type	Mandatory	Description
video	String	Yes	Video file upload. Supported formats: `.mp4`, `.mkv`, `.avi`, `.mov`, `.flv`, `.3gp`, `.webm`.

Response

Returns a JSON object containing extracted metadata grouped into audio, video, and file sections.

Parameter	Type	Mandatory	Description
audio	Object	No	Contains audio metadata such as codec information, channels, sample rate, bitrate, and timing details.
video	Object	No	Contains video metadata including codec, resolution, duration, frame rate, color, and technical properties.
file	Object	No	Contains file and media metadata such as file name, size, format, timestamps, encoder, and container information.

Body

Name

Type

Description

bodyREQUIRED

object

—

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 02 / 02

POST

Extract video metadata (URL → JSON)

http://localhost:8080/apyhub/extract-video-metadata/url/download

QUICKSTARTGUIDE

Quickstart

Download video metadata from a video URL.

curl -X POST "http://localhost:8080/apyhub/extract-video-metadata/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"video_url":"https://assets.apyhub.com/samples/sample.mp4"}'

What you'll get back

Returns a JSON object containing the extracted metadata, grouped into audio, video, and file sections.

{
  "audio": {},
  "video": {},
  "file": {}
}

TRY ITLIVE · 250 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Extracts metadata from a video available at a URL and returns it in a JSON response. The request sends the video URL in the body, and the response contains structured metadata grouped into audio, video, and file sections.

Request Body

Parameter	Type	Mandatory	Description
video_url	String	Yes	The video file URL. Must be a valid URI.

Response

Returns a JSON object containing the extracted metadata, grouped into audio, video, and file sections.

Parameter	Type	Mandatory	Description
audio	Object	No	Contains audio metadata such as codec information, channels, sample rate, bitrate, and timing details.
video	Object	No	Contains video metadata including codec, resolution, duration, frame rate, color, and technical properties.
file	Object	No	Contains file and media metadata such as file name, size, format, timestamps, encoder, and container information.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.