AI Assistants

Claude Video Downloader

Use Claude with HuntAPI to download videos, extract audio, and fetch metadata. Works well with Claude Projects, tool use / MCP, and developer workflows.

What you can do

Ask Claude to download a video from a URL and get a CDN link back
Extract audio only for transcripts or podcasts
Preview metadata first with https://api.huntapi.com/v1/media/metadata
Show download progress using the progress field (0–100) from /v1/jobs/{id}

Quick Start

Hunt downloads are asynchronous. Claude (or your MCP tool) should:

Start a download → get job_id
Poll until status is CompletedJob
Return result.response to the user

Step 1: Start download

GET https://api.huntapi.com/v1/video/download?query=https://www.youtube.com/watch?v=VIDEO_ID&download_type=audio_video
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

`status`	Meaning	`progress`
`Queued`	Waiting for a worker	`0`
`Running`	Downloading / uploading	`1`–`99`
`CompletedJob`	Ready	`100`
`Error` / `NotFound` / `BadRequest`	Failed	`100`

Completed payload:

{
  "status": "CompletedJob",
  "progress": 100,
  "result": {
    "metadata": { "title": "Example video", "duration": 432 },
    "response": "https://s3.huntapi.com/videos/<uuid>.mp4"
  }
}

Metadata without downloading

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

Using Claude with HuntAPI

Option A - Claude Projects + instructions

Add your API key as a secret in your integration layer (never paste keys in the chat if avoidable). Give Claude project instructions:

When the user shares a video URL, use HuntAPI:
1. GET https://api.huntapi.com/v1/media/metadata?query=<url> (optional preview)
2. GET /v1/video/download?query=<url>
3. Poll GET /v1/jobs/{job_id} every 2s until CompletedJob
4. Share result.response and a short metadata summary

Option B - MCP / tool calling

Expose Hunt endpoints as tools (download, jobs, metadata). Claude can call them in a loop until the job completes. See also the HuntAPI MCP docs if you use the WebAPI MCP server.

Option C - Developer scripts

From a Claude Code / Cursor session, call the same HTTP endpoints with curl or your SDK, then paste the CDN URL back into Claude for summarization or editing.

Example prompts

“Download this YouTube video in 720p and give me the MP4 link: <url>”
“Extract audio only from this video as MP3”
“First show me the title and duration, then download if it’s under 20 minutes”

Get API Key