API Reference
API Media Metadata
/library/media-metadata
La API Media Metadata devuelve información estructurada sobre una URL pública (YouTube, Instagram, TikTok, Vimeo, X, Facebook, Twitch, Reddit, etc.) sin descargar el archivo.
Este endpoint es síncrono: recibes los metadatos en la respuesta HTTP (sin polling de job_id).
x-api-key:stringrequerido
Tu clave privada de HuntAPI.
Endpoint: GET https://api.huntapi.com/v1/media/metadata
Coste: 1 crédito por llamada exitosa.
query:stringrequerido
URL pública del media a inspeccionar (p. ej. una URL de YouTube).
Respuesta
{
"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"
}
}Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
metadata.id | string | Id del media en la plataforma |
metadata.title | string | Título |
metadata.description | string | Descripción |
metadata.duration | number | Duración en segundos |
metadata.thumbnail | string | URL de la miniatura |
metadata.channel | string | Nombre del canal / uploader |
metadata.channel_url | string | URL del canal |
metadata.view_count | number | Número de vistas |
metadata.like_count | number | Número de likes |
metadata.width / height | number | Resolución si está disponible |
metadata.upload_date | number | Timestamp Unix |
metadata.is_live / was_live / live_status | - | Flags de directo |
metadata.extractor | string | Extractor de origen (p. ej. Youtube) |
metadata.webpage_url | string | URL canónica de la página |
metadata.original_url | string | URL pasada en query |
Notas
Algunas URLs no se pueden inspeccionar si el contenido es:
- Privado
- No disponible (eliminado o inaccesible)
- Con restricción de edad
En esos casos la API devuelve un error explicativo.
Relacionado
- Descarga después con
https://api.huntapi.com/v1/video/downloadohttps://api.huntapi.com/v1/audio/download - Consulta jobs async con
https://api.huntapi.com/v1/jobs/{id}(campoprogress0–100)