MovieBox API
Code Examples
Ready-to-use examples for the MovieBox API — browse, search, video playback, TMDB enrichment (cast, genres, trailers, images, ratings, and more).

Your API Key
Active
Paste your API key to authenticate the "Try" buttons and inject it into code examples.Get your key →

sk_live_afb4c24ea8c44d30a06c67ecc67a8f85a46a0987c8d899bc
Save
Clear
Try It Live
Browse Content
GET
/api/moviebox?type=movies&per_page=5
Send
GET
/api/moviebox?type=series&per_page=5
Send
GET
/api/moviebox?type=movies&sort_by=vote_average&sort_order=desc&per_page=5
Send
GET
/api/moviebox?type=movies&sort_by=release_year&sort_order=desc&per_page=5
Send
GET
/api/moviebox/popular?type=movies
Send
GET
/api/moviebox/popular?type=series
Send
GET
/api/moviebox/trending
Send
Search
GET
/api/moviebox/search?q=money+heist&per_page=5
Send
GET
/api/moviebox/search?q=john+wick&type=movies&per_page=5
Send
GET
/api/moviebox/search?q=stranger+things&type=series&per_page=5
Send
cURL
cURL Examples
Copy
API_KEY="sk_live_afb4c24ea8c44d30a06c67ecc67a8f85a46a0987c8d899bc"
BASE="https://api.splay.id"

# ── List movies ──
curl -H"Authorization: Bearer $API_KEY""$BASE/api/moviebox?type=movies&per_page=20"

# ── List series ──
curl -H"Authorization: Bearer $API_KEY""$BASE/api/moviebox?type=series&per_page=20"

# ── List both (movies + series) ──
curl -H"Authorization: Bearer $API_KEY""$BASE/api/moviebox?per_page=20"

# ── Sort by rating (highest rated first) ──
curl -H"Authorization: Bearer $API_KEY"\
"$BASE/api/moviebox?type=movies&sort_by=vote_average&sort_order=desc&per_page=20"

# ── Sort by release year (newest first) ──
curl -H"Authorization: Bearer $API_KEY"\
"$BASE/api/moviebox?type=movies&sort_by=release_year&sort_order=desc&per_page=20"

# ── Popular movies / series / both ──
curl -H"Authorization: Bearer $API_KEY""$BASE/api/moviebox/popular?type=movies"
curl -H"Authorization: Bearer $API_KEY""$BASE/api/moviebox/popular?type=series"

# ── Trending ──
curl -H"Authorization: Bearer $API_KEY""$BASE/api/moviebox/trending"

# ── Movie/series detail (all episodes + TMDB enrichment + signed video URLs) ──
curl -H"Authorization: Bearer $API_KEY""$BASE/api/moviebox/DRAMA_ID"

# ── Paginated episodes ──
curl -H"Authorization: Bearer $API_KEY"\
"$BASE/api/moviebox/DRAMA_ID/episodes?page=1&per_page=50"

# ── Search ──
curl -H"Authorization: Bearer $API_KEY""$BASE/api/moviebox/search?q=money+heist"
curl -H"Authorization: Bearer $API_KEY""$BASE/api/moviebox/search?q=stranger+things&type=series"
JavaScript / TypeScript
Browse & Search
Copy
const BASE ="https://api.splay.id";
const API_KEY ="sk_live_afb4c24ea8c44d30a06c67ecc67a8f85a46a0987c8d899bc";
const headers = { Authorization: `Bearer ${API_KEY}` };

// ── List movies (paginated) ──
const res = await fetch(`${BASE}/api/moviebox?type=movies&per_page=20`, { headers });
const { data, meta } = await res.json();
console.log(`${meta.total} movies (page ${meta.page}/${meta.total_pages})`);
data.forEach(m => console.log(`[${m.id}] ${m.title}`));

// ── Sort by TMDB rating (highest first) ──
const topRated = await fetch(
`${BASE}/api/moviebox?type=movies&sort_by=vote_average&sort_order=desc&per_page=20`,
{ headers }
);

// ── Sort by release year (newest first) ──
const newest = await fetch(
`${BASE}/api/moviebox?type=movies&sort_by=release_year&sort_order=desc&per_page=20`,
{ headers }
);

// ── Popular ──
const { data: popularMovies } = await (
await fetch(`${BASE}/api/moviebox/popular?type=movies`, { headers })
).json();

// ── Trending ──
const { data: trending } = await (
await fetch(`${BASE}/api/moviebox/trending`, { headers })
).json();

// ── Search ──
const { data: results, meta: searchMeta } = await (
await fetch(`${BASE}/api/moviebox/search?q=money+heist&type=series`, { headers })
).json();
console.log(`Found ${searchMeta.total} results`);
Get Detail + Play Video
Copy
const BASE ="https://api.splay.id";
const API_KEY ="sk_live_afb4c24ea8c44d30a06c67ecc67a8f85a46a0987c8d899bc";
const headers = { Authorization: `Bearer ${API_KEY}` };

// ── Movie/Series detail (drama + episodes with signed URLs + TMDB data) ──
const res = await fetch(`${BASE}/api/moviebox/DRAMA_ID`, { headers });
const { data: { drama, episodes } } = await res.json();
console.log(`${drama.title} — ${episodes.length} episodes`);

// ── Video URLs — episode_index encoding:
// Movie (se=0, ep=1) → 1
// S1E1 → 1001, S2E5 → 2005, S3E12 → 3012
const ep = episodes[0];

// video_url = primary (720p), signed HMAC-SHA256, 5min TTL
console.log("Primary (720p):", ep.video_url);

// qualities = all resolutions as JSON object
console.log("360p:", ep.qualities?.["360p"]); // always available
console.log("480p:", ep.qualities?.["480p"]); // always available
console.log("720p:", ep.qualities?.["720p"]); // same as video_url
console.log("1080p:", ep.qualities?.["1080p"]); // premium content

// ── Pick best available quality ──
const videoUrl = ep.qualities?.["1080p"]
?? ep.qualities?.["720p"]
?? ep.video_url
?? ep.qualities?.["480p"]
?? ep.qualities?.["360p"];

const video = document.querySelector("video");
if (video && videoUrl) {
video.src = videoUrl; // direct MP4 — no HLS library needed
video.play();
}

// ── Subtitles (signed SRT URLs, 12+ languages) ──
// subtitles: [{ lang, label, url }]
for (const sub of ep.subtitles ?? []) {
console.log(`[${sub.lang}] ${sub.label}: ${sub.url}`);
}

// ── Paginated episodes for a long series ──
const { data: eps, meta } = await (
await fetch(`${BASE}/api/moviebox/DRAMA_ID/episodes?page=1&per_page=50`, { headers })
).json();
console.log(`${meta.total} total episodes, showing ${eps.length}`);
TMDB Enrichment
Every drama includes a raw_data.tmdb field with full TMDB metadata — ratings, cast, crew, genres, trailers, images, keywords, production info, and more.

JavaScript — using TMDB data
Copy
const { data: { drama } } = await (
await fetch(`${BASE}/api/dramas/DRAMA_ID`, { headers })
).json();

const tmdb = drama.raw_data?.tmdb;
if (!tmdb) { console.log("No TMDB data"); process.exit(0); }

// ── Basic info ──
console.log("Title:", drama.title);
console.log("Original:", tmdb.original_title, `(${tmdb.original_language})`);
console.log("Tagline:", tmdb.tagline);
console.log("Year:", drama.raw_data?.release_year ?? tmdb.release_date?.slice(0,4));
console.log("Runtime:", tmdb.runtime,"min"); // e.g. 180
console.log("Rating:", tmdb.vote_average, `(${tmdb.vote_count} votes)`);
console.log("Cert:", tmdb.certification); //"PG-13","R","TV-MA", etc.
console.log("Status:", tmdb.status); //"Released","Ended","Returning Series"

// ── Poster / backdrop images (TMDB CDN) ──
const TMDB_IMG ="https://image.tmdb.org/t/p";
if (tmdb.poster_path) console.log("Poster 500px:", `${TMDB_IMG}/w500${tmdb.poster_path}`);
if (tmdb.backdrop_path) console.log("Backdrop:", `${TMDB_IMG}/w1280${tmdb.backdrop_path}`);

// Top backdrops (w1280, voted by quality)
for (const img of tmdb.backdrops ?? []) {
console.log(`Backdrop ${img.width}×${img.height}: ${TMDB_IMG}/w1280${img.file_path}`);
}

// ── Genres ──
console.log("Genres:", (tmdb.genres ?? []).map(g => g.name).join(","));
// e.g."Action, Thriller, Crime"

// ── Keywords ──
console.log("Keywords:", (tmdb.keywords ?? []).map(k => k.name).join(","));
// e.g."heist, bank robbery, gang"

// ── Cast (top 20) ──
for (const actor of tmdb.cast ?? []) {
console.log(`${actor.name} as ${actor.character}`);
if (actor.profile_path)
console.log("Photo:", `${TMDB_IMG}/w185${actor.profile_path}`);
}

// ── Crew ──
console.log("Directors:", (tmdb.directors ?? []).map(d => d.name).join(","));
console.log("Writers:", (tmdb.writers ?? []).map(w => w.name).join(","));
console.log("Producers:", (tmdb.producers ?? []).map(p => p.name).join(","));

// ── Trailers (YouTube) ──
const trailer = (tmdb.trailers ?? []).find(t => t.type ==="Trailer"&& t.site ==="YouTube");
if (trailer) console.log("Trailer:", `https://youtube.com/watch?v=${trailer.key}`);

// ── Production ──
console.log("Studios:", (tmdb.production_companies ?? []).map(c => c.name).join(","));
console.log("Countries:", (tmdb.production_countries ?? []).map(c => c.name).join(","));
console.log("Languages:", (tmdb.spoken_languages ?? []).map(l => l.english_name).join(","));

// ── Box office (movies only) ──
if (tmdb.budget) console.log("Budget:", `$${(tmdb.budget / 1e6).toFixed(0)}M`);
if (tmdb.revenue) console.log("Revenue:", `$${(tmdb.revenue / 1e6).toFixed(0)}M`);

// ── Series-specific ──
console.log("Seasons:", tmdb.number_of_seasons);
console.log("Total eps:", tmdb.number_of_episodes);
console.log("Networks:", (tmdb.networks ?? []).map(n => n.name).join(",")); // Netflix, HBO...
console.log("Creators:", (tmdb.creators ?? []).map(c => c.name).join(","));

// ── Franchise / collection (movies) ──
if (tmdb.collection) console.log("Collection:", tmdb.collection.name);

// ── External IDs ──
if (tmdb.imdb_id) console.log("IMDb:", `https://imdb.com/title/${tmdb.imdb_id}`);
if (tmdb.tvdb_id) console.log("TVDB ID:", tmdb.tvdb_id);
Build a movie card UI (React)
Copy
import type { Drama } from"./types";

const TMDB_IMG ="https://image.tmdb.org/t/p";

function MovieCard({ drama }: { drama: Drama }) {
const tmdb = drama.raw_data?.tmdb;
const year = drama.raw_data?.release_year
?? tmdb?.release_date?.slice(0, 4);
const runtime = tmdb?.runtime
? `${Math.floor(tmdb.runtime / 60)}h ${tmdb.runtime % 60}m`
: null;
const genres = (tmdb?.genres ?? []).slice(0, 3).map(g => g.name);
const trailer = (tmdb?.trailers ?? []).find(
t => t.type ==="Trailer"&& t.site ==="YouTube"
);

return (
<div className="movie-card">
{/* Poster from TMDB (or fallback to CDN cover) */}
<img
src={
tmdb?.poster_path
? `${TMDB_IMG}/w500${tmdb.poster_path}`
: drama.cover_url ??"/placeholder.jpg"
}
alt={drama.title}
/>

<h2>{drama.title}</h2>
{tmdb?.tagline && <p className="tagline">{tmdb.tagline}</p>}

<div className="meta">
{year && <span>{year}</span>}
{tmdb?.certification && <span className="cert">{tmdb.certification}</span>}
{runtime && <span>{runtime}</span>}
{tmdb?.vote_average && (
<span className="rating">★ {tmdb.vote_average.toFixed(1)}</span>
)}
</div>

<div className="genres">
{genres.map(g => <span key={g} className="genre-tag">{g}</span>)}
</div>

<p className="overview">{tmdb?.overview ?? drama.introduction}</p>

<div className="cast">
{(tmdb?.cast ?? []).slice(0, 5).map(actor => (
<div key={actor.id} className="actor">
{actor.profile_path && (
<img src={`${TMDB_IMG}/w185${actor.profile_path}`} alt={actor.name} />
)}
<span>{actor.name}</span>
<span className="character">{actor.character}</span>
</div>
))}
</div>

{trailer && (
<a
href={`https://youtube.com/watch?v=${trailer.key}`}
target="_blank"
>
Watch Trailer
</a>
)}
</div>
);
}
Python
Full Example
Copy
import requests

BASE ="https://api.splay.id"
API_KEY ="sk_live_afb4c24ea8c44d30a06c67ecc67a8f85a46a0987c8d899bc"
headers = {"Authorization": f"Bearer {API_KEY}"}
TMDB_IMG ="https://image.tmdb.org/t/p"

# ── List movies ──
res = requests.get(f"{BASE}/api/moviebox", params={
"type":"movies","per_page": 20,"sort_by":"vote_average",
"sort_order":"desc"
}, headers=headers)
for m in res.json()["data"]:
tmdb = (m.get("raw_data") or {}).get("tmdb") or {}
rating = tmdb.get("vote_average", 0)
year = (m.get("raw_data") or {}).get("release_year","")
print(f"[{m['id']}] {m['title']} ({year}) ★{rating:.1f}")

# ── Top-rated series ──
series = requests.get(f"{BASE}/api/moviebox", params={
"type":"series","per_page": 20,
"sort_by":"vote_average","sort_order":"desc"
}, headers=headers)

# ── Detail with full TMDB data ──
detail = requests.get(f"{BASE}/api/moviebox/DRAMA_ID", headers=headers)
info = detail.json()["data"]
drama, episodes = info["drama"], info["episodes"]
tmdb = (drama.get("raw_data") or {}).get("tmdb") or {}

print(f"\n=== {drama['title']} ===")
print(f"Tagline: {tmdb.get('tagline')}")
print(f"Rating: {tmdb.get('vote_average')} ({tmdb.get('vote_count')} votes)")
print(f"Certification: {tmdb.get('certification')}")
print(f"Runtime: {tmdb.get('runtime')} min")
print(f"Genres: {', '.join(g['name'] for g in tmdb.get('genres', []))}")
print(f"Keywords: {', '.join(k['name'] for k in tmdb.get('keywords', [])[:10])}")

# Poster / backdrop
if tmdb.get("poster_path"):
print(f"Poster: {TMDB_IMG}/w500{tmdb['poster_path']}")
if tmdb.get("backdrop_path"):
print(f"Backdrop: {TMDB_IMG}/w1280{tmdb['backdrop_path']}")

# Cast
print("\nCast:")
for actor in tmdb.get("cast", [])[:5]:
print(f"{actor['name']} as {actor.get('character', '?')}")

# Crew
print("Directors:",",".join(d["name"] for d in tmdb.get("directors", [])))
print("Writers:",",".join(w["name"] for w in tmdb.get("writers", [])))

# Trailer
for t in tmdb.get("trailers", []):
if t["type"] =="Trailer"and t["site"] =="YouTube":
print(f"Trailer: https://youtube.com/watch?v={t['key']}")
break

# Production
print("Studios:",",".join(c["name"] for c in tmdb.get("production_companies", [])))
if tmdb.get("budget"):
print(f"Budget: ${tmdb['budget'] / 1e6:.0f}M")
if tmdb.get("revenue"):
print(f"Revenue: ${tmdb['revenue'] / 1e6:.0f}M")

# Series-specific
if tmdb.get("number_of_seasons"):
print(f"Seasons: {tmdb['number_of_seasons']}, Episodes: {tmdb['number_of_episodes']}")
print("Networks:",",".join(n["name"] for n in tmdb.get("networks", [])))

# External links
if tmdb.get("imdb_id"):
print(f"IMDb: https://imdb.com/title/{tmdb['imdb_id']}")

# ── Video URLs (signed MP4, 1h TTL) ──
# episode_index: Movie→1, S1E1→1001, S2E5→2005, S3E12→3012
ep = episodes[0]
qualities = ep.get("qualities") or {}
video_url = (
qualities.get("1080p") or qualities.get("720p")
or ep.get("video_url") or qualities.get("480p") or qualities.get("360p")
)
print(f"\nBest video URL: {video_url}")

# Subtitles (signed SRT URLs, 12+ languages)
for sub in ep.get("subtitles", []):
print(f"[{sub['lang']}] {sub['label']}: {sub['url']}")
TMDB Image URLs
poster_path andbackdrop_path are relative paths — prepend the TMDB image CDN base:

Use Case	Size	URL Pattern
Poster — card	w342	https://image.tmdb.org/t/p/w342{poster_path}
Poster — detail	w500	https://image.tmdb.org/t/p/w500{poster_path}
Poster — original	original	https://image.tmdb.org/t/p/original{poster_path}
Backdrop — hero	w1280	https://image.tmdb.org/t/p/w1280{backdrop_path}
Profile — cast	w185	https://image.tmdb.org/t/p/w185{cast[n].profile_path}
Trailers: https://youtube.com/watch?v={trailers[0].key} — always YouTube, official Trailer or Teaser type.

Episode Index Encoding
episode_index = season × 1000 + episode

Season/Episode	episode_index	Notes
Movie (se=0, ep=1)	1	All movies
S1E1	1001	
S1E10	1010	
S2E5	2005	
S3E12	3012