HuntAPI

Media Metadata

GET
/v1/media/metadata

Extract metadata from a media URL without downloading the file.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Media 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?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
metadata?
Example Request
curl -X GET 'https://api.huntapi.com/v1/media/metadata?query=string'
Example 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": "🎁 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"  }}