ReelRelay

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

GET/providers

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.

GET/home

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. melolo
  • page — default 1
  • lang — default id
GET/drama/{id}

Drama details. id is provider:originalId exactly as returned by other endpoints.

  • lang — default id
GET/drama/{id}/episodes

Episode list (number, title, isFree).

  • lang — default id
GET/drama/{id}/episodes/{number}/stream

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
GET/health

Live availability and latency for the first 12 active platforms (refreshed every 60 s); the others show the result of the latest scheduled check.

GET/logos/{providerId}

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-After on 429 and 503 responses

Errors

HTTPCodeMeaning
400BAD_REQUESTInvalid or missing parameter.
401UNAUTHORIZEDMissing, invalid or revoked API key.
403FORBIDDENYour plan doesn’t include this platform — upgrade or buy a weekly pass for it.
404NOT_FOUNDUnknown endpoint, platform, drama or episode.
429RATE_LIMITEDPer-minute limit exceeded. Wait Retry-After seconds.
429QUOTA_EXCEEDEDDaily quota used up. Resets 00:00 UTC.
502UPSTREAM_ERRORThe content source returned an error.
503PROVIDER_UNAVAILABLEPlatform is in maintenance or coming soon.
503PROVIDER_BUSYPlatform is at capacity. Retry after Retry-After seconds.
504UPSTREAM_TIMEOUTThe content source did not respond in time.
500INTERNAL_ERRORUnexpected 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);