Guide
|
door Hunt Team

GTA VI livestreams en VOD’s: clipping op schaal met de Hunt API

De launchweek van GTA VI betekent eindeloze livestreams: reacties op de reveal, creator-marathons, esports-scrims en patch-analyses na de release. Productteams, redacties en clipkanalen willen allemaal hetzelfde: een uitzending omzetten in bestanden (volledige VOD, highlights van 30 seconden, audio voor transcriptie) zonder zware downloadlogica op hun eigen servers te draaien.

Deze gids beschrijft een praktische workflow: wanneer je de API aanroept, hoe je wacht op een afgeronde VOD, hoe je clipt met max_duration en hoe je automatiseert met jobs en webhooks. De focus ligt op livestreams en VOD’s, niet op één specifiek platform.

Eerst live, dan de VOD

Een live-URL is een bewegend doel. Zolang de streamer niet is gestopt en het platform de replay nog niet volledig heeft verwerkt, kun je meestal geen stabiel, volledig bestand downloaden. Pipelines die een download starten zodra iemand live gaat, mislukken of leveren onvolledige data op.

Pas je workflows aan:

  1. Volg het live-event (CMS, spreadsheet of bot).
  2. Als de stream eindigt, vervang je de URL door de link naar de replay / VOD (of dezelfde canonieke URL, zodra het platform een duur en een afgeronde opname toont).
  3. Pas dan roep je Video Download aan, of je controleert eerst de metadata (zie hieronder).

Dezelfde live-URL in een lus opnieuw proberen verspilt credits en wachttijd. Plan één poging na het einde van de stream, of vraag de metadata op tot de duur bekend is.

Stap 0: metadata (1 credit, synchroon)

Controleer de URL met Media Metadata voordat je een downloadjob gebruikt:

GET https://api.huntapi.com/v1/media/metadata?query=https://www.twitch.tv/videos/1234567890
x-api-key: YOUR_API_KEY

Op basis van het antwoord beslis je:

  • Titel en thumbnail: GTA VI coverage van tientallen creators catalogiseren
  • Duur: downloads boven je limiet overslaan en max_duration instellen voor clips
  • Live of replay: ontbreekt de duur of loopt de uitzending nog, start dan de volledige VOD-download nog niet
{
  "metadata": {
    "title": "GTA VI launch night — full stream",
    "duration": 14422,
    "thumbnail": "https://…",
    "channel": "CreatorName",
    "webpage_url": "https://…"
  }
}

Bij het monitoren van een launch met veel volume is metadata het goedkoopste filter.

Stap 1: een download starten (asynchroon)

Volledige replay voor een editor of archief:

GET https://api.huntapi.com/v1/video/download?query=https://www.twitch.tv/videos/1234567890&video_quality=720p&download_type=audio_video&video_format=mp4
x-api-key: YOUR_API_KEY

Antwoord:

{
  "job_id": "019bd4a1-7c3e-7f2a-9d11-88a0c4e91f02"
}

Highlight-clip (alleen de eerste N seconden, handig voor “beste moment”-automatiseringen als je het tijdvenster al kent):

GET https://api.huntapi.com/v1/video/download?query=…&max_duration=45&video_quality=720p&download_type=video
x-api-key: YOUR_API_KEY

Alleen audio voor transcriptie (patch notes, interviewfragmenten):

GET https://api.huntapi.com/v1/video/download?query=…&download_type=audio
x-api-key: YOUR_API_KEY

De downloads draaien op de infrastructuur van Hunt: je app bewaart alleen de job_id.

Stap 2: voortgang opvragen of een webhook gebruiken

Terwijl de job loopt:

GET https://api.huntapi.com/v1/jobs/019bd4a1-7c3e-7f2a-9d11-88a0c4e91f02
x-api-key: YOUR_API_KEY
{
  "status": "Running",
  "progress": 64,
  "endpoint": "/api/video/download"
}

Vraag elke 1–2 seconden op, of geef webhook_url mee in het eerste verzoek zodat Hunt de CDN-link via POST stuurt zodra het bestand klaar is:

GET https://api.huntapi.com/v1/video/download?query=…&webhook_url=https://your.app/hooks/hunt-video

Het voortgangsmodel 0–100 staat uitgelegd in metadata en jobvoortgang.

Voorbeeld: GTA VI clip-pipeline (pseudocode)

async function archiveSegment(vodUrl: string, maxSeconds = 60) {
  const meta = await hunt.get("/v1/media/metadata", { query: vodUrl });
  if (!meta.metadata?.duration) {
    throw new Error("Nog live of VOD niet klaar, later opnieuw proberen");
  }

  const { job_id } = await hunt.get("/v1/video/download", {
    query: vodUrl,
    max_duration: maxSeconds,
    video_quality: "720p",
    download_type: "video",
    webhook_url: process.env.HUNT_WEBHOOK,
  });

  return job_id;
}

Zet dit achter een queue (SQS, Bull, Windmill, n8n): één job per VOD-URL zodra de stream is afgelopen, en maak daarna aan jouw kant clips uit het masterbestand met verschillende max_duration-waarden of offsets.

Waar teams dit voor gebruiken in het GTA VI seizoen

Use caseAPI-patroon
Replay-archief voor redactiesVolledige audio_video-download zodra de VOD online staat
Social clippingmax_duration + alleen video, 720p
Podcast / quotes verzamelendownload_type=audio
Dashboard voor creator-monitoringAlleen metadata tot de duur verschijnt
Nachtelijke batchwebhook_url, geen polling

Beperkingen om rekening mee te houden

  • Live-URL’s: wacht op de afgeronde replay; maak van “nog live” geen retry-lus.
  • Heel lange marathons: bij video’s van meer dan een uur kan de kwaliteit beperkt zijn tot 720p (zie Video Download).
  • Rechten: de Hunt API haalt op wat de URL beschikbaar stelt; je product moet nog steeds toestemming van creators en de voorwaarden van platforms respecteren.

Aan de slag

  1. Maak een key aan op app.huntapi.com.
  2. Test de metadata met een afgeronde VOD-URL.
  3. Start een download met een webhook.
  4. Voeg max_duration toe zodra de download van het volledige bestand werkt.

Voor workflows die door agents worden aangestuurd, zijn dezelfde endpoints beschikbaar via de Hunt API MCP: je assistent start de jobs en jij houdt dezelfde asynchrone volgorde aan (metadata → VOD → clip).

VIDEO API

Discover why Hunt is the preferred API provider for developers.