# Twitter / X Downloader — Zapi reference

> Download video dari Twitter / X. Tempel URL tweet yang berisi video.

**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/twitter
- 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

---

## Twitter / X Downloader

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

Download video dari Twitter / X. Tempel URL tweet yang berisi video.

**Tags:** twitter, x, downloader, video

### Download

Download media dari Twitter / X.

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `url` | string | query | yes | Twitter / X 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:twitter/download?url=https%3A%2F%2Fx.com%2FSpaceX%2Fstatus%2F1732824684683784516&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:twitter/download?url=https%3A%2F%2Fx.com%2FSpaceX%2Fstatus%2F1732824684683784516&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:twitter/download?url=https%3A%2F%2Fx.com%2FSpaceX%2Fstatus%2F1732824684683784516&quality=1080&audioOnly=false&audioFormat=mp3",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "ok": true,
  "url": "https://video.twimg.com/ext_tw_video/1732820284301058052/pu/vid/avc1/1920x1080/K2NITCly19drRgED.mp4",
  "type": "video",
  "filename": "twitter_1732824684683784516.mp4",
  "provider": "twitter",
  "originalUrl": "https://x.com/SpaceX/status/1732824684683784516"
}
```

---


_Generated: 2026-08-02T14:27:42.715Z_