# YouTube Downloader — Zapi reference

> Download video & audio dari YouTube — kualitas hingga 1080p, mode audio-only (mp3). Tempel URL, dapat link unduhan langsung.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/downloader/youtube
- Endpoint catalog: https://zpi.web.id/category/downloader
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## YouTube Downloader

**Category:** downloader · **Slug:** `youtube`
**Detail page:** https://zpi.web.id/api/downloader/youtube

Download video & audio dari YouTube — kualitas hingga 1080p, mode audio-only (mp3). Tempel URL, dapat link unduhan langsung.

**Tags:** youtube, downloader, video, audio

### Download

Download media dari YouTube.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/downloader:youtube/download`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `url` | string | query | yes | YouTube media URL (video or post). Query params are fine. |
| `quality` | enum(144|240|360|480|720|1080|max) | query | no | Max video quality — `max` = best available. Ignored when audioOnly=true. |
| `audioOnly` | enum(true|false) | query | no | Set `true` to fetch audio only. Default `false` (video). |
| `audioFormat` | enum(mp3|opus|ogg|wav) | query | no | Audio container when audioOnly=true. Default mp3. |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/downloader:youtube/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&quality=1080&audioOnly=false&audioFormat=mp3" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/downloader:youtube/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&quality=1080&audioOnly=false&audioFormat=mp3", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/downloader:youtube/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ&quality=1080&audioOnly=false&audioFormat=mp3",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ok": true,
  "url": "https://cbt.zpi.web.id/tunnel?id=y-P2cCDN_hF6zS4a00vt6&exp=1780841297533&sig=x3g8WJXSELziFWWLiD4sGq2jtq6JCbcv3X-sQ7N8B0Y&sec=Jcpn4xBFKNTcpX4RQwI1ttYbFKbbPwiJmkZKl-dIQ_4&iv=OGshggWPx11q-BL4xwu7Rw",
  "type": "audio",
  "filename": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster) - Rick Astley.mp3",
  "provider": "youtube",
  "originalUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
```

---


_Generated: 2026-08-02T14:30:30.438Z_