API Reference
API Media Metadata
/library/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)