API Reference
API Media Metadata
/library/media-metadata
L’API Media Metadata restituisce informazioni strutturate su un URL media pubblico (YouTube, Instagram, TikTok, Vimeo, X, Facebook, Twitch, Reddit, ecc.) senza scaricare il file.
Questo endpoint è sincrono: i metadati arrivano nella risposta HTTP (niente polling di job_id).
x-api-key:stringrichiesto
La tua chiave privata HuntAPI.
Endpoint: GET https://api.huntapi.com/v1/media/metadata
Costo: 1 credito per chiamata riuscita.
query:stringrichiesto
URL pubblico del media da ispezionare (es. un URL YouTube).
Risposta
{
"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"
}
}Campi di risposta
| Campo | Tipo | Descrizione |
|---|---|---|
metadata.id | string | Id media sulla piattaforma |
metadata.title | string | Titolo |
metadata.description | string | Descrizione |
metadata.duration | number | Durata in secondi |
metadata.thumbnail | string | URL della thumbnail |
metadata.channel | string | Nome canale / uploader |
metadata.channel_url | string | URL del canale |
metadata.view_count | number | Visualizzazioni |
metadata.like_count | number | Like |
metadata.width / height | number | Risoluzione se disponibile |
metadata.upload_date | number | Timestamp Unix |
metadata.is_live / was_live / live_status | - | Flag live |
metadata.extractor | string | Extractor di origine (es. Youtube) |
metadata.webpage_url | string | URL canonica della pagina |
metadata.original_url | string | URL passato in query |
Note
Alcuni URL non possono essere ispezionati se il contenuto è:
- Privato
- Non disponibile (eliminato o inaccessibile)
- Con restrizione di età
In questi casi l’API restituisce un errore esplicativo.
Correlati
- Scarica poi con
https://api.huntapi.com/v1/video/downloadohttps://api.huntapi.com/v1/audio/download - Monitora i job async con
https://api.huntapi.com/v1/jobs/{id}(campoprogress0–100)