# Hongguo Short Drama Search & Data Scraper API (`spider_studio/hongguo-search`) Actor

Search Hongguo short dramas by title or keyword. Extract series cards, metadata, IDs, and pagination for up to 1,000 queries through an API or Dataset.

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

## Pricing

from $2.00 / 1,000 successful search pages

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-short-drama-search-and-data-scraper-api)

### 红果短剧搜索与数据爬虫 API

**红果短剧搜索与数据爬虫 API**是一款用于搜索 [红果短剧（Hongguo Duanju）](https://hongguoduanju.com/)中国短剧的**红果短剧搜索爬虫**。你可以提交最多 1,000 个剧名或关键词，获取包含短剧卡片、元数据、短剧 ID 和分页信息的结构化搜索结果。

它可以作为红果短剧 API 的替代方案，用于内容目录发现、剧名查询、关键词监控和短剧数据处理。

### 为什么使用红果短剧搜索爬虫？

- 单次运行搜索最多 1,000 个不重复的中文或多语言关键词。
- 使用 `maxPages` 为每个关键词采集多页结果。
- 保留完整搜索数据，方便读取当前和未来新增的字段。
- 查找可用于剧集详情工作流的红果 `seriesId`。
- 支持 JSON、CSV、Excel、XML 或 HTML 导出。
- 可连接 Apify API、定时任务、Webhook、Make、n8n 或云存储。

典型用途包括**红果短剧搜索**、中国短剧研究、剧名可用性检查、关键词与短剧匹配、竞品监控和创建可搜索的短剧目录。

### 可以提取哪些红果短剧搜索数据？

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `query` | string | 对应结果的搜索关键词。 |
| `success` | boolean | 当前结果页是否成功获取。 |
| `page` | integer | 关键词的结果页码。 |
| `hasMore` | boolean | 是否可能还有更多结果。 |
| `nextOffset` | integer 或 null | 结果中返回的下一页位置。 |
| `data` | object | 包含结果卡片和元数据的完整搜索响应。 |
| `error` | string 或 null | 获取失败时的错误信息。 |

### 如何按剧名或关键词搜索红果短剧？

1. 打开 Actor 的 **Input** 标签页。
2. 在 `queries` 中添加剧名、类型、题材、演员或其他关键词。
3. 使用 `maxPages` 设置每个关键词最多获取多少页。
4. 点击 **Start**。
5. 打开 Dataset 查看、筛选、下载或集成结果。

### 红果短剧搜索如何计费？

每 1,000 个成功搜索结果页收费 **2 美元**，即每个成功结果页 0.002 美元。`success: false` 的诊断数据不收费。每个关键词最多收费 `maxPages × 0.002 美元`；如果可用页数较少，实际费用也会降低。

### 输入

完整选项请查看 **Input** 标签页。`queries` 最多接受 1,000 项；`maxPages` 支持 1 到 20，默认值为 1。重复关键词会被忽略，并保留第一次出现的顺序。

```json
{
  "queries": ["重生", "都市短剧", "甜宠"],
  "maxPages": 3
}
```

### 输出

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

```json
{
  "query": "重生",
  "success": true,
  "page": 1,
  "hasMore": true,
  "nextOffset": 6,
  "data": {
    "message": "SUCCESS",
    "search_tabs": []
  },
  "error": null
}
```

### 红果短剧搜索与数据提取场景

- 按剧名、剧情关键词、类型或题材查找短剧。
- 在获取完整元数据和剧集列表前发现短剧 ID。
- 监控指定剧名是否出现在重要搜索词下。
- 创建用于编辑或市场研究的关键词与剧名数据集。
- 将红果搜索数据发送到仪表盘、数据库或 AI 分析工具。

### 相关红果短剧 Actor

| Actor | 用途 |
| --- | --- |
| [红果短剧推荐流 API](https://apify.com/spider_studio/hongguo-recommend-feed) | 无需种子关键词即可发现热门短剧。 |
| [红果短剧关键词建议与自动补全 API](https://apify.com/spider_studio/hongguo-search-suggest) | 使用自动补全词和相关关键词扩展种子词。 |
| [红果短剧详情与剧集列表爬虫 API](https://apify.com/spider_studio/hongguo-series-detail) | 将搜索结果中的 `seriesId` 转换为完整元数据和剧集视频 ID。 |
| [红果短剧最佳画质视频地址提取 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 个不重复查询，每个查询最多请求 20 页结果。重复关键词会被忽略，并保留第一次出现的顺序。

#### 这是红果短剧 API 的替代方案吗？

是。它把红果搜索结果转换为可通过 Apify API 访问的结构化 Dataset 数据，无需逐个手动搜索关键词。

#### 可以搜索中文吗？

可以。中文剧名和短语是主要使用场景，同时也支持其他有效的 Unicode 搜索文本。

#### 为什么返回页数少于 `maxPages`？

`maxPages` 是最多页数。当红果短剧表示没有更多结果时，采集会提前结束。

### 合法使用与支持

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

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

***

### Hongguo short drama search and data scraper API

**Hongguo Short Drama Search & Data Scraper API** is a **红果短剧 search scraper** for finding Chinese short dramas on [红果短剧 (Hongguo Duanju)](https://hongguoduanju.com/). Submit up to 1,000 titles or keywords and receive structured Hongguo search results with series cards, metadata, IDs, and pagination information.

It is useful as a Hongguo API alternative for catalog discovery, title lookup, keyword monitoring, and short-drama data pipelines.

### Why use this Hongguo search scraper?

- Search up to 1,000 unique Chinese or multilingual keywords in one run.
- Collect multiple pages for each keyword with the `maxPages` option.
- Preserve the complete result payload so newly available fields remain accessible.
- Find Hongguo `seriesId` values for episode-detail workflows.
- Export results to JSON, CSV, Excel, XML, or HTML.
- Integrate with the Apify API, schedules, webhooks, Make, n8n, or cloud storage.

Typical use cases include **红果短剧搜索**, Chinese short-drama research, title availability checks, keyword-to-series matching, competitor monitoring, and building a searchable drama catalog.

### What Hongguo search data can the API extract?

| Field | Type | Description |
| --- | --- | --- |
| `query` | string | Search keyword associated with the result. |
| `success` | boolean | Whether the page was retrieved successfully. |
| `page` | integer | Page number for the keyword. |
| `hasMore` | boolean | Whether more results may be available. |
| `nextOffset` | integer or null | Pagination value returned with the result. |
| `data` | object | Complete Hongguo search response containing result cards and metadata. |
| `error` | string or null | Error message for an unsuccessful page. |

### How to search Hongguo short dramas by title or keyword

1. Open the Actor's **Input** tab.
2. Add one or more titles, genres, tropes, actors, or other terms to `queries`.
3. Set `maxPages` to the maximum number of pages wanted for each keyword.
4. Click **Start**.
5. Open the Dataset to inspect, filter, download, or integrate the results.

### How much does Hongguo search cost?

FREE-tier users pay **$3 per 1,000 successful keyword pages** ($0.003 per successfully fetched page). Users on BRONZE, SILVER, GOLD, PLATINUM, and DIAMOND tiers continue to pay **$2 per 1,000** ($0.002 per page). Diagnostic rows with `success: false` are not charged. A keyword costs at most `maxPages ×` the applicable per-page price and can cost less when fewer pages are available.

### Input

See the **Input** tab for all options. `queries` accepts up to 1,000 entries. `maxPages` accepts 1 to 20 and defaults to 1. Duplicate keywords are ignored while their first-seen order is preserved.

```json
{
  "queries": ["重生", "都市短剧", "甜宠"],
  "maxPages": 3
}
```

### Output

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

```json
{
  "query": "重生",
  "success": true,
  "page": 1,
  "hasMore": true,
  "nextOffset": 6,
  "data": {
    "message": "SUCCESS",
    "search_tabs": []
  },
  "error": null
}
```

### Hongguo search scraper and data extraction use cases

- Find a short drama by title, plot keyword, genre, or trope.
- Discover series IDs before retrieving full metadata and episode lists.
- Monitor whether titles appear for important search phrases.
- Create keyword-to-title datasets for editorial or market research.
- Feed Hongguo search data into dashboards, databases, or AI analysis tools.

### Related Hongguo Actors

| Actor | Purpose |
| --- | --- |
| [Hongguo Short Drama Recommendation Feed API](https://apify.com/spider_studio/hongguo-recommend-feed) | Discover trending short dramas without seed keywords. |
| [Hongguo Short Drama Keyword Suggestions API](https://apify.com/spider_studio/hongguo-search-suggest) | Expand seed terms with autocomplete and related keywords. |
| [Hongguo Series Details & Episodes Scraper API](https://apify.com/spider_studio/hongguo-series-detail) | Turn a search result's `seriesId` into complete metadata and episode video IDs. |
| [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 video 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 video ID. |
| [Hongguo Video Downloader & Decryption API](https://apify.com/spider_studio/hongguo-video-download) | Download and decrypt videos 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 videos to playable MP4 files in the run KVS without cloud-storage credentials. |

### Frequently asked questions

#### Can I search multiple Hongguo titles and keywords in one run?

Yes. Submit up to 1,000 unique queries and request up to 20 result pages per query. Duplicate keywords are ignored while the first-seen order is preserved.

#### Is this a 红果短剧 API alternative?

Yes. The Actor turns Hongguo search results into structured Dataset items that can be accessed through the Apify API without manually browsing each keyword.

#### Can I search in Chinese?

Yes. Chinese titles and phrases are the primary use case, and other Unicode search terms are also accepted.

#### Why did a keyword return fewer pages than `maxPages`?

`maxPages` is a maximum. Collection stops earlier when Hongguo indicates that no additional results are available.

### Legal use and support

Use the Actor lawfully and respect Hongguo's terms, copyright, rate limits, privacy rules, and applicable law. It is intended for public catalog information and does not access private user accounts.

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

# Actor input Schema

## `queries` (type: `array`):

Keywords to search. Duplicates are ignored while order is preserved.

## `maxPages` (type: `integer`):

Maximum successful pages fetched for each unique keyword. Pagination stops earlier when Hongguo reports no more results.

## Actor input object example

```json
{
  "queries": [
    "重生",
    "都市短剧"
  ],
  "maxPages": 1
}
```

# 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 = {
    "queries": [
        "重生",
        "都市短剧"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("spider_studio/hongguo-search").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 = { "queries": [
        "重生",
        "都市短剧",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("spider_studio/hongguo-search").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 '{
  "queries": [
    "重生",
    "都市短剧"
  ]
}' |
apify call spider_studio/hongguo-search --silent --output-dataset

```

## MCP server setup

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

```

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/KXtcWqlzD21y56AZ7/builds/5NlULkWdhGoDkN6m8/openapi.json