API v1
ReelRelay API
One API for many short-drama catalogues. Every platform returns the same shapes: providers, dramas, episodes and streams.
Authentication
Send your key in the x-api-key header on every request. Create a free account to get one. Keys are secret: call the API from your server, never from browser code.
curl -H "x-api-key: YOUR_KEY" \ "https://dramareels.sbs/api/v1/search?q=ceo&lang=en"
Base URL: https://dramareels.sbs/api/v1
Response format
// success
{ "success": true, "data": { ... }, "meta": { ... } }
// error
{ "success": false, "error": { "code": "RATE_LIMITED", "message": "..." } }
Multi-platform calls (/home, /search, /trending) return partial results if a platform fails; those are listed in meta.failed.
Languages
Every content endpoint accepts lang: id, en, ja, ko, th, ar, pt, es, vi, de, fr, it, tr, my, km. Default id (Indonesian). Titles, synopses and subtitles follow the language where the platform has it.
Endpoints
Every platform with its status (active, maintenance, coming), the plan that includes it, whether your key can use it (included) and the weekly pass price.
Catalogue feed, paged. Without provider it merges your first 12 platforms (catalogue order, see /providers); pass provider for any single platform.
provider— optional, e.g. melolopage— default 1lang— default id
Search in parallel and merge the results (de-duplicated by title). Without provider it covers your first 12 platforms; pass provider to search any single platform.
q— required, 1–100 charsprovider— optionalpage— default 1lang— default id
Ranked trending dramas (most-viewed first) from each platform's curated home list. Each item has a rank (1 = top).
provider— optionallimit— 1–50, default 10lang— default id
Drama details. id is provider:originalId exactly as returned by other endpoints.
lang— default id
Episode list (number, title, isFree).
lang— default id
Playable MP4/HLS sources (best quality first), WebVTT subtitles, and headers to send with the video request when the platform needs them. Request it right before playback — don't store the URLs.
lang— default id
Live availability and latency for the first 12 active platforms (refreshed every 60 s); the others show the result of the latest scheduled check.
Platform logo image (the logo URL from /providers). No key needed, so it works in <img>.
Data model
Provider { id, name, logo, status: "active" | "maintenance" | "coming",
plan: "free" | "basic" | "pro", included, pass, passPriceWeekly, note? }
Drama { id: "provider:originalId", provider, title, cover, description,
tags: string[], totalEpisodes, language?, views?, status?, author? }
Episode { number, title?, isFree }
Stream { sources: [{ url, quality, type: "hls" | "mp4" }],
subtitles: [{ lang, url }],
headers?: { [name]: value }, // send with the video request
episode?, totalEpisodes? }
Paged<T> { items: T[], page, hasMore }
Trending { items: (Drama & { rank })[], limit }Optional fields are omitted when a platform doesn’t supply them.
Rate limits
Each key has a per-minute limit and a daily quota set by its plan. Every response includes:
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset(seconds)X-Quota-Limit,X-Quota-Remaining(per UTC day)Retry-Afteron 429 and 503 responses
Errors
| HTTP | Code | Meaning |
|---|---|---|
| 400 | BAD_REQUEST | Invalid or missing parameter. |
| 401 | UNAUTHORIZED | Missing, invalid or revoked API key. |
| 403 | FORBIDDEN | Your plan doesn’t include this platform — upgrade or buy a weekly pass for it. |
| 404 | NOT_FOUND | Unknown endpoint, platform, drama or episode. |
| 429 | RATE_LIMITED | Per-minute limit exceeded. Wait Retry-After seconds. |
| 429 | QUOTA_EXCEEDED | Daily quota used up. Resets 00:00 UTC. |
| 502 | UPSTREAM_ERROR | The content source returned an error. |
| 503 | PROVIDER_UNAVAILABLE | Platform is in maintenance or coming soon. |
| 503 | PROVIDER_BUSY | Platform is at capacity. Retry after Retry-After seconds. |
| 504 | UPSTREAM_TIMEOUT | The content source did not respond in time. |
| 500 | INTERNAL_ERROR | Unexpected error. Quote X-Request-Id to support. |
Examples
PHP
$ch = curl_init("https://dramareels.sbs/api/v1/home?page=1&lang=en");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('REELRELAY_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (!$body['success']) throw new Exception($body['error']['code']);
foreach ($body['data']['items'] as $drama) echo $drama['id'], ' ', $drama['title'], PHP_EOL;JavaScript (Node 18+)
const res = await fetch("https://dramareels.sbs/api/v1/home?page=1&lang=en", {
headers: { "x-api-key": process.env.REELRELAY_KEY },
});
const body = await res.json();
if (!body.success) throw new Error(body.error.code);
for (const drama of body.data.items) console.log(drama.id, drama.title);