GET/dramabox/browseapiKey3 credits/request
Returns one page of 12 DramaBox short dramas, optionally within one genre: id, title, description, cover, link, episode count, tags, genres, rating, update status and displayed views, with the page and total page count. Genre ids come from dramabox-genres. Only public catalog metadata is read; no playable video is returned.
Optional: genre_id, page, language (14 allowed values: en, ko, zhHans, zh, es, ja, de, in, th, tl, pt, fr, ar, it).
Sampled 26 Oct 2026: 12 items. Filled in every item: id, title, description, cover_url, url, episodes, tags, genres and 6 more. In the sample: listed_at: 2026-09-25 to 2026-10-26; episodes: 37 to 130, median 50; title: “You Dare Dump Me? I Married Your Siren Nemesis” and 11 other values; cover_url: thwztchapter.dramaboxdb.com; description: median 422 characters; tags: median 2 entries; url: dramabox.com; genres: median 1 entry.
Open in Playground
GET/dramabox/categoriesapiKey1 credit/request
Returns the DramaBox app's category navigation as six groups: language, production type, dub mode, two genre rows (genre_1 and genre_2) and sort order. Each group lists the selectable options as display names and the values to pass to dramabox-category-books. The "All" pseudo-option is dropped because omitting a filter means all. Only public catalog metadata is read; no playable video is returned.
Takes no parameters.
Sampled 26 Oct 2026: 6 items. Filled in every item: key, type, options. Not in every item: row (1). In the sample: type: 1 to 6, median 4; options: median 3 entries.
Open in Playground
GET/dramabox/category-booksapiKey1 credit/request
Returns one page of 20 DramaBox short dramas from the app's category feed, optionally filtered by values from dramabox-categories: language, production type, dub mode, either genre row and sort order. Filters are ANDed; an omitted filter means all. Each title carries its id, title, description, cover, website link, episode count, tags with tag ids, protagonist, play count, library flag and listing times. Only public catalog metadata is read; no playable video is returned.
Optional: language, production (3 allowed values: 3, 1, 2), dub (2 allowed values: 1, 0), genre, genre_2, sort (3 allowed values: 1, 2, 3), page, limit.
Sampled 26 Oct 2026: 20 items. Filled in every item: id, title, description, cover_url, url, episodes, tags, tag_refs and 3 more. In the sample: shelf_time: 2026-07-22 to 2026-10-20; episodes: 30 to 60, median 50; title: “Deadliest Prison: The Female Warden Is My Plaything” and 19 other values; cover_url: hwztchapter.dramaboxdb.com; in_library: true in 0 of 20; description: median 389 characters; tags: median 6 entries; url: dramabox.com.
Open in Playground
GET/dramabox/channelsapiKey1 credit/request
Returns the 8 DramaBox app theater channels as ids and names: Popular, New, Rankings, Categories, Anime, Live-Action, VIP and Original+. The channel value for dramabox-theater is the lowercase name (popular, new, rankings, categories, anime, live-action, vip, original). Only public catalog metadata is read; no playable video is returned.
Takes no parameters.
Sampled 26 Oct 2026: 8 items. Filled in every item: id, name.
Open in Playground
GET/dramabox/dramaapiKey3 credits/request
Returns one DramaBox short drama: title, description, cover, link, language, episode count, lifetime views, follows, tags, genres, listing times, the languages it is available in, the episode list with each episode's number, id, duration, free flag and thumbnail, and related titles. Only public catalog metadata is read; no playable video is returned.
Required: id.
Sampled 26 Oct 2026: 43 items. Filled in every item: number, id, free, duration_ms, updated_at, thumbnail_url. In the sample: updated_at: 2026-10-26; number: 1 to 43, median 22; thumbnail_url: thwztvideo.dramaboxdb.com; free: true in 8 of 43; duration_ms: 61,534 to 144,435, median 96,435.
Open in Playground
GET/dramabox/genresapiKey3 credits/request
Returns the genres DramaBox's browse accepts (Romance, Werewolves, Revenge, Billionaire, ...) as ids and names, read live from DramaBox. Pass a genre id to dramabox-browse. Only public catalog metadata is read; no playable video is returned.
Optional: language (14 allowed values: en, ko, zhHans, zh, es, ja, de, in, th, tl, pt, fr, ar, it).
Sampled 26 Oct 2026: 54 items. Filled in every item: id, name. In the sample: name: “Werewolves” and 53 other values.
Open in Playground
GET/dramabox/homeapiKey3 credits/request
Returns DramaBox's (dramabox.com) home page: the featured short dramas and the three curated shelves (Trending, Must-sees, Hidden gems), each title with its id, title, description, cover, DramaBox link, episode count, tags, genres and the view count as the site prints it. Use dramabox-more for a whole shelf. Only public catalog metadata is read; no playable video is returned.
Optional: language (14 allowed values: en, ko, zhHans, zh, es, ja, de, in, th, tl, pt, fr, ar, it).
Sampled 26 Oct 2026: 3 items. Filled in every item: id, title, description, cover_url, url, episodes, tags, genres and 2 more. In the sample: episodes: 43 to 58, median 50; title: “Love Is A Dangerous Game” and 2 other values; cover_url: thwztchapter.dramaboxdb.com; description: median 387 characters; tags: median 2 entries; url: dramabox.com; genres: median 1 entry; views_display: “15.6K” and 2 other values.
Open in Playground
GET/dramabox/moreapiKey3 credits/request
Returns one page of 18 titles from a DramaBox curated shelf (trending, must-sees or hidden-gems): id, title, description, cover, link, episode count, tags, genres and displayed views, with the page and total page count. Only public catalog metadata is read; no playable video is returned.
Required: position (3 allowed values: trending, must-sees, hidden-gems). Optional: page, language (14 allowed values: en, ko, zhHans, zh, es, ja, de, in, th, tl, pt, fr, ar, it).
Sampled 26 Oct 2026: 18 items. Filled in every item: id, title, description, cover_url, url, episodes, tags, genres and 3 more. In the sample: episodes: 30 to 62, median 54; title: “Falling for the Prince at Dark Arts Academy” and 17 other values; cover_url: thwztchapter.dramaboxdb.com; description: median 389 characters; tags: median 2 entries; url: dramabox.com; genres: median 2 entries; views_display: “19.0K” and 15 other values.
Open in Playground
GET/dramabox/performerapiKey1 credit/request
Returns one DramaBox performer from the Android app API: name, gender, avatar, video count, follow flag, and one page of the titles they appear in (each with id, title, description, cover, website link, episode count, tags with their tag ids, protagonist, library flag and listing times). Get performer ids from dramabox-search or dramabox-suggest's people results. Only public catalog metadata is read; no playable video is returned.
Required: performer_id. Optional: page, limit.
Sampled 26 Oct 2026: 1 item. Filled in every item: id, title, description, cover_url, url, episodes, tags, tag_refs and 3 more. In the sample: shelf_time: 2026-03-10; title: “I Went to the Mafia Boss for a Baby”; cover_url: hwztchapter.dramaboxdb.com; in_library: true in 0 of 1; tags: median 5 entries; description: “I saved a cartel king who tricked me into marriage. What he…”; url: dramabox.com; tag_refs: median 5 entries.
Open in Playground
GET/dramabox/rankapiKey1 credit/request
Returns one DramaBox ranking list from the DramaBox Android app API: the available tabs (Most Trending, Top Searched, New Releases) and 20 ranked titles, each with its id, title, description, cover, website link, episode count, tags, protagonist, rank position, hot metric, library flag and listing times. Pass a tab's type as rank_type to read that tab. Only public catalog metadata is read; no playable video is returned.
Optional: rank_type (3 allowed values: 1, 2, 3).
Sampled 26 Oct 2026: 20 items. Filled in every item: id, title, description, cover_url, url, episodes, tags, protagonist and 6 more. In the sample: shelf_time: 2026-06-25 to 2026-10-20; episodes: 30 to 58, median 50; title: “Falling for the Prince at Dark Arts Academy” and 19 other values; cover_url: hwztchapter.dramaboxdb.com; in_library: true in 0 of 20; description: median 392 characters; tags: median 6 entries; url: dramabox.com.
Open in Playground
GET/dramabox/recommendapiKey1 credit/request
Returns one page of DramaBox's own "You Might Like" recommendation feed from the Android app API: the feed title and its titles, each with id, title, description, cover, website link, episode count, tags with their tag ids, protagonist, library flag and listing times. The upstream page size is fixed, so page is the only paging control. Only public catalog metadata is read; no playable video is returned.
Optional: page.
Sampled 26 Oct 2026: 9 items. Filled in every item: id, title, description, cover_url, url, episodes, tags, tag_refs and 3 more. In the sample: shelf_time: 2026-03-23 to 2026-10-25; episodes: 31 to 63, median 46; title: “Falling for the Prince at Dark Arts Academy” and 8 other values; cover_url: hwztchapter.dramaboxdb.com; in_library: true in 0 of 9; description: median 389 characters; tags: median 6 entries; url: dramabox.com.
Open in Playground
GET/dramabox/searchapiKey1 credit/request
Searches the DramaBox Android app API and returns one page of mixed results: book rows (id, title, description, cover, website link, tags, protagonist) and performer rows (id, name, avatar, series count), plus an is_more flag for the next page. The keyword is trimmed and truncated to 80 characters like the app; sort selects one of the app's result orderings. Performer ids can be passed to dramabox-performer. Only public catalog metadata is read; no playable video is returned.
Required: keyword. Optional: page, limit, sort (3 allowed values: 1, 2, 3).
Sampled 26 Oct 2026: 40 items. Filled in every item: id, title, description, cover_url, url, episodes, tags, protagonist and 1 more. In the sample: title: “Love's Encore” and 39 other values; cover_url: hwztchapter.dramaboxdb.com; in_library: true in 0 of 40; description: median 399 characters; tags: median 6 entries; url: dramabox.com; protagonist: “Luke Clark, Nancy Beck” and 39 other values.
Open in Playground
GET/dramabox/suggestapiKey1 credit/request
Returns the DramaBox Android app API's autocomplete suggestions for a partial query: book rows (kind "book", cover_url) and performer rows (kind "actor", avatar, series count). The keyword is trimmed and truncated to 80 characters like the app; a query with no match returns an empty items list. Only public catalog metadata is read; no playable video is returned.
Required: keyword.
Sampled 26 Oct 2026: 12 items. Filled in every item: kind, id, name, videos. Not in every item: avatar (2), cover_url (10). In the sample: kind: book (10), actor (2); videos: 0 to 1, median 0; name: “Kyle Lovett” and 11 other values; avatar: hwztchapter.dramaboxdb.com; cover_url: hwztchapter.dramaboxdb.com.
Open in Playground
GET/dramabox/tagapiKey1 credit/request
Returns one page of DramaBox titles carrying a tag, as the Android app shows them: each title's id, title, description, cover, website link, episode count, tags with their tag ids, protagonist, library flag and listing times, plus the tag's own name. Get tag ids from any title result's tag_refs (dramabox-rank, dramabox-search, dramabox-category-books and the other list endpoints all expose them). An unknown tag id returns an empty list rather than an error. Only public catalog metadata is read; no playable video is returned.
Required: tag_id. Optional: page, limit.
Sampled 26 Oct 2026: 20 items. Filled in every item: id, title, description, cover_url, url, episodes, tags, tag_refs and 3 more. In the sample: shelf_time: 2026-08-01 to 2026-10-24; episodes: 30 to 60, median 50; title: “Love Is A Dangerous Game” and 19 other values; cover_url: hwztchapter.dramaboxdb.com; in_library: true in 0 of 20; description: median 403 characters; tags: median 6 entries; url: dramabox.com.
Open in Playground
GET/dramabox/theaterapiKey1 credit/request
Returns one page of a DramaBox app theater channel: the channel, its titled shelves (each with styles and 10 to 20 titles), poster banners and search hot words. Each title carries its id, title, description, cover, website link, episode count, tags with tag ids, protagonist, play count, library flag and listing times. Channel values are the lowercase names from dramabox-channels. An empty feed is a valid answer. Only public catalog metadata and poster images are read; no playable video is returned.
Required: channel (8 allowed values: popular, new, rankings, categories, anime, live-action, vip, original). Optional: page, limit.
Sampled 26 Oct 2026: 3 items. Filled in every item: title, titles. Not in every item: style (2). In the sample: title: “You Might Like” and 1 other value; titles: median 9 entries; style: “ALGORITHM_STYLE” and 1 other value.
Open in Playground
GET/dramabox/trendingapiKey1 credit/request
Returns the DramaBox Android app API's search landing page: the hot, trending and new-release title lists, the ranking tabs (pass a tab's type to dramabox-rank as rank_type) and the app's preset search keyword. Takes no parameters. Only public catalog metadata is read; no playable video is returned.
Takes no parameters.
Sampled 26 Oct 2026: 20 items. Filled in every item: id, title, description, cover_url, url, episodes, tags, protagonist and 1 more. In the sample: title: “Falling for the Prince at Dark Arts Academy” and 19 other values; cover_url: hwztchapter.dramaboxdb.com; in_library: true in 0 of 20; description: median 389 characters; tags: median 6 entries; url: dramabox.com; protagonist: “Damien Dalca, Margo Santiago” and 19 other values.
Open in Playground
DramaBox API endpoints