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