oppadrama-api
REST API scraper untuk OPPADRAMA — drama Korea/China/Thailand/Jepang,
series, anime, variety show, dan film subtitle Indonesia.
Menyediakan metadata lengkap (judul alternatif, sinopsis, cast, sutradara, genre,
rating, status, negara, jaringan TV), daftar episode, server streaming HLS
(1080p / 720p / 480p) yang siap diputar di hls.js / Video.js, link download,
pencarian, dan seluruh arsip taksonomi.
pip install -r requirements.txt
python -m oppadrama_api.app
# -> http://127.0.0.1:5000/docs
⚠️ Proyek edukasi. API ini tidak menghosting konten apa pun. Semua data
dibaca dari halaman publik oppadrama.io dan tautan streaming dimiliki pihak
ketiga. Gunakan dengan bijak dan hormati situs sumber.
Daftar endpoint
| Method | Path | Isi |
|---|
| GET | / | Daftar endpoint |
| GET | /health | Status layanan & cache |
| GET | /docs | Dokumentasi Swagger UI |
| GET | /player | Halaman uji pemutaran HLS di browser |
| GET | /openapi.json | Skema OpenAPI 3.0 |
| GET | /home?page=1 | Beranda: rilis terbaru, rekomendasi, sidebar |
| GET | /home/{section} | Satu bagian beranda (ongoing, recommendation, newseries, latest) |
| GET | /series | Daftar series + filter (status, tipe, genre, negara, musim, studio, network, urutan) |
| GET | /series/filters | Semua opsi filter yang tersedia |
| GET | /series/latest?page=1 | Rilisan episode terbaru |
| GET | /series/list?page=1 | Daftar A–Z (mode teks) |
| GET | /series/{slug} | Detail series lengkap |
| GET | /series/{slug}/episodes | Daftar episode satu series |
| GET | /episode/{slug} | Detail episode + seluruh server mirror + link download |
| GET | /episode/{slug}/stream | Stream HLS siap putar untuk server terpilih |
| GET | /stream?url= | Resolusi embed vidara → info stream |
| GET | /stream/playlist?u= | Proxy playlist HLS (semua URI diarahkan ulang) |
| GET | /stream/seg?u= | Relay byte segmen/subtitle (Range diteruskan) |
| GET | /search?q= | Cari drama / series / film |
| GET | /genres | Semua genre + jumlah judul |
| GET | /genre/{slug} | Series per genre |
| GET | /country/{slug} | Series per negara |
| GET | /cast/{slug} | Series per pemain |
| GET | /director/{slug} | Series per sutradara |
| GET | /tag/{slug} | Series per tag |
| GET | /network/{slug} | Series per jaringan TV |
| GET | /season/{slug} | Series per musim |
| GET | /studio/{slug} | Series per studio |
| GET | /domains | Info domain aktif & kandidat cadangan |
Section beranda: ongoing (Sedang Tayang), recommendation (Rekomendasi per genre),
newseries (Judul Drama/Series Baru), latest (Rilisan Terbaru).
Contoh
Beranda
curl 'http://127.0.0.1:5000/home'
curl 'http://127.0.0.1:5000/home/ongoing'
Cari & detail
curl 'http://127.0.0.1:5000/search?q=deception'
curl 'http://127.0.0.1:5000/series/100-days-of-deception'
curl 'http://127.0.0.1:5000/series/100-days-of-deception/episodes'
curl 'http://127.0.0.1:5000/episode/100-days-of-deception-episode-4'
Filter katalog
# Drama Korea yang sedang tayang, urut terbaru
curl 'http://127.0.0.1:5000/series?country=south-korea&status=ongoing&order=update'
# Beberapa genre sekaligus
curl 'http://127.0.0.1:5000/series?genre=action&genre=romance&type=drama'
Memutar streaming
Satu langkah — ambil stream siap pakai:
curl 'http://127.0.0.1:5000/episode/100-days-of-deception-episode-4/stream'
Respons memuat data.masterProxyUrl (playlist master lewat proxy API) dan
data.qualities[] dengan proxyUrl per kualitas. Tunjuk masterProxyUrl atau
proxyUrl mana pun langsung ke hls.js:
<script src="https://cdn.jsdelivr.net/npm/hls.js@1"></script>
<video id="v" controls></video>
<script>
const src = "http://127.0.0.1:5000" + data.masterProxyUrl; // dari response API
const video = document.getElementById("v");
if (Hls.isSupported()) {
const hls = new Hls();
hls.loadSource(src);
hls.attachMedia(video);
} else {
video.src = src; // Safari/iOS native HLS
}
</script>
Pilih server lain bila ada beberapa mirror:
curl 'http://127.0.0.1:5000/episode/100-days-of-deception-episode-4/stream?server=2'
Atau resolusi manual dari URL embed:
curl 'http://127.0.0.1:5000/stream?url=https://vidara.to/e/2gxTamNdmrlOo'
Uji langsung di browser
Buka http://127.0.0.1:5000/player, masukkan slug episode, klik Muat Stream.
Halaman itu memakai hls.js dan memutar lewat endpoint proxy API yang sama —
cara tercepat memastikan hasil scraping benar-benar bisa diputar.
Kenapa perlu proxy? Playlist HLS dari CDN penyedia membawa token yang terikat
ke alamat IP pemanggil dan bisa menolak permintaan lintas-origin. Endpoint
/stream/playlist dan /stream/seg meneruskan permintaan dengan Referer yang
benar, menulis ulang setiap URI di playlist agar menunjuk kembali ke API, dan
meneruskan header Range, sehingga hasilnya dapat diputar dari mana saja.
Format respons
Semua endpoint mengembalikan JSON dengan pembungkus konsisten:
{ "success": true, "data": { "...": "..." } }
Error:
{ "success": false, "message": "Series tidak ditemukan", "hint": "..." }
Kode status: 400 parameter tidak valid, 404 slug tidak ada, 502 upstream gagal.
Ringkasan bentuk data
Kartu (/home, /series, /search, arsip):
{
"title": "100 Days of Deception",
"slug": "100-days-of-deception",
"url": "https://oppadrama.io/series/100-days-of-deception/",
"type": "Drama",
"poster": "https://i2.wp.com/...jpg",
"episode": null,
"episodeLabel": "Ongoing",
"sub": "Sub",
"status": "Ongoing",
"updatedAgo": "6 hours lalu",
"movieId": "6835"
}
Detail series (/series/{slug}) menambahkan altTitle, synopsis,
description, genres, tags, rating {value,count}, meta (status, network,
country, director, cast, totalEpisodes, duration, released, updated), dan
episodes[].
Detail episode (/episode/{slug}):
{
"title": "100 Days of Deception Episode 4",
"type": "Drama",
"series": { "title": "100 Days of Deception", "slug": "100-days-of-deception" },
"mirrors": [
{ "name": "vidara.to", "host": "vidara.to",
"embed": "https://vidara.to/e/2gxTamNdmrlOo", "index": 1 }
],
"downloads": [
{ "server": "Buzzheavier", "quality": "FHD 1080p",
"url": "https://buzzheavier.com/gqo6ykb3oo3x" }
],
"prev": "https://oppadrama.io/...episode-3/",
"next": null
}
Stream (/episode/{slug}/stream, /stream):
{
"filecode": "2gxTamNdmrlOo",
"streamingUrl": "https://s13-....com/hls/.../master.m3u8?token=...",
"isMaster": true,
"qualityLabels": ["1080p", "720p", "480p"],
"masterProxyUrl": "/api/oppadrama-api/stream/playlist?u=...",
"qualities": [
{ "label": "1080p", "resolution": "1920x1080", "bandwidth": 2600000,
"url": "https://s13-.../index_1920x1080.m3u8?token=...",
"proxyUrl": "/api/oppadrama-api/stream/playlist?u=..." }
],
"subtitles": [],
"thumbnail": "https://...jpg"
}
Konfigurasi
Lewat environment variable:
| Variabel | Default | Keterangan |
|---|
PORT | 5000 | Port server |
OPPADRAMA_BASE_URL | https://oppadrama.io | Domain upstream |
OPPADRAMA_DOMAINS | https://oppadrama.io | Daftar kandidat domain (dipisah koma) |
OPPADRAMA_TIMEOUT | 25 | Timeout HTTP (detik) |
OPPADRAMA_CACHE_TTL | 300 | TTL cache halaman HTML (detik) |
OPPADRAMA_STREAM_CACHE_TTL | 600 | TTL cache hasil resolusi stream (detik) |
OPPADRAMA_MAX_RETRIES | 3 | Jumlah percobaan ulang |
OPPADRAMA_MAX_PAGE | 500 | Batas nomor halaman |
Cache disimpan di memori (tanpa database) dan dibersihkan otomatis saat entri
kedaluwarsa.
Deployment
Gunicorn
gunicorn -w 4 -b 0.0.0.0:5000 'oppadrama_api.app:app'
Docker
docker build -t oppadrama-api .
docker run -d --name oppadrama-api -p 5000:5000 oppadrama-api
Di belakang gateway (path prefix)
Aplikasi sadar akan SCRIPT_ROOT, jadi bila dipasang di sub-path seperti
/api/oppadrama-api, seluruh URL di dokumentasi dan proxy playlist otomatis
mengikuti prefix tersebut. Contoh Nginx:
location /api/oppadrama-api/ {
proxy_pass http://127.0.0.1:5001/;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Prefix /api/oppadrama-api;
}
Catatan teknis
- Sumber: situs berjalan di WordPress dengan tema Themesia. Struktur yang
dipakai:
article.bs (kartu), .bigcontent .infox (detail series),
.megavid + select.mirror (episode), .eplister (daftar episode).
- Player: setiap episode menyematkan iframe dari
vidara.to. Filecode pada
URL embed dikirim ke POST https://vidara.to/api/stream untuk memperoleh
master HLS bertoken. Resolver menangani host mirror dan fallback otomatis.
- Subtitle diambil dari field
subtitles upstream bila tersedia; saat ini
umumnya kosong.
- Tanpa database, tanpa state — cukup Python 3.9+.
Lisensi
MIT. Proyek edukasi, tidak berafiliasi dengan oppadrama.io.
