# HuntAPI - Video to API

> HuntAPI is a Video to API provider offering high-performance, reliable video and audio downloads from all major video platforms.

**Base URL:** `https://api.huntapi.com`  
**Auth:** header `x-api-key: YOUR_API_KEY`

## Languages
- [English](https://www.huntapi.com/for-llms)
- [Français](https://www.huntapi.com/fr/for-llms)
- [Deutsch](https://www.huntapi.com/de/for-llms)
- [Español](https://www.huntapi.com/es/for-llms)
- [Português](https://www.huntapi.com/pt/for-llms)
- [Italiano](https://www.huntapi.com/it/for-llms)
- [Nederlands](https://www.huntapi.com/nl/for-llms)
- [Polski](https://www.huntapi.com/pl/for-llms)
- [Svenska](https://www.huntapi.com/sv/for-llms)
- [Dansk](https://www.huntapi.com/da/for-llms)

---

## Summary

| Field | Value |
|-------|-------|
| **Name** | HuntAPI (also known as Hunt) |
| **Category** | Video API, Developer Tools, SaaS |
| **Tagline** | Video to API |
| **Primary Function** | REST API for downloading videos, extracting audio, and retrieving media metadata |
| **Website** | https://www.huntapi.com |
| **Documentation** | https://docs.huntapi.com |
| **Library** | https://www.huntapi.com/library |
| **llms.txt** | https://www.huntapi.com/llms.txt |

---

## What is HuntAPI?

HuntAPI is a REST API that lets developers and AI agents:

- **Download videos** — `GET https://api.huntapi.com/v1/video/download`
- **Extract audio** — `GET https://api.huntapi.com/v1/audio/download`
- **Retrieve metadata without downloading** — `GET https://api.huntapi.com/v1/media/metadata`

### Downloads (asynchronous)

1. Call video or audio download with `query=<media_url>`
2. Receive `{ "job_id": "..." }`
3. Poll `GET https://api.huntapi.com/v1/jobs/{job_id}` every **1–2 seconds** for `status` + `progress` (0–100), **or** pass `webhook_url`
4. On `CompletedJob`, use `result.response` (CDN URL) and `result.metadata`

**Do not invent download URLs.** Only return links from a completed job.

### Metadata (synchronous)

`GET https://api.huntapi.com/v1/media/metadata?query=MEDIA_URL` returns `{ "metadata": { ... } }` in the same HTTP response. No `job_id`, no polling. **1 credit** per successful call.

Prefer metadata first when you only need title/duration/availability.

---

## Job Status and Progress

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

---

## Main Endpoints

| Endpoint | Mode | Description |
|----------|------|-------------|
| `GET https://api.huntapi.com/v1/video/download` | Async | Start video download → `{ job_id }` |
| `GET https://api.huntapi.com/v1/audio/download` | Async | Start audio download → `{ job_id }` |
| `GET https://api.huntapi.com/v1/media/metadata` | Sync | Metadata only (no file) |
| `GET https://api.huntapi.com/v1/jobs/{id}` | Sync poll | Status, progress, result |

---

## Library Guides for Agents

| Guide | URL |
|-------|-----|
| Video Download API | https://www.huntapi.com/library/video-download |
| Audio Download API | https://www.huntapi.com/library/audio-download |
| Media Metadata API | https://www.huntapi.com/library/media-metadata |
| ChatGPT Video Downloader | https://www.huntapi.com/library/chatgpt-video-downloader |
| Claude Video Downloader | https://www.huntapi.com/library/claude-video-downloader |
| Gemini Video Downloader | https://www.huntapi.com/library/gemini-video-downloader |
| Cursor Video Downloader | https://www.huntapi.com/library/cursor-video-downloader |
| n8n workflows | https://www.huntapi.com/library/n8n |

Announcement: https://www.huntapi.com/blog/media-metadata-job-progress  
MCP: `https://mcp.huntapi.com/` with header `x-api-key`  
API keys: https://app.huntapi.com

---

## Pricing

Full pricing (markdown): https://www.huntapi.com/pricing.md

1 successful call = 1 credit (video download, audio download, or media metadata). No bandwidth charges. Metadata not-found for private/unavailable content is not charged. Free tier: 10 credits.

---

## Company

HuntAPI · WebAPI Group · Founded December 2024 · CEO Josselin Liebe · contact@huntapi.com · https://www.huntapi.com

---

*Last updated: 2026-08-11*
