# Hongguo Series Details & Episodes Scraper API (`spider_studio/hongguo-series-detail`) Actor

Extract Hongguo short drama details and full episode lists by series ID, including titles, covers, summaries, counts, and episode video IDs via API.

- **URL**: https://apify.com/spider\_studio/hongguo-series-detail.md
- **Developed by:** [NewLai](https://apify.com/spider_studio) (community)
- **Categories:** Automation, Social media, Videos
- **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 successful series ids

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[中文](#红果短剧详情与剧集列表爬虫-api) | [English](#hongguo-series-details-and-episodes-scraper-api)

### 红果短剧详情与剧集列表爬虫 API

**红果短剧详情与剧集列表爬虫 API**用于获取 [红果短剧（Hongguo Duanju）](https://hongguoduanju.com/)完整短剧元数据和剧集目录。提交一个或多个 `seriesId`，即可提取剧名、简介、封面、播放量、集数、首集视频 ID 和标准化剧集列表。

它可以作为红果短剧详情 API 的替代方案，用于内容目录补全、剧集发现、元数据数据库，以及需要建立短剧与各集视频 ID 对应关系的工作流。单次运行最多支持 1,000 个不重复短剧 ID。

### 为什么使用红果短剧剧集列表爬虫？

- 一次获取最多 1,000 部短剧的完整元数据。
- 为每部成功获取的短剧提取标准化剧集列表。
- 返回各集的视频 ID、集数、标题、封面、时长和可用状态。
- 保留完整详情数据，方便读取标准字段之外的信息。
- 单个短剧失败不会影响其他成功结果。
- 支持 JSON、CSV、Excel、XML 或 HTML 导出。
- 可通过 Apify API、定时任务、Webhook、Make 或 n8n 自动化。

常见用途包括**红果短剧剧集详情**、中国短剧目录、剧集索引、短剧元数据补全、内容研究和已授权的视频处理准备。

### 可以提取哪些短剧和剧集数据？

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `seriesId` | string | 请求的红果短剧 ID。 |
| `success` | boolean | 是否成功获取短剧详情。 |
| `series` | object | 剧名、简介、封面、播放量、集数、平台和首集视频 ID。 |
| `episodes` | array | 包含视频 ID、集数、标题、封面、时长和状态的剧集目录。 |
| `data` | object | 完整的红果短剧详情数据。 |
| `error` | string 或 null | 短剧不可用时的错误信息。 |

### 如何获取完整的红果短剧剧集列表？

1. 通过红果搜索 Actor、推荐流 Actor 或其他授权来源找到 `seriesId`。
2. 打开此 Actor 的 **Input** 标签页。
3. 在 `seriesIds` 中添加一个或多个短剧 ID。
4. 点击 **Start**。
5. 打开 Dataset，在成功结果中读取 `series` 和 `episodes`。

### 红果短剧详情如何计费？

每 1,000 个成功解析的不重复短剧 ID 收费 **2 美元**，即每个成功 ID 0.002 美元。`success: false` 的诊断数据不收费，重复输入 ID 不会产生额外结果费用。

### 输入

完整校验规则请查看 **Input** 标签页。支持提交 1 到 1,000 个短剧 ID。

```json
{
  "seriesIds": [
    "7639686403294497854"
  ]
}
```

### 输出

Dataset 可以下载为 JSON、HTML、CSV 或 Excel 等格式。

```json
{
  "seriesId": "7639686403294497854",
  "success": true,
  "series": {
    "title": "示例短剧",
    "episodeCount": 80,
    "firstVideoId": "7639688323115519038"
  },
  "episodes": [
    {
      "videoId": "7639688323115519038",
      "episodeIndex": "1"
    }
  ],
  "error": null
}
```

### 红果短剧详情与剧集数据使用场景

- 创建可搜索的中国短剧与剧集数据库。
- 使用封面、简介、播放量和剧集目录补全搜索结果。
- 将红果短剧 ID 映射到所有可用的剧集视频 ID。
- 监控指定短剧的集数或元数据变化。
- 为已授权的媒体分析或转录任务准备结构化输入。

### 相关红果短剧 Actor

| Actor | 用途 |
| --- | --- |
| [红果短剧推荐流 API](https://apify.com/spider_studio/hongguo-recommend-feed) | 发现热门短剧及其 `seriesId`。 |
| [红果短剧关键词建议与自动补全 API](https://apify.com/spider_studio/hongguo-search-suggest) | 发现自动补全词和相关关键词。 |
| [红果短剧搜索与数据爬虫 API](https://apify.com/spider_studio/hongguo-search) | 按关键词查找短剧和 `seriesId`。 |
| [红果短剧最佳画质视频地址提取 API](https://apify.com/spider_studio/hongguo-video-best) | 为已授权的剧集 ID 获取最佳地址和画质元数据。 |
| [红果短剧全部视频画质与地址提取 API](https://apify.com/spider_studio/hongguo-video-variants) | 为已授权的剧集 ID 获取全部画质和地址。 |
| [红果短剧视频下载与视频解密 API](https://apify.com/spider_studio/hongguo-video-download) | 下载并解密剧集，将可播放 MP4 上传到用户自有存储。 |
| [红果短剧视频下载与解密到 Apify KVS](https://apify.com/spider_studio/hongguo-video-download-kvs) | 无需对象存储凭证，下载并解密剧集，将可播放 MP4 保存到运行 KVS。 |

### 常见问题

#### 可以批量获取多部红果短剧的详情和剧集列表吗？

可以。单次运行最多提交 1,000 个不重复 `seriesIds`。每条成功结果都包含标准化 `series` 元数据和该短剧的 `episodes` 数组。

#### 从哪里获取红果 `seriesId`？

可以使用红果搜索 Actor 或推荐流 Actor，它们返回的 `seriesId` 可以直接传给此 Actor。

#### 会返回全部剧集吗？

它会返回运行时可获取的剧集目录。不同短剧的可用情况可能不同，部分有效短剧当前也可能没有剧集数据。

#### 会返回可播放视频地址吗？

不会。此 Actor 返回短剧元数据和剧集视频 ID。对于你有权处理的内容，可以使用单独的视频 Actor 获取媒体信息。

### 合法使用与支持

请仅将此 Actor 用于合法用途，并遵守红果短剧的条款、版权、速率限制、隐私规则和适用法律。它用于公开内容目录元数据，不访问私人用户账户。

如需帮助，请使用 **Issues** 标签页；集成示例请查看 **API** 标签页。

***

### Hongguo series details and episodes scraper API

**Hongguo Series Details & Episodes Scraper API** is a **红果短剧 series scraper** that retrieves complete short-drama metadata and episode lists from [红果短剧 (Hongguo Duanju)](https://hongguoduanju.com/). Provide one or more `seriesId` values to extract titles, synopses, covers, play counts, episode counts, first video IDs, and normalized episode directories.

The Actor works as a Hongguo series details API alternative for catalog enrichment, episode discovery, metadata databases, and workflows that need reliable links between a series and its individual episode video IDs. Up to 1,000 unique series IDs can be submitted in one run.

### Why use this Hongguo episode list scraper?

- Get complete metadata for up to 1,000 short-drama series at once.
- Extract a normalized episode list for each successful series.
- Receive episode video IDs, indexes, titles, covers, durations, and availability flags.
- Preserve the complete source response for fields beyond the normalized schema.
- Keep failures isolated to their corresponding series IDs.
- Export results to JSON, CSV, Excel, XML, or HTML.
- Automate collection through the Apify API, schedules, webhooks, Make, or n8n.

Popular use cases include **红果短剧剧集详情**, Chinese short-drama catalogs, episode indexing, series metadata enrichment, content research, and preparing authorized video-processing workflows.

### What Hongguo series and episode data can the API extract?

| Field | Type | Description |
| --- | --- | --- |
| `seriesId` | string | Requested Hongguo series identifier. |
| `success` | boolean | Whether series details were retrieved. |
| `series` | object | Title, synopsis, cover, play count, episode count, platform, and first video ID. |
| `episodes` | array | Episode directory with video IDs, indexes, titles, covers, durations, and status flags. |
| `data` | object | Complete Hongguo series-detail response. |
| `error` | string or null | Error message for an unavailable series. |

### How to get a complete Hongguo short-drama episode list

1. Find a `seriesId` using the Hongguo Search Actor, Recommendation Feed Actor, or another authorized source.
2. Open this Actor's **Input** tab.
3. Add one or more values to `seriesIds`.
4. Click **Start**.
5. Open the Dataset and read `series` and `episodes` from successful rows.

### How much do Hongguo series details cost?

FREE-tier users pay **$3 per 1,000 successfully resolved series IDs** ($0.003 per successful unique ID). Users on BRONZE, SILVER, GOLD, PLATINUM, and DIAMOND tiers continue to pay **$2 per 1,000** ($0.002 per ID). Diagnostic rows with `success: false` are not charged, and duplicate input IDs do not generate additional result charges.

### Input

See the **Input** tab for complete validation details. You can submit between 1 and 1,000 series IDs.

```json
{
  "seriesIds": [
    "7639686403294497854"
  ]
}
```

### Output

You can download the Dataset in formats such as JSON, HTML, CSV, or Excel.

```json
{
  "seriesId": "7639686403294497854",
  "success": true,
  "series": {
    "title": "示例短剧",
    "episodeCount": 80,
    "firstVideoId": "7639688323115519038"
  },
  "episodes": [
    {
      "videoId": "7639688323115519038",
      "episodeIndex": "1"
    }
  ],
  "error": null
}
```

### Hongguo series details and episode data use cases

- Build a searchable database of Chinese short dramas and episodes.
- Enrich search results with covers, summaries, counts, and episode directories.
- Map a Hongguo series ID to all available episode video IDs.
- Monitor episode-count or metadata changes for selected titles.
- Prepare structured inputs for authorized media analysis or transcription.

### Related Hongguo Actors

| Actor | Purpose |
| --- | --- |
| [Hongguo Short Drama Recommendation Feed API](https://apify.com/spider_studio/hongguo-recommend-feed) | Discover trending short dramas and their series IDs. |
| [Hongguo Short Drama Keyword Suggestions API](https://apify.com/spider_studio/hongguo-search-suggest) | Discover autocomplete and related keywords. |
| [Hongguo Short Drama Search & Data Scraper API](https://apify.com/spider_studio/hongguo-search) | Find short dramas and series IDs by keyword. |
| [Hongguo Best Quality Video URL Extractor API](https://apify.com/spider_studio/hongguo-video-best) | Resolve the best available URL and quality metadata for an authorized episode ID. |
| [Hongguo All Video Qualities & URL Extractor API](https://apify.com/spider_studio/hongguo-video-variants) | Retrieve every available quality and URL for an authorized episode ID. |
| [Hongguo Video Downloader & Decryption API](https://apify.com/spider_studio/hongguo-video-download) | Download and decrypt episodes to playable MP4 files in user-owned storage. |
| [Hongguo Short Drama Video Downloader API to KVS](https://apify.com/spider_studio/hongguo-video-download-kvs) | Download and decrypt episodes to playable MP4 files in the run KVS without cloud-storage credentials. |

### Frequently asked questions

#### Can I get details and episode lists for multiple Hongguo series?

Yes. Submit up to 1,000 unique `seriesIds` in one run. Each successful row contains normalized `series` metadata and an `episodes` array for that title.

#### Where can I find a Hongguo `seriesId`?

Use the Hongguo Search or Recommendation Feed Actor. Both return `seriesId` values that can be sent directly to this Actor.

#### Does the Actor return every episode?

It returns the episode directory available for the requested series at run time. Availability can vary by title, and some valid series may currently contain no episodes.

#### Does this Actor return playable video URLs?

No. It returns series metadata and episode video IDs. The separate video Actors resolve media information for content you are authorized to process.

### Legal use and support

Use this Actor only for lawful purposes and respect Hongguo's terms, copyright, rate limits, privacy rules, and applicable law. It is intended for public catalog metadata and does not access private user accounts.

Use the **Issues** tab for support and the **API** tab for integration examples.

# Actor input Schema

## `seriesIds` (type: `array`):

Short-drama series IDs to resolve. Duplicates are ignored.

## Actor input object example

```json
{
  "seriesIds": [
    "7639686403294497854"
  ]
}
```

# Actor output Schema

## `dataset` (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 = {
    "seriesIds": [
        "7639686403294497854"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("spider_studio/hongguo-series-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 = { "seriesIds": ["7639686403294497854"] }

# Run the Actor and wait for it to finish
run = client.actor("spider_studio/hongguo-series-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 '{
  "seriesIds": [
    "7639686403294497854"
  ]
}' |
apify call spider_studio/hongguo-series-detail --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,spider_studio/hongguo-series-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/LK5aYN2jmG97wKWgH/builds/cPewz5hiKgJfCNhcM/openapi.json