API Reference
Media Metadata API
The Media Metadata API returns structured information about a public media URL (YouTube, Instagram, TikTok, Vimeo, X, Facebook, Twitch, Reddit, and more) without downloading the file.
This endpoint is synchronous: you get the metadata in the HTTP response (no job_id polling required).
x-api-key:stringrequired
Your HuntAPI private key.
Endpoint: GET https://api.huntapi.com/v1/media/metadata
Credit cost: 1 credit per successful call.
query:stringrequired
Public media URL to inspect (e.g. a YouTube watch URL).
Response
{
"metadata": {
"id": "3g3Eow41B6I",
"ext": "mp4",
"title": "Faire une interview Multicam avec UNE SEULE caméra",
"width": 640,
"height": 360,
"channel": "Alex Jackson",
"is_live": false,
"duration": 432,
"was_live": false,
"extractor": "Youtube",
"thumbnail": "https://i.ytimg.com/vi/3g3Eow41B6I/maxresdefault.jpg",
"like_count": 4060,
"view_count": 93297,
"channel_url": "https://www.youtube.com/channel/UCW0GdGxlRENND_ft84Cp5vg",
"description": "...",
"live_status": "not_live",
"upload_date": 1712188800,
"webpage_url": "https://www.youtube.com/watch?v=3g3Eow41B6I",
"original_url": "https://www.youtube.com/watch?v=3g3Eow41B6I"
}
}Response fields
| Field | Type | Description |
|---|---|---|
metadata.id | string | Platform media id |
metadata.title | string | Title |
metadata.description | string | Description |
metadata.duration | number | Duration in seconds |
metadata.thumbnail | string | Thumbnail URL |
metadata.channel | string | Channel / uploader name |
metadata.channel_url | string | Channel URL |
metadata.view_count | number | View count |
metadata.like_count | number | Like count |
metadata.width / height | number | Resolution when available |
metadata.upload_date | number | Unix timestamp |
metadata.is_live / was_live / live_status | - | Live stream flags |
metadata.extractor | string | Source extractor (e.g. Youtube) |
metadata.webpage_url | string | Canonical page URL |
metadata.original_url | string | URL you passed in query |
Notes
Some URLs cannot be inspected when content is:
- Private
- Unavailable (deleted or inaccessible)
- Age restricted
In those cases the API returns an explanatory error.
Related
- Download the file afterwards with
https://api.huntapi.com/v1/video/downloadorhttps://api.huntapi.com/v1/audio/download - Poll async download jobs with
https://api.huntapi.com/v1/jobs/{id}(includes aprogressfield from 0–100)
VIDEO API
Discover why Hunt is the preferred API provider for developers.