ChatGPT Video Downloader

Gebruik ChatGPT met HuntAPI om video’s te downloaden, audio te extraheren en metadata op te halen - zonder de chat te verlaten. Ideaal voor Custom GPTs, Actions en agents.

Wat je kunt doen

• Een YouTube- (of andere) URL in ChatGPT plakken en een bestands-URL krijgen
• Alleen audio extraheren (download_type=audio)
• Titel, duur en thumbnail via https://api.huntapi.com/v1/media/metadata vóór download
• Voortgang (0–100) volgen via poll op https://api.huntapi.com/v1/jobs/{id}

Snel starten

Hunt-downloads zijn asynchroon. ChatGPT moet:

1. Download-endpoint aanroepen → job_id ontvangen
2. Pollen tot status = CompletedJob
3. result.response (CDN-URL) en result.metadata teruggeven

Stap 1: download starten

GET https://api.huntapi.com/v1/video/download?query=https://www.youtube.com/watch?v=VIDEO_ID
x-api-key: YOUR_API_KEY

Response:

{
  "job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84"
}

Stap 2: status & voortgang

GET https://api.huntapi.com/v1/jobs/0193443f-fb80-9d19-29ba-82bc77c7cd84
x-api-key: YOUR_API_KEY

Bezig:

{
  "id": "0193443f-fb80-9d19-29ba-82bc77c7cd84",
  "status": "Running",
  "progress": 63,
  "result": null
}

Klaar:

{
  "id": "0193443f-fb80-9d19-29ba-82bc77c7cd84",
  "status": "CompletedJob",
  "success": true,
  "progress": 100,
  "result": {
    "metadata": {
      "title": "Example video",
      "duration": 432,
      "thumbnail": "https://i.ytimg.com/vi/.../maxresdefault.jpg"
    },
    "response": "https://s3.huntapi.com/videos/<uuid>.mp4"
  }
}

Poll elke 1–2 seconden zolang status Queued of Running is.

Optioneel: alleen metadata (geen download)

GET https://api.huntapi.com/v1/media/metadata?query=https://www.youtube.com/watch?v=VIDEO_ID
x-api-key: YOUR_API_KEY

Synchroon - geeft meteen { "metadata": { ... } } terug.

ChatGPT Actions instellen

1. Maak een Custom GPT → Configure → Actions → Create new action
2. Importeer een OpenAPI-schema met:
   • GET https://api.huntapi.com/v1/video/download
   • GET https://api.huntapi.com/v1/jobs/{id}
   • (optioneel) GET https://api.huntapi.com/v1/media/metadata
3. Auth: API Key-header x-api-key
4. Server-URL: https://api.huntapi.com
5. Laat de GPT pollen tot CompletedJob en de bestands-URL delen

Voorbeeld system prompt (Custom GPT)

You are a video downloader assistant powered by HuntAPI.
When the user pastes a video URL:
1) Optionally call https://api.huntapi.com/v1/media/metadata to confirm title/duration.
2) Call /v1/video/download with query=<url>.
3) Poll /v1/jobs/{job_id} every 2 seconds until status is CompletedJob.
4) Return the CDN URL from result.response and a short summary from result.metadata.
Never invent download links. If status is Error/NotFound, explain the error clearly.

Nuttige queryparameters

Gerelateerd

• Video Download API
• Media Metadata API
• Claude Video Downloader
• YouTube-video’s downloaden met n8n