# IrengCloud Universal API Suite

Platform REST API gratis & serbaguna yang mencakup Database Hadits Digital 9 Imam (dengan pencarian SQLite FTS5), Layanan Islami (Jadwal Sholat Indonesia, Khutbah MUI, Wirid/Ratib/Hizib, Doa Islami, & Arsip Dokumen NU), Transliterasi Aksara Jawa Native, serta Multi-Platform Media Extractor (Instagram, Facebook, Threads, YouTube, Twitter/X, TikTok, Mediafire).

- **Base URL**: `https://apiku.irengcloud.com`
- **Auth**: Tidak diperlukan (open access)
- **Version**: 1.2.0
- **Format**: JSON
- **Semua path di bawah diawali Base URL**

> Cara pakai: GET `https://apiku.irengcloud.com/api/v1/hadits/search?q=puasa`

---

## Anime & Streaming

### `GET /api/v1/animasu/home`
Mengambil daftar anime sedang tayang (ongoing) dan baru ditambah dari Animasu.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `page` | query | tidak | 1 | Nomor halaman |

**Contoh request:**
```
GET /api/v1/animasu/home?page=1
```

### `GET /api/v1/anichin/home`
Mengambil daftar rilis Donghua terbaru dan serial ongoing dari AniChin.

**Contoh request:**
```
GET /api/v1/anichin/home
```

### `GET /api/v1/anichin/search`
Mencari judul Donghua Subtitle Indonesia di catalog AniChin.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `q` | query | ya | soul land | Judul Donghua |

**Contoh request:**
```
GET /api/v1/anichin/search?q=soul%20land
```

### `GET /api/v1/anichin/detail`
Mengambil metadata lengkap Donghua, sinopsis, genre, dan 100+ daftar episode.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `slug` | query | ya | soul-land-2-the-unrivaled-tang-sect | Slug Donghua |

**Contoh request:**
```
GET /api/v1/anichin/detail?slug=soul-land-2-the-unrivaled-tang-sect
```

### `GET /api/v1/anichin/episode`
Dekode otomatis iframe player streaming & mirror server (OK.ru, Premium, Drive, dll).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `slug` | query | ya | soul-land-2-the-unrivaled-tang-sect-episode-164-subtitle-indonesia | Slug episode Donghua |

**Contoh request:**
```
GET /api/v1/anichin/episode?slug=soul-land-2-the-unrivaled-tang-sect-episode-164-subtitle-indonesia
```

### `GET /api/v1/animasu/search`
Mencari judul anime di katalog Animasu.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `q` | query | ya | naruto | Judul anime |

**Contoh request:**
```
GET /api/v1/animasu/search?q=naruto
```

### `GET /api/v1/animasu/detail`
Mengambil metadata lengkap anime, sinopsis, rating, dan daftar episode.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `slug` | query | ya | one-piece-gyojin-tou-hen | Slug anime |

**Contoh request:**
```
GET /api/v1/animasu/detail?slug=one-piece-gyojin-tou-hen
```

### `GET /api/v1/animasu/episode`
Mengambil iframe player streaming & mirror server episode anime.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `slug` | query | ya | one-piece-gyojin-tou-hen-episode-1-sub-indo | Slug episode |

**Contoh request:**
```
GET /api/v1/animasu/episode?slug=one-piece-gyojin-tou-hen-episode-1-sub-indo
```

### `GET /api/v1/otakudesu/home`
Mengambil daftar anime ongoing & completed terbaru dari Otakudesu.

**Contoh request:**
```
GET /api/v1/otakudesu/home
```

### `GET /api/v1/otakudesu/schedule`
Mengambil jadwal rilis anime harian (Senin - Minggu) dari Otakudesu.

**Contoh request:**
```
GET /api/v1/otakudesu/schedule
```

### `GET /api/v1/otakudesu/search`
Mencari judul anime Subtitle Indonesia di catalog Otakudesu.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `q` | query | ya | one piece | Judul anime |

**Contoh request:**
```
GET /api/v1/otakudesu/search?q=one%20piece
```

### `GET /api/v1/otakudesu/detail`
Mengambil metadata lengkap anime, skor, produser, studio, sinopsis, dan daftar episode.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `slug` | query | ya | 1piece-sub-indo | Slug anime Otakudesu |

**Contoh request:**
```
GET /api/v1/otakudesu/detail?slug=1piece-sub-indo
```

### `GET /api/v1/otakudesu/episode`
Mengambil iframe player default dan daftar mirror server streaming per episode.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `slug` | query | ya | wpoiec-episode-1178-sub-indo | Slug episode Otakudesu |

**Contoh request:**
```
GET /api/v1/otakudesu/episode?slug=wpoiec-episode-1178-sub-indo
```

---

## Informasi & Cuaca

### `GET /api/v1/checkhost/ip-info`
Mengambil lokasi geografis, ASN, ISP, timezone, dan kordinat IP/Domain.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `host` | query | tidak | google.com | Domain atau IP target |

**Contoh request:**
```
GET /api/v1/checkhost/ip-info?host=google.com
```

### `GET /api/v1/checkhost/ping`
Melakukan uji ping ke target dari puluhan server monitoring global.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `host` | query | tidak | google.com | Domain atau IP target |

**Contoh request:**
```
GET /api/v1/checkhost/ping?host=google.com
```

### `GET /api/v1/checkhost/whois`
Mengambil catatan registrasi domain / IP dari database WHOIS resmi.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `domain` | query | tidak | google.com | Domain atau IP target |

**Contoh request:**
```
GET /api/v1/checkhost/whois?domain=google.com
```

### `GET /api/v1/bmkg/gempa`
Data gempa bumi terbaru M 5.0+, potensi tsunami, dan peta guncangan (shakemap) dari BMKG.

**Contoh request:**
```
GET /api/v1/bmkg/gempa
```

### `GET /api/v1/bmkg/gempa-dirasakan`
Daftar gempa bumi terbaru yang dirasakan masyarakat dari BMKG.

**Contoh request:**
```
GET /api/v1/bmkg/gempa-dirasakan
```

### `GET /api/v1/bmkg/cuaca`
Prakiraan cuaca presisi tingkat desa/kelurahan dari server resmi BMKG Indonesia.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `adm4` | query | tidak | 31.71.01.1001 | Kode kelurahan/desa adm4 |

**Contoh request:**
```
GET /api/v1/bmkg/cuaca?adm4=31.71.01.1001
```

### `GET /api/v1/tv/channels`
Mengambil seluruh daftar ID channel TV nasional Indonesia dari JadwalTV.net.

**Contoh request:**
```
GET /api/v1/tv/channels
```

### `GET /api/v1/tv/schedule`
Mengambil susunan jadwal jam tayang acara TV berdasarkan ID channel (RCTI, TransTV, SCTV, Indosiar, dll).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `channel` | query | ya | rcti | ID channel TV |

**Contoh request:**
```
GET /api/v1/tv/schedule?channel=rcti
```

### `GET /api/v1/tv/now`
Mengambil daftar acara yang sedang tayang di seluruh stasiun TV nasional saat ini secara realtime.

**Contoh request:**
```
GET /api/v1/tv/now
```

### `GET /api/v1/tv/football`
Mengambil jadwal siaran langsung pertandingan sepakbola liga dunia di TV nasional & streaming.

**Contoh request:**
```
GET /api/v1/tv/football
```

### `GET /api/v1/kci/stations`
Mengambil seluruh daftar kode & nama stasiun KRL Commuter Line (Jabodetabek, Jogja-Solo, Merak).

**Contoh request:**
```
GET /api/v1/kci/stations
```

### `GET /api/v1/kci/schedules`
Mengambil jadwal lengkap jam keberangkatan KRL dari stasiun asal (contoh: BOO, MRI, JAKK, CKR).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `stationId` | query | ya | BOO | Kode stasiun KRL |
| `timeFrom` | query | tidak | 06:00 | Batas awal jam |
| `timeTo` | query | tidak | 22:00 | Batas akhir jam |

**Contoh request:**
```
GET /api/v1/kci/schedules?stationId=BOO&timeFrom=06%3A00&timeTo=22%3A00
```

### `GET /api/v1/kci/route`
Mengambil seluruh stasiun perhentian & estimasi jam tiba untuk nomor kereta KRL tertentu.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `trainId` | query | ya | 1009 | Nomor KA KRL |

**Contoh request:**
```
GET /api/v1/kci/route?trainId=1009
```

### `GET /api/v1/enka/profile/1810139094`
Mengekstrak profil player, nickname, level, achievement, list karakter showcase, artefak, dan weapon dari Enka Network berdasarkan UID.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `uid` | path | ya | 1810139094 | UID Genshin Impact / Star Rail |

**Contoh request:**
```
GET /api/v1/enka/profile/1810139094
```

### `GET /api/v1/tempmail/create`
Membuat alamat email sementara instan (via Mail.tm) lengkap dengan password untuk verifikasi akun.

**Contoh request:**
```
GET /api/v1/tempmail/create
```

### `GET /api/v1/tempmail/messages`
Mengekstrak daftar pesan/OTP yang masuk ke alamat email tempmail.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `email` | query | ya | — | Email tempmail |
| `password` | query | ya | — | Password tempmail |

**Contoh request:**
```
GET /api/v1/tempmail/messages
```

### `POST /api/v1/upload`
Mengunggah file/gambar (Cloudflare R2 storage / fallback local) dan menghasilkan direct URL publik.

**Contoh request:**
```
POST /api/v1/upload
```

### `GET /api/v1/bing-image`
Generate 4 gambar AI via Bing Image Creator hanya dengan parameter prompt. Cookie Bing diambil otomatis dari server (env BING_COOKIE).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `prompt` | query | ya | — | Deskripsi gambar yang ingin dibuat |

**Contoh request:**
```
GET /api/v1/bing-image
```

### `GET /api/v1/stats`
Mengekstrak data statistik publik server (uptime, memori RSS/heap, load average, versi Node.js, & CPU cores).

**Contoh request:**
```
GET /api/v1/stats
```

---

## Manga & Komik

### `GET /api/v1/komiku/home`
Mengambil daftar komik rekomendasi/ranking dan terbitan terbaru dari Komiku.org.

**Contoh request:**
```
GET /api/v1/komiku/home
```

### `GET /api/v1/komiku/detail`
Mengambil metadata komik, pengarang, genre, sinopsis, dan 400+ daftar chapter.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `slug` | query | ya | tomb-raider-king | Slug komik |

**Contoh request:**
```
GET /api/v1/komiku/detail?slug=tomb-raider-king
```

### `GET /api/v1/komiku/chapter`
Mengambil seluruh URL gambar halaman chapter komik lengkap dengan URL proxy anti-403 hotlink.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `slug` | query | ya | tomb-raider-king-chapter-411 | Slug chapter komik |

**Contoh request:**
```
GET /api/v1/komiku/chapter?slug=tomb-raider-king-chapter-411
```

### `GET /api/v1/komiku/proxy-image`
Streaming gambar halaman komik dari img.komiku.org secara langsung dengan injection Referer valid (Bypass 403 Forbidden).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://img.komiku.org/upload5/tomb-raider-king/411/2026-05-28/1.png | URL gambar dari img.komiku.org |

**Contoh request:**
```
GET /api/v1/komiku/proxy-image?url=https%3A%2F%2Fimg.komiku.org%2Fupload5%2Ftomb-raider-king%2F411%2F2026-05-28%2F1.png
```

---

## Hadits Digital 9 Imam

### `GET /api/v1/hadits/books`
Mendapatkan statistik total hadits dari 9 perawi imam (Bukhari, Muslim, Abu Daud, Tirmidzi, Nasai, Ibnu Majah, Ahmad, Malik, Darimi).

**Contoh request:**
```
GET /api/v1/hadits/books
```

### `GET /api/v1/hadits/search`
Pencarian cepat kata kunci pada teks terjemahan hadits menggunakan mesin SQLite Full-Text Search (FTS5).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `q` | query | ya | niat | Kata kunci pencarian terjemahan hadits |
| `page` | query | tidak | 1 | Nomor halaman |
| `limit` | query | tidak | 5 | Jumlah data per halaman |

**Contoh request:**
```
GET /api/v1/hadits/search?q=niat&page=1&limit=5
```

### `GET /api/v1/hadits/{imam}/{number}`
Mengambil detail spesifik hadits beserta bab, kitab, dan terjemahan berdasarkan perawi imam dan nomor hadits.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `imam` | path | ya | bukhari | Nama perawi imam |
| `number` | path | ya | 1 | Nomor urut hadits |

**Contoh request:**
```
GET /api/v1/hadits/bukhari/1
```

### `GET /api/v1/hadits/{imam}`
Mendapatkan daftar hadits per perawi imam secara berurutan dengan fitur paginasi (limit & page).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `imam` | path | ya | muslim | Nama perawi imam |
| `page` | query | tidak | 1 | Nomor halaman |
| `limit` | query | tidak | 5 | Jumlah data per halaman |

**Contoh request:**
```
GET /api/v1/hadits/muslim?page=1&limit=5
```

---

## Layanan Islami

### `GET /api/v1/sholat/jadwal`
Mengambil jadwal sholat lengkap (Imsak, Subuh, Terbit, Dhuha, Dzuhur, Ashar, Maghrib, Isya) berdasarkan kota/kabupaten di Indonesia.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `kota` | query | ya | Jakarta Pusat | Nama atau ID kota |
| `bulan` | query | tidak | 8 | Bulan jadwal (1-12) |
| `tahun` | query | tidak | 2026 | Tahun jadwal |

**Contoh request:**
```
GET /api/v1/sholat/jadwal?kota=Jakarta%20Pusat&bulan=8&tahun=2026
```

### `GET /api/v1/sholat/kota`
Mendapatkan seluruh daftar ID kota di Indonesia beserta opsi pencarian berdasarkan nama kota.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `q` | query | tidak | Bandung | Nama kota untuk filter |

**Contoh request:**
```
GET /api/v1/sholat/kota?q=Bandung
```

### `GET /api/v1/quran/surat`
Mendapatkan daftar seluruh 114 surah Al-Qur’an lengkap dengan nama Arab, Latin, terjemahan, jumlah ayat, dan nomor urut.

**Contoh request:**
```
GET /api/v1/quran/surat
```

### `GET /api/v1/quran/surat/{nomor}`
Mendapatkan isi satu surah lengkap dengan teks Arab, latin, terjemahan, audio per ayat, dan informasi surah.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `nomor` | path | ya | 1 | Nomor surah (1-114) |

**Contoh request:**
```
GET /api/v1/quran/surat/1
```

### `GET /api/v1/quran/tafsir/{nomor}`
Mendapatkan tafsir ayat-ayat suatu surah dari Kementerian Agama RI.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `nomor` | path | ya | 1 | Nomor surah (1-114) |

**Contoh request:**
```
GET /api/v1/quran/tafsir/1
```

### `GET /api/v1/quran/search`
Mencari ayat Al-Qur’an berdasarkan kata kunci di terjemahan Bahasa Indonesia, dengan teks Arab + terjemahan dan paginasi.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `q` | query | ya | rahmat | Kata kunci pencarian ayat |
| `page` | query | tidak | 1 | Nomor halaman hasil pencarian |
| `size` | query | tidak | 10 | Jumlah hasil per halaman (1-50) |

**Contoh request:**
```
GET /api/v1/quran/search?q=rahmat&page=1&size=10
```

### `GET /api/v1/khutbah`
Mendapatkan daftar artikel naskah Khutbah Jumat & Idul Fitri resmi terbaru dari Majelis Ulama Indonesia (MUI).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `page` | query | tidak | 1 | Nomor halaman |
| `limit` | query | tidak | 20 | Jumlah data per halaman |

**Contoh request:**
```
GET /api/v1/khutbah?page=1&limit=20
```

### `GET /api/v1/khutbah/detail`
Mengambil isi teks naskah lengkap artikel khutbah berdasarkan URL naskah MUI.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://mui.or.id/baca/khutbah/khutbah-jumat-mewaspadai-virus-takabur | URL artikel khutbah MUI |

**Contoh request:**
```
GET /api/v1/khutbah/detail?url=https%3A%2F%2Fmui.or.id%2Fbaca%2Fkhutbah%2Fkhutbah-jumat-mewaspadai-virus-takabur
```

### `GET /api/v1/wirid`
Kumpulan teks bacaan Wirid Harian, Ratib (al-Haddad, al-Athas), Hizib, Shalawat, Istighotsah, dan Asmaul Husna lengkap teks Arab & Terjemahan.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `category` | query | tidak | ratib | Kategori bacaan wirid |

**Contoh request:**
```
GET /api/v1/wirid?category=ratib
```

### `GET /api/v1/doa`
Kumpulan doa keseharian, doa rezeki, tolak bala, kesehatan, doa para nabi, pernikahan, dan doa shalat lengkap teks Arab & Terjemahan.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `category` | query | tidak | doa-keseharian | Kategori doa islami |

**Contoh request:**
```
GET /api/v1/doa?category=doa-keseharian
```

### `GET /api/v1/maulid`
Kumpulan teks bacaan Kitab Maulid Nabi (Diba'i, Barzanji, Syarafil Anam, Simthud Durar, Burdah, Adl-Dliyaul Lami', Maulid 'Azab) lengkap teks Arab, Latin, dan Terjemahan dari NU Online.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `category` | query | tidak | maulid-dibai | Slug kitab maulid yang ingin dibaca |

**Contoh request:**
```
GET /api/v1/maulid?category=maulid-dibai
```

### `GET /api/v1/maulid/books`
Mendapatkan daftar 7 Kitab Maulid Nabi yang tersedia di NU Online beserta pengarang dan total bacaan.

**Contoh request:**
```
GET /api/v1/maulid/books
```

### `GET /api/v1/tahlil`
Susunan lengkap 56 bacaan Tahlil dan Doa Tahlil/Arwah NU Online dilengkapi teks Arab, transliterasi Latin, dan terjemahan bahasa Indonesia.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `number` | query | tidak | — | Filter langsung ke nomor urut bacaan tahlil (1-56) |
| `page` | query | tidak | 1 | Nomor halaman |
| `limit` | query | tidak | 56 | Jumlah data per halaman |

**Contoh request:**
```
GET /api/v1/tahlil?page=1&limit=56
```

### `GET /api/v1/tahlil/{number}`
Mendapatkan satu butir bacaan tahlil spesifik berdasarkan nomor urut (1-56).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `number` | path | ya | 1 | Nomor butir bacaan tahlil (1-56) |

**Contoh request:**
```
GET /api/v1/tahlil/1
```

### `GET /api/v1/nu-download`
Mengunduh dokumen resmi, buku/kitab, amaliyah, produk hukum (fatwa/bahtsul masail), serta audio mars & himne NU Online (MP3/PDF).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `category` | query | tidak | lagu-mars-dan-himne | Kategori arsip NU Online |
| `q` | query | tidak | pmii | Filter pencarian dokumen |

**Contoh request:**
```
GET /api/v1/nu-download?category=lagu-mars-dan-himne&q=pmii
```

---

## Budaya & Aksara

### `GET /api/v1/aksara/latin-to-jawa`
Transliterasi teks Latin ke Aksara Jawa native (sub-millisecond latency) lengkap dengan opsi Sandhangan & Aksara Murda.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `text` | query | ya | sugeng enjang | Teks Latin yang akan dikonversi |
| `murda` | query | tidak | false | Aktifkan Aksara Murda |

**Contoh request:**
```
GET /api/v1/aksara/latin-to-jawa?text=sugeng%20enjang&murda=false
```

### `GET /api/v1/aksara/jawa-to-latin`
Mengubah teks Unicode Aksara Jawa kembali menjadi alfabet Latin secara instan.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `text` | query | ya | ꦱꦸꦒꦼꦁ ꦲꦺꦤ꧀ꦗꦁ | Teks Aksara Jawa yang akan dikonversi |

**Contoh request:**
```
GET /api/v1/aksara/jawa-to-latin?text=%EA%A6%B1%EA%A6%B8%EA%A6%92%EA%A6%BC%EA%A6%81%20%EA%A6%B2%EA%A6%BA%EA%A6%A4%EA%A7%80%EA%A6%97%EA%A6%81
```

---

## Lirik Musik

### `GET /api/v1/lirik/search`
Mencari lirik lagu berdasarkan kata kunci bebas atau judul/artis/album spesifik. Mengembalikan daftar lagu beserta lirik plain dan time-synced (LRC).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `q` | query | tidak | shalawat | Kata kunci bebas (judul/artis/album) |
| `judul` | query | tidak | — | Filter judul lagu spesifik |
| `artis` | query | tidak | — | Filter nama artis spesifik |
| `album` | query | tidak | — | Filter nama album |

**Contoh request:**
```
GET /api/v1/lirik/search?q=shalawat
```

### `GET /api/v1/lirik`
Mengambil lirik (plain + time-synced LRC) untuk lagu spesifik berdasarkan judul dan artis. Akurasi meningkat dengan album & durasi.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `judul` | query | ya | Bohemian Rhapsody | Judul lagu |
| `artis` | query | ya | Queen | Nama artis |
| `album` | query | tidak | — | Nama album (opsional) |
| `durasi` | query | tidak | 354 | Durasi lagu dalam detik (tingkatkan akurasi) |

**Contoh request:**
```
GET /api/v1/lirik?judul=Bohemian%20Rhapsody&artis=Queen&durasi=354
```

---

## Data Pendidikan

### `GET /api/v1/pddikti`
Menampilkan informasi ringkas dan daftar endpoint yang tersedia untuk mengakses data publik PDDIKTI Kemdiktisaintek.

**Contoh request:**
```
GET /api/v1/pddikti
```

### `GET /api/v1/pddikti/search`
Mencari data mahasiswa, dosen, perguruan tinggi, dan program studi di PDDIKTI berdasarkan kata kunci.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `q` | query | ya | Universitas Indonesia | Kata kunci pencarian PDDIKTI |
| `tipe` | query | tidak | all | Batasi hasil berdasarkan tipe data |

**Contoh request:**
```
GET /api/v1/pddikti/search?q=Universitas%20Indonesia&tipe=all
```

### `GET /api/v1/pddikti/mahasiswa/{id}`
Mengambil detail mahasiswa menggunakan encrypted ID yang diperoleh dari hasil pencarian PDDIKTI.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `id` | path | ya | — | Encrypted ID mahasiswa dari endpoint pencarian |

**Contoh request:**
```
GET /api/v1/pddikti/mahasiswa/<id>
```

### `GET /api/v1/pddikti/detail/{tipe}/{id}`
Mengambil detail entitas PDDIKTI berdasarkan tipe data dan encrypted ID dari hasil pencarian.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `tipe` | path | ya | mhs | Tipe entitas PDDIKTI |
| `id` | path | ya | — | Encrypted ID entitas dari endpoint pencarian |

**Contoh request:**
```
GET /api/v1/pddikti/detail/mhs/<id>
```

### `GET /api/v1/pddikti/sub/{tipe}/{data_type}/{id}`
Mengambil kelompok data lanjutan suatu entitas PDDIKTI berdasarkan tipe entitas, jenis subdata, dan encrypted ID.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `tipe` | path | ya | pt | Tipe entitas PDDIKTI yang menyediakan subdata |
| `data_type` | path | ya | jumlah-mahasiswa | Jenis subdata yang tersedia untuk tipe entitas terpilih |
| `id` | path | ya | — | Encrypted ID entitas dari endpoint pencarian |

**Contoh request:**
```
GET /api/v1/pddikti/sub/pt/jumlah-mahasiswa/<id>
```

---

## Media Downloader

### `GET /api/v1/pinterest`
Mengekstrak URL media gambar beresolusi tinggi (736x) dan video HD dari pin Pinterest.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://pin.it/4H3j456 | URL lengkap yang ingin diekstrak |

**Contoh request:**
```
GET /api/v1/pinterest?url=https%3A%2F%2Fpin.it%2F4H3j456
```

### `GET /api/v1/instagram`
Mengekstrak URL media beresolusi tinggi (foto, video, reels, carousel) dari postingan Instagram.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://www.instagram.com/p/DFzL1234567/ | URL lengkap yang ingin diekstrak |

**Contoh request:**
```
GET /api/v1/instagram?url=https%3A%2F%2Fwww.instagram.com%2Fp%2FDFzL1234567%2F
```

### `GET /api/v1/fbdl`
Mengekstrak link unduhan video HD dan SD langsung dari postingan/watch Facebook.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://www.facebook.com/watch/?v=123456789 | URL lengkap yang ingin diekstrak |

**Contoh request:**
```
GET /api/v1/fbdl?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3D123456789
```

### `GET /api/v1/threads`
Mengekstrak media foto dan video dari postingan Meta Threads tanpa login wall.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://www.threads.net/@user/post/DFzL1234567 | URL lengkap yang ingin diekstrak |

**Contoh request:**
```
GET /api/v1/threads?url=https%3A%2F%2Fwww.threads.net%2F%40user%2Fpost%2FDFzL1234567
```

### `GET /api/v1/ytdl`
Mengonversi video/Shorts YouTube ke format MP3 (Audio) atau MP4 (Video) via YTMP3.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://youtu.be/dQw4w9WgXcQ | URL lengkap yang ingin diekstrak |
| `format` | query | tidak | mp4 | Pilihan format keluaran (mp3 atau mp4) |

**Contoh request:**
```
GET /api/v1/ytdl?url=https%3A%2F%2Fyoutu.be%2FdQw4w9WgXcQ&format=mp4
```

### `GET /api/v1/ytdl2`
Mengonversi video/Shorts YouTube ke format MP4 HD (Engine 2 / Loader.to).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://youtu.be/dQw4w9WgXcQ | URL lengkap yang ingin diekstrak |
| `quality` | query | tidak | 720 | Resolusi video yang diminta |

**Contoh request:**
```
GET /api/v1/ytdl2?url=https%3A%2F%2Fyoutu.be%2FdQw4w9WgXcQ&quality=720
```

### `GET /api/v1/ytdl3`
Mengonversi video/Shorts YouTube ke format MP4 (Engine 3 / 4KDownload).

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://youtu.be/dQw4w9WgXcQ | URL lengkap yang ingin diekstrak |
| `quality` | query | tidak | 720 | Resolusi video yang diminta |

**Contoh request:**
```
GET /api/v1/ytdl3?url=https%3A%2F%2Fyoutu.be%2FdQw4w9WgXcQ&quality=720
```

### `GET /api/v1/twitter`
Mengekstrak foto dan video beresolusi tinggi dari Tweet Twitter/X via public syndication.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://x.com/jack/status/20 | URL lengkap yang ingin diekstrak |

**Contoh request:**
```
GET /api/v1/twitter?url=https%3A%2F%2Fx.com%2Fjack%2Fstatus%2F20
```

### `GET /api/v1/tiktok`
Mengekstrak URL video HD tanpa watermark, audio MP3, dan thumbnail dari video TikTok.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://vt.tiktok.com/ZSY123456/ | URL lengkap yang ingin diekstrak |

**Contoh request:**
```
GET /api/v1/tiktok?url=https%3A%2F%2Fvt.tiktok.com%2FZSY123456%2F
```

### `GET /api/v1/tiktok2`
Mengekstrak URL video HD tanpa watermark, audio MP3, statistik, dan info author dari video TikTok via Snaptik.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://www.tiktok.com/@oppacoinsurabaya/video/7653693032440663314 | URL lengkap yang ingin diekstrak |

**Contoh request:**
```
GET /api/v1/tiktok2?url=https%3A%2F%2Fwww.tiktok.com%2F%40oppacoinsurabaya%2Fvideo%2F7653693032440663314
```

### `POST /api/v1/tiktok2`
Mengekstrak URL video HD tanpa watermark, audio MP3, statistik, dan info author dari video TikTok via Snaptik.

**Contoh request:**
```
POST /api/v1/tiktok2
```

### `GET /api/v1/mediafire`
Mengekstrak direct download link serta ukuran file langsung dari halaman Mediafire.

| Parameter | Lokasi | Wajib | Default | Keterangan |
|---|---|---|---|---|
| `url` | query | ya | https://www.mediafire.com/file/example/file.zip/file | URL lengkap yang ingin diekstrak |

**Contoh request:**
```
GET /api/v1/mediafire?url=https%3A%2F%2Fwww.mediafire.com%2Ffile%2Fexample%2Ffile.zip%2Ffile
```

---