# tiktok.js

Scraper dan downloader TikTok yang langsung hit internal mobile API TikTok — tanpa browser, tanpa WAF.

Dibuat untuk Termux dan environment Node.js lainnya.

---

## Fitur

- Ambil metadata video (stats, author, musik, cover) dalam format JSON
- Download video dengan bitrate tertinggi yang tersedia
- Download slideshow (photo post) — tiap gambar disimpan ke folder
- Resolve short URL (`vt.tiktok.com`, `vm.tiktok.com`)
- Auto-fallback ke beberapa endpoint API
- Tidak butuh Puppeteer, browser, atau cookie

---

## Kebutuhan

- Node.js 18+
- npm

---

## Instalasi

```bash
npm install axios axios-cookiejar-support axios-retry tough-cookie
```

---

## Penggunaan

```bash
node tiktok.js <url>
```

### Download video ke storage
```bash
# disimpan sebagai <videoId>.mp4
node tiktok.js <url> -d

# nama file custom
node tiktok.js <url> -d video.mp4
```

### Download slideshow
```bash
# gambar disimpan ke folder ./<videoId>/
node tiktok.js <url> -d

# nama folder custom
node tiktok.js <url> -d nama-folder
```

### Verbose mode
```bash
node tiktok.js <url> -v
node tiktok.js <url> -d -v
```

---

## Contoh Output


### Download video
![contoh download video](https://lockerku.bond/i/fhmd0iah)

### Download slideshow
![contoh download slideshow](https://lockerku.bond/i/4ffx0aqo)

---

## Catatan

- URL video expire setelah beberapa jam — fetch ulang kalau mau download belakangan
- TikTok bisa rate-limit kalau terlalu banyak request — tambahin delay kalau scraping massal
- Video private dan konten yang di-region-lock akan return error

---

## Lisensi

MIT — credit dihargai, jangan hapus header author di `tiktok.js`.