API Reference
API Media Metadata
L’API Media Metadata renvoie des informations structurées sur une URL média publique (YouTube, Instagram, TikTok, Vimeo, X, Facebook, Twitch, Reddit, etc.) sans télécharger le fichier.
Cet endpoint est synchrone : la réponse HTTP contient directement les métadonnées (pas de polling job_id).
x-api-key:stringrequis
Votre clé privée HuntAPI.
Endpoint : GET https://api.huntapi.com/v1/media/metadata
Coût : 1 crédit par appel réussi.
query:stringrequis
URL publique du média à inspecter (ex. une URL YouTube).
Réponse
{
"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"
}
}Champs de réponse
| Champ | Type | Description |
|---|---|---|
metadata.id | string | Identifiant média sur la plateforme |
metadata.title | string | Titre |
metadata.description | string | Description |
metadata.duration | number | Durée en secondes |
metadata.thumbnail | string | URL de la miniature |
metadata.channel | string | Nom de la chaîne / auteur |
metadata.channel_url | string | URL de la chaîne |
metadata.view_count | number | Nombre de vues |
metadata.like_count | number | Nombre de likes |
metadata.width / height | number | Résolution si disponible |
metadata.upload_date | number | Timestamp Unix |
metadata.is_live / was_live / live_status | - | Indicateurs live |
metadata.extractor | string | Extracteur source (ex. Youtube) |
metadata.webpage_url | string | URL canonique de la page |
metadata.original_url | string | URL passée dans query |
Notes
Certaines URLs ne peuvent pas être inspectées si le contenu est :
- Privé
- Indisponible (supprimé ou inaccessible)
- Restreint par âge
Dans ces cas, l’API renvoie une erreur explicative.
Voir aussi
- Télécharger ensuite avec
https://api.huntapi.com/v1/video/downloadouhttps://api.huntapi.com/v1/audio/download - Suivre un job async via
https://api.huntapi.com/v1/jobs/{id}(champprogress0–100)
VIDEO API
Discover why Hunt is the preferred API provider for developers.