AI Assistants

ChatGPT Video Downloader

Use ChatGPT with HuntAPI to download videos, extract audio, and fetch metadata - without leaving your chat. Ideal for Custom GPTs, ChatGPT Actions, and agent workflows.

What you can do

Paste a YouTube (or other) URL in ChatGPT and get a downloadable file URL
Extract audio only (download_type=audio)
Fetch title, duration, and thumbnail via https://api.huntapi.com/v1/media/metadata before downloading
Track download progress (0–100) by polling https://api.huntapi.com/v1/jobs/{id}

Quick Start

Hunt downloads are asynchronous. ChatGPT should:

Call the download endpoint → receive a job_id
Poll the jobs endpoint until status is CompletedJob
Return result.response (CDN URL) and result.metadata to the user

Step 1: Start download

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"
}

Step 2: Poll status & progress

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

Running:

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

Completed:

{
  "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 every 1–2 seconds while status is Queued or Running.

Optional: metadata only (no download)

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

Synchronous - returns { "metadata": { ... } } immediately.

ChatGPT Actions setup

Create a Custom GPT → Configure → Actions → Create new action
Import or paste an OpenAPI schema that exposes:
- GET https://api.huntapi.com/v1/video/download
- GET https://api.huntapi.com/v1/jobs/{id}
- (optional) GET https://api.huntapi.com/v1/media/metadata
Authentication: API Key header x-api-key
Server URL: https://api.huntapi.com
Instruct the GPT to always poll jobs until CompletedJob, then share the file URL

Example 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.

Useful query parameters

Param	Values	Notes
`query`	URL	Required
`download_type`	`audio_video`, `audio`, `video`	Use `audio` for MP3
`video_quality`	`best`, `1080p`, `720p`, …	Long videos (>1h) capped at 720p
`video_format`	`mp4`, `webm`, `mkv`	Preference

Get API Key