---
title: Extract Video Metadata API
slug: video-metadata-extract
url: https://apyverse.com/apyhub/service/video-metadata-extract
provider: ApyHub
categories: [Data Extraction, File Conversion]
auth: api_key
---

# Extract Video Metadata API

Extract nested metadata from a video upload or URL. Get JSON grouped into audio, video, and file sections for media checks and ingestion pipelines.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `video/metadata/file` | What it does Uploads a video file and returns a JSON object containing extracted metadata. The resp… | 250 |
| POST | `video/metadata/url` | What it does Extracts metadata for a video identified by a URL and returns it as JSON. The request… | 10 |

## About

## What it does
Video Metadata Extractor reads a video file or a video URL and returns a nested metadata object in JSON. Send either an uploaded video in `body.video` or a remote file in `body.video_url`, and get the extracted `data` payload back.

Use it when you need to inspect media properties before upload, transcode a library, or store technical details alongside user-generated video. The response is structured for programmatic processing, with metadata grouped into `audio`, `video`, and `file` sections.

Because the service accepts common video formats such as `.mp4`, `.mkv`, `.avi`, `.mov`, `.flv`, `.3gp`, and `.webm`, it fits ingestion pipelines that handle mixed source media. You can point it at a hosted asset, extract metadata at the edge of your workflow, and decide whether a file meets your processing rules without downloading or parsing it yourself.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyverse.com/apyhub/service/video-metadata-extract