# DramaBox Actor Profile Scraper - Cast & Filmography (`spider_studio/dramabox-performer-detail`) Actor

Scrape DramaBox actor profiles and filmographies in bulk. Collect performer names, photos, biographies and short-drama credits with a page limit per actor. Export cast data to CSV, Excel or JSON for talent research, catalog enrichment and scheduled updates.

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

## Pricing

from $2.00 / 1,000 successful actor profiles

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

### What does the DramaBox Actor Profile Scraper do?

**DramaBox Actor Profile Scraper** collects actor profiles and short-drama credits from [DramaBox](https://www.dramabox.com). Enter a list of performer IDs to extract names, profile photos, biographies and associated dramas, then export the results to CSV, Excel or JSON.

Use it as a **DramaBox cast data API** for talent research, catalog enrichment and filmography tracking. Each actor has one result row, with their collected drama credits grouped together. Set a maximum number of works pages per actor to control how much data you collect.

### Why collect DramaBox actor profiles and filmographies?

- Research short-drama actors and the titles they appear in.
- Add cast profiles, biographies and photos to a drama catalog.
- Discover more DramaBox titles featuring a performer.
- Schedule repeat runs to check for new drama credits.
- Connect actor data to spreadsheets and other tools through Apify integrations or API access.

The Actor supports batches of up to 1,000 performer IDs. Duplicate IDs within the same run are processed once. Available profile fields depend on the information DramaBox provides for each performer.

### How to scrape DramaBox actor profiles

1. Open the Input tab and enter the performer IDs you want to collect.
2. Set **Max Pages** to the maximum number of works pages per actor.
3. Start the Actor and review the actor profiles in the results table.
4. Download your dataset or connect it to another tool. Schedule a run if you want regular updates.

For one actor, enter a list containing just one ID. The input form includes an example ID and a one-page limit to help you get started.

### Input: batch performer IDs and maximum pages

See the Input tab for full configuration options.

| Field | Meaning | Default |
| --- | --- | --- |
| `performer_ids` | Required list of 1–1,000 performer IDs, each entered as a string of 1–20 digits | Example prefilled: `["12070"]` |
| `max_pages` | Maximum works pages per actor, starting from the first page; accepts 1–1,000 | `1` |

Collection stops earlier when the works list ends or a page contains no new drama IDs. Increasing Max Pages can collect more credits but does not add another actor-result fee.

```json
{
  "performer_ids": ["12070"],
  "max_pages": 3
}
```

### What DramaBox cast data can I extract?

| Field | Meaning |
| --- | --- |
| `performer_id` | DramaBox performer identifier |
| `name` / `english_name` | Performer names, when available |
| `avatar` | Profile image URL |
| `introduction` | Biography or profile description |
| `video_count` | Total count reported by DramaBox; may exceed the collected credits |
| `books` | Collected drama credits, including drama IDs, titles and available metadata |
| `pages_fetched` | Number of works pages successfully collected |
| `success` / `error` | Result status and an error message if collection failed |

Drama credits from multiple pages are merged into one actor result. Repeated drama IDs within an actor's filmography are included once.

### Output and exports

The example below illustrates the output format; its profile details are placeholders.

```json
{
  "performer_id": "12070",
  "name": "Example performer",
  "english_name": null,
  "avatar": "https://example.com/profile.jpg",
  "introduction": "Example actor biography",
  "video_count": 4,
  "pages_fetched": 1,
  "books": [
    {"book_id": "42000004343", "book_name": "Example short drama"},
    {"book_id": "42000004344", "book_name": "Another short drama"}
  ],
  "success": true,
  "error": null
}
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. JSON preserves each actor's nested drama credits. The run summary shows saved results, failed results and whether the spending limit was reached.

### How much does it cost to scrape DramaBox actors?

| Apify account | Per successful actor profile | 1,000 successful profiles |
| --- | --- | --- |
| Free plan | **$0.03** | **$30.00** |
| Any paid plan | **$0.02** | **$20.00** |

A successful actor profile includes all works pages collected for that actor within your chosen limit. Duplicate performer IDs within a run and failed results have no result fee. A successfully returned profile with no drama credits still counts as one actor result.

The default **Actor Start fee is $0.00005 per start event**, automatically charged by Apify. Runs using up to 1 GB of memory incur one start event; above 1 GB, one event is charged per GB, rounded up. The start fee applies even when no successful actor profiles are returned.

**Apify platform usage is charged separately**, in addition to actor-result and start fees. For example, 10 successful profiles with up to 1 GB of memory cost **$0.30005 on the Free plan** or **$0.20005 on a paid plan**, plus platform usage. Each new run incurs new charges. Set a run spending limit and review usage before scheduling large batches.

### 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 Rankings Scraper](https://apify.com/spider_studio/dramabox-drama-rank) | Discover titles from the Most Watched, Most Searched and New Dramas rankings. |
| [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

#### Can I collect a complete DramaBox actor filmography?

Increase Max Pages to collect more works. The result contains the credits available from DramaBox up to your page limit. A low limit can produce a partial filmography, and fields can change as DramaBox updates its catalog.

#### What happens if one actor or a later works page fails?

The Actor saves an error result and continues with other performer IDs. If a later page fails, the error result includes credits collected from earlier pages and has no actor-result fee.

#### Can I run this as a DramaBox actor API?

Yes. Use the API tab to submit the same batch input and retrieve the saved dataset. Apify scheduling and integrations also support recurring cast-data workflows.

#### Does this Actor download drama videos?

It collects actor profiles and drama metadata. For episode information and video files, use the relevant DramaBox Actors in the developer's collection.

#### Where can I get support?

Use the Issues tab to report unavailable profiles or changes in returned data. This is an independent tool and is not affiliated with DramaBox.

# Actor input Schema

## `performer_ids` (type: `array`):

DramaBox performer IDs to collect. Enter one ID per item; duplicate IDs are processed once.

## `max_pages` (type: `integer`):

Maximum works pages per actor, starting at the first page. Collection stops earlier when the works list ends or no new dramas are found.

## Actor input object example

```json
{
  "performer_ids": [
    "12070"
  ],
  "max_pages": 1
}
```

# 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 = {
    "performer_ids": [
        "12070"
    ],
    "max_pages": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("spider_studio/dramabox-performer-detail").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 = {
    "performer_ids": ["12070"],
    "max_pages": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("spider_studio/dramabox-performer-detail").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 '{
  "performer_ids": [
    "12070"
  ],
  "max_pages": 1
}' |
apify call spider_studio/dramabox-performer-detail --silent --output-dataset

```

## MCP server setup

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

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/xqvsnJSBAbH8YDLVX/builds/taVBTgup5d0uNkDuu/openapi.json