# DramaBox Rankings Scraper - Popular & New Short Dramas (`spider_studio/dramabox-drama-rank`) Actor

Scrape DramaBox rankings for most watched, most searched and new short dramas. Extract titles, IDs, synopsis, covers, episode counts and tags, with one drama per row. Export CSV, Excel or JSON and monitor popular titles with scheduled runs or API access.

- **URL**: https://apify.com/spider\_studio/dramabox-drama-rank.md
- **Developed by:** [Tarique](https://apify.com/spider_studio) (community)
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 successful ranking results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### Discover popular and new DramaBox short dramas

**DramaBox Rankings Scraper** helps you discover popular titles and new releases on [DramaBox](https://www.dramabox.com). Choose **Most Watched**, **Most Searched** or **New Dramas**, then collect drama titles, summaries, covers, episode counts, tags and ranking positions.

Each drama is saved as its own row, ready to export to CSV, Excel or JSON. Use the results to explore short-drama genres, research popular story themes or keep your catalog up to date.

### Why use DramaBox rankings?

Compare titles across DramaBox discovery lists, find new short dramas and build a spreadsheet of popular releases. Content researchers can review genres and story themes; catalog teams can collect consistent title information; analysts can save repeated snapshots to compare changes over time.

Apify provides scheduled runs, API access and exports for connecting the results to your existing workflow. The number of titles depends on the selected DramaBox ranking.

### How to collect a DramaBox ranking

1. Select a ranking in the Input tab.
2. Start the Actor.
3. Review the returned dramas in the results table.
4. Export your data or schedule another run to collect a new snapshot.

### Input

The only input field is `rank_type`, displayed as an English dropdown named Ranking:

| Dropdown option | API input value | Meaning |
| --- | --- | --- |
| Most Watched | `most_watched` | DramaBox's most-watched ranking |
| Most Searched | `most_searched` | DramaBox's most-searched ranking |
| New Dramas | `new_dramas` | DramaBox's new-drama ranking |

Most Watched is the default. Choose one ranking per run. For API access, use the input value shown above:

```json
{
  "rank_type": "most_watched"
}
```

### Output

Each returned drama is saved as a separate row with its selected ranking and position. Available fields include the title, summary, cover image, episode count, tags and platform-reported counters.

```json
{
  "rank_type": "most_watched",
  "rank_position": 1,
  "book_id": "42000004343",
  "book_name": "If I Never Loved You",
  "chapter_count": 50,
  "tags": ["Romance"],
  "success": true,
  "error": null
}
```

This example shows the output format and does not represent a current ranking position. Export results as JSON, CSV or Excel from Apify, or retrieve them through the API tab.

### Data fields

| Field | Meaning |
| --- | --- |
| rank\_type / rank\_position | Selected ranking and position in the returned list |
| book\_id / book\_name | Drama identifier and title |
| introduction / cover / chapter\_count / tags | Drama metadata |
| play\_count / in\_library\_count | Platform-reported listing counters, when provided |
| author / protagonist / performer\_ids / rank | Additional normalized listing metadata |
| success / error | Whether a result was returned successfully |

Some fields depend on what DramaBox provides for a title and may be empty. Ranking positions describe the selected list, rather than a comparison of every drama in the catalog.

### Pricing: pay only for successful drama results

| Apify account | Per successful drama | 1,000 successful dramas |
| --- | --- | --- |
| Free plan | **$0.003** | **$3.00** |
| Any paid plan | **$0.002** | **$2.00** |

**Platform usage is charged separately, in addition to these result fees.** Your total cost is the successful-result fee plus the platform usage shown for your run.

Only unique dramas successfully saved in the selected ranking incur a result fee. Failed requests, empty rankings and duplicate dramas within the same run have no result fee. There is no additional Actor Start fee. Platform usage can still apply to a run that returns no successful dramas.

For example, 10 successful dramas cost **$0.03 on the Free plan** or **$0.02 on a paid plan**, plus platform usage. Running the Actor again produces a new set of results and new charges. Set a run spending limit to control result fees and review the run's usage before creating a recurring schedule.

### Related DramaBox Actors

Use these Actors for other parts of your DramaBox workflow:

| Actor | What it does |
| --- | --- |
| [DramaBox Search Scraper](https://apify.com/spider_studio/dramabox-drama-search) | Find dramas by keyword and collect IDs, titles and listing metadata. |
| [DramaBox Actor Profile Scraper](https://apify.com/spider_studio/dramabox-performer-detail) | Collect performer profiles, biographies and drama credits. |
| [DramaBox Drama Details Scraper](https://apify.com/spider_studio/dramabox-drama-detail) | Retrieve drama metadata, cast information and episode indexes by Book ID. |
| [DramaBox Episodes Scraper](https://apify.com/spider_studio/dramabox-drama-chapters) | Collect chapter lists and temporary playback URLs for available free episodes. |
| [DramaBox Video Downloader](https://apify.com/spider_studio/dramabox-chapter-download) | Download available free episode videos and save MP4 files with download links. |

### Frequently asked questions

#### Which DramaBox rankings can I collect?

Choose Most Watched, Most Searched or New Dramas. Each run collects the selected list with one drama per result row.

#### Can I monitor popular DramaBox titles over time?

Yes. Schedule repeated runs and compare the saved snapshots in your spreadsheet, dashboard or analysis workflow. This Actor provides the ranking snapshots; changes can be compared using your exported data.

#### Does this Actor download videos?

This Actor provides drama ranking data and metadata. For episode information or video files, use the relevant DramaBox Actors in the developer's collection.

#### Where can I get help?

Use the Issues tab to report missing results or changes in the available rankings. Use the API tab for programmatic access. This is an independent tool and is not affiliated with DramaBox.

# Actor input Schema

## `rank_type` (type: `string`):

Select the DramaBox ranking to collect.

## Actor input object example

```json
{
  "rank_type": "most_watched"
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "rank_type": "most_watched"
};

// Run the Actor and wait for it to finish
const run = await client.actor("spider_studio/dramabox-drama-rank").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "rank_type": "most_watched" }

# Run the Actor and wait for it to finish
run = client.actor("spider_studio/dramabox-drama-rank").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "rank_type": "most_watched"
}' |
apify call spider_studio/dramabox-drama-rank --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,spider_studio/dramabox-drama-rank"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/4zABZTb9970tAiPaf/builds/atLuHhwL1Yi7WQuVb/openapi.json