Medien-Metadaten und Job-Fortschritt
Wir haben einige überfällige Media-Updates ausgeliefert: URLs prüfen ohne Download, und sehen wie weit ein Download ist.
Media Metadata (ohne Download)
Brauchst du Titel, Dauer, Thumbnail oder Kanal, bevor du ein Download-Credit ausgibst? Rufe auf:
GET https://api.huntapi.com/v1/media/metadata?query=https://www.youtube.com/watch?v=VIDEO_ID
x-api-key: YOUR_API_KEY
Dieser Endpoint ist synchron. Du bekommst ein metadata-Objekt in derselben Antwort - keine job_id, kein Polling. Kosten: 1 Credit pro erfolgreichem Aufruf.
Docs: Media Metadata API.
Nutze ihn zum Preview einer URL, für Kataloge oder um Qualität / max_duration vor einem Download-Job festzulegen.
Download-Job-Fortschritt (0–100)
Video- und Audio-Downloads bleiben asynchron. Neu auf GET https://api.huntapi.com/v1/jobs/{id} ist ein numerisches Feld progress:
| Status | Progress |
|---|---|
Queued | 0 |
Running | 1–99 |
CompletedJob / Error / … | 100 |
Alle 1–2 Sekunden pollen, solange der Job Queued oder Running ist. Webhooks funktionieren weiterhin.
Aktualisierte Referenzen:
Kurzes Mental Model
- Nur Infos →
GET https://api.huntapi.com/v1/media/metadata - Datei →
GET https://api.huntapi.com/v1/video/download(oder/v1/audio/download) →/v1/jobs/{id}pollen
Hol dir einen Key auf app.huntapi.com und teste zuerst einen Metadata-Call - der günstigste Weg zu prüfen, ob eine URL brauchbar ist.