API Reference
API 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)
VIDEO API
Discover why Hunt is the preferred API provider for developers.