API Reference
Media Metadata API
De Media Metadata API geeft gestructureerde informatie over een openbare media-URL (YouTube, Instagram, TikTok, Vimeo, X, Facebook, Twitch, Reddit, enz.) zonder het bestand te downloaden.
Dit endpoint is synchroon: je krijgt de metadata in de HTTP-respons (geen job_id-polling).
x-api-key:stringvereist
Je privé HuntAPI-sleutel.
Endpoint: GET https://api.huntapi.com/v1/media/metadata
Kosten: 1 credit per geslaagde aanroep.
query:stringvereist
Openbare media-URL om te inspecteren (bijv. een YouTube-URL).
Response
{
"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"
}
}Responsevelden
| Veld | Type | Beschrijving |
|---|---|---|
metadata.id | string | Media-id op het platform |
metadata.title | string | Titel |
metadata.description | string | Beschrijving |
metadata.duration | number | Duur in seconden |
metadata.thumbnail | string | Thumbnail-URL |
metadata.channel | string | Kanaal- / uploadernaam |
metadata.channel_url | string | Kanaal-URL |
metadata.view_count | number | Aantal weergaven |
metadata.like_count | number | Aantal likes |
metadata.width / height | number | Resolutie indien beschikbaar |
metadata.upload_date | number | Unix-timestamp |
metadata.is_live / was_live / live_status | - | Live-flags |
metadata.extractor | string | Bron-extractor (bijv. Youtube) |
metadata.webpage_url | string | Canonieke pagina-URL |
metadata.original_url | string | URL uit query |
Opmerkingen
Sommige URL’s kunnen niet worden geïnspecteerd als de content:
- Privé
- Niet beschikbaar (verwijderd of ontoegankelijk)
- Leeftijdsbeperkt
is. In die gevallen geeft de API een verklarende foutmelding.
Gerelateerd
- Download daarna met
https://api.huntapi.com/v1/video/downloadofhttps://api.huntapi.com/v1/audio/download - Poll async jobs met
https://api.huntapi.com/v1/jobs/{id}(veldprogress0–100)
VIDEO API
Discover why Hunt is the preferred API provider for developers.