Media Metadata
Extract metadata from a media URL without downloading the file.
Credit cost: 1 credit per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringMedia URL to inspect (YouTube, Instagram, TikTok, Vimeo, X, Facebook, Twitch, Reddit, etc.).
Returns title, duration, thumbnail, channel, view counts and related metadata without downloading the file.
Notes: Some URLs cannot be inspected for the following reasons:
- Private content
- Unavailable / deleted content
- Age restricted content
In these cases, the API returns an explanatory error message.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
metadata?curl -X GET 'https://api.huntapi.com/v1/media/metadata?query=string'{ "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": "🎁 Starter Pack DaVinci Resolve GRATUIT : https://formations.alexjackson.io/starter-pack-davinci-resolve", "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" }}