API Reference
Media Metadata API
Die Media Metadata API liefert strukturierte Informationen zu einer öffentlichen Medien-URL (YouTube, Instagram, TikTok, Vimeo, X, Facebook, Twitch, Reddit u. a.) ohne die Datei herunterzuladen.
Dieser Endpoint ist synchron: Die Metadaten kommen direkt in der HTTP-Antwort (kein job_id-Polling).
x-api-key:stringerforderlich
Ihr privater HuntAPI-Schlüssel.
Endpoint: GET https://api.huntapi.com/v1/media/metadata
Kosten: 1 Credit pro erfolgreichem Aufruf.
query:stringerforderlich
Öffentliche Medien-URL zur Prüfung (z. B. eine YouTube-URL).
Antwort
{
"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"
}
}Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
metadata.id | string | Medien-ID der Plattform |
metadata.title | string | Titel |
metadata.description | string | Beschreibung |
metadata.duration | number | Dauer in Sekunden |
metadata.thumbnail | string | Thumbnail-URL |
metadata.channel | string | Kanal- / Uploader-Name |
metadata.channel_url | string | Kanal-URL |
metadata.view_count | number | Aufrufe |
metadata.like_count | number | Likes |
metadata.width / height | number | Auflösung falls verfügbar |
metadata.upload_date | number | Unix-Timestamp |
metadata.is_live / was_live / live_status | - | Live-Flags |
metadata.extractor | string | Quell-Extractor (z. B. Youtube) |
metadata.webpage_url | string | Kanonische Seiten-URL |
metadata.original_url | string | URL aus query |
Hinweise
Manche URLs lassen sich nicht prüfen, wenn der Inhalt:
- Privat
- Nicht verfügbar (gelöscht oder unzugänglich)
- Altersbeschränkt
ist. In diesen Fällen liefert die API eine erklärende Fehlermeldung.
Verwandt
- Datei danach mit
https://api.huntapi.com/v1/video/downloadoderhttps://api.huntapi.com/v1/audio/downloadherunterladen - Async-Jobs mit
https://api.huntapi.com/v1/jobs/{id}pollen (Feldprogress0–100)
VIDEO API
Discover why Hunt is the preferred API provider for developers.