🎬 Hoshiyomi API

Unified REST API for Short Drama Streaming

Access 20+ short drama platforms with a single API key.

---

📚 API Documentation • 🤖 Telegram Bot

---

📖 About

Hoshiyomi API is a unified REST API that aggregates content from 20+ short drama streaming platforms into a single, easy-to-use interface.

Why Hoshiyomi API?

• One API, 20+ Platforms — No need to integrate multiple platforms separately
• 16 Languages — Indonesian, English, Korean, Japanese, Chinese, Arabic, and more
• 50,000+ Content — Thousands of dramas across all platforms
• Real-time Documentation — Interactive API explorer with live testing
• WebSocket Monitoring — Real-time rate limit tracking

---

🚀 Quick Start

1. Get Your API Key

Free API Key: Get via Telegram Bot: @dramaboxplusbot

• 10 requests per minute
• 500 requests per day
• Valid for 1 day (renew anytime via the bot)
• Private key (1 per user)

2. Make Your First Request

cURL:

curl -s "https://api.hoshiyomi.my.id/api/dramabox/trending?lang=id" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "User-Agent: Mozilla/5.0"

Python:

import requests

resp = requests.get(
    "https://api.hoshiyomi.my.id/api/dramabox/trending",
    params={"lang": "id"},
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "User-Agent": "Mozilla/5.0"
    }
)
data = resp.json()
for drama in data["items"]:
    print(f"{drama['title']} - {drama['episodes']} episodes")

JavaScript:

const res = await fetch(
  "https://api.hoshiyomi.my.id/api/dramabox/trending?lang=id",
  {
    headers: {
      "X-API-Key": "YOUR_API_KEY",
      "User-Agent": "Mozilla/5.0"
    }
  }
);
const data = await res.json();
console.log(data);

---

📡 API Endpoints

All endpoints: https://api.hoshiyomi.my.id/api/{platform}/{endpoint}

Endpoint	Method	Description	Parameters
/languages	GET	List supported languages	-
/trending	GET	Get trending dramas	lang (opt), page (opt)
/search	GET	Search dramas	q (req), lang (opt), page (opt)
/detail	GET	Get drama details	id (req), lang (opt)
/allepisode	GET	Get all episodes with video	id (req), lang (opt)
/foryou	GET	Personalized recommendations	lang (opt), page (opt)
/recommended	GET	Similar dramas	lang (opt)
/hotrank	GET	Hot rankings	lang (opt)
/latest	GET	Latest dramas	lang (opt), page (opt)

Note: Each platform supports different endpoints. See platform documentation for details.

---

📱 Supported Platforms

Platform	Endpoints	Status
DramaBox V2	12	✅ Active
Melolo	11	✅ Active
Playlet	10	✅ Active
PineDrama	8	✅ Active
FlickReels	8	✅ Active
FreeReels	8	✅ Active
GoodShort	8	✅ Active
DramaBite	8	✅ Active
NetShort	7	✅ Active
ShortMax	7	✅ Active
ReelShort	7	✅ Active
DramaWave	7	✅ Active
iDrama	6	✅ Active
StarShort	6	✅ Active
FlareFlow	6	✅ Active
MoboReels	6	✅ Active
DramaNova	6	✅ Active
iQIYI	5	✅ Active
StardustTV	5	✅ Active
WeTV	5	✅ Active

Access levels: Free keys unlock 11 platforms · 9 premium platforms (marked STARTER+) require the Starter plan or higher.

---

💰 Pricing & Rate Limits

Plan	Price	RPM	Daily Limit	Duration
Free (Personal)	Free	10	500	1 day
Starter	$3/mo	500	15,000	30 days
Starter 3M	$8	500	15,000	90 days
Growth	$8/mo	2,000	50,000	30 days
Growth 3M ★	$20	2,000	50,000	90 days
Pro	$15/mo	10,000	200,000	30 days
Pro 3M	$38	10,000	200,000	90 days
Business	$25/mo	30,000	500,000	30 days
Business 3M	$63	30,000	500,000	90 days
Enterprise	Custom	Custom	Custom	Contact Us

Payment Methods (via Telegram Bot):

• 🇮🇩 QRIS — pay instantly from any Indonesian e-wallet/banking app (auto-delivered after payment)
• 💲 USDT (OKX Direct) — no fee, 3 networks (TRC20/ERC20/Solana)
• 🪙 Binance Pay — crypto payment
• 💳 Card / Other Crypto — via NOWPayments

---

🤖 Telegram Bot

Get API keys via @dramaboxplusbot

Features:

• 🆓 Free personal keys (10 RPM, 500/day, 1 day)
• 💳 Paid plans with QRIS, USDT (OKX), Binance Pay & crypto
• 🔄 Auto-delivery after payment confirmation
• 📊 Real-time rate limit monitoring
• 🌐 Multi-language support (EN/ID)

---

🔑 Key Formats

Format	Example	Description
Personal	HOSHIYOMI-FREE-xxxxxxxx	Free key, 10 RPM, 1 day
Paid	HOSHIYOMI-PRE-xxxxxxxx	Paid key, 500-30K RPM

---

❌ Error Codes

Code	Description
400	Bad Request — Invalid parameters
401	Unauthorized — Invalid or missing API key
403	Forbidden — API key expired or suspended
404	Not Found — Endpoint or resource not found
429	Too Many Requests — Rate limit exceeded
500	Internal Server Error

---

🌍 Language Support

Code	Language	Code	Language
id	Indonesian	ko	Korean
en	English	ja	Japanese
ms	Malay	zh	Chinese
th	Thai	ar	Arabic
vi	Vietnamese	fr	French
de	German	es	Spanish
pt	Portuguese	tr	Turkish
hi	Hindi	fil	Filipino

---

📚 Documentation

https://api.hoshiyomi.my.id/docs

---

🗂️ Self-Hosted Source Services

Prefer to self-host? Full source code of the underlying source services is available:

DramaBox	FreeReels	Melolo	MoboReels	GoodShort
VIP unlock	Zero paywall	DRM decrypt	Full unlock	1080p ad-unlock

---

📞 Support

• Telegram: @dramaboxplusbot
• Admin: @Widiharu
• GitHub Issues: Create an issue

---

Built with ❤️ for drama lovers worldwide