# Hongguo Short Drama Keyword Suggestions API (`spider_studio/hongguo-search-suggest`) Actor

Extract Hongguo short drama autocomplete, keyword suggestions, and related searches for up to 1,000 queries. Export keyword data via API or Dataset.

- **URL**: https://apify.com/spider\_studio/hongguo-search-suggest.md
- **Developed by:** [NewLai](https://apify.com/spider_studio) (community)
- **Categories:** Automation, Videos, Social media
- **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 suggestion keywords

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?

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-keyword-suggestions-and-autocomplete-api)

### 红果短剧关键词建议与自动补全 API

**红果短剧关键词建议与自动补全 API**用于提取 [红果短剧（Hongguo Duanju）](https://hongguoduanju.com/)的自动补全、关键词建议和相关搜索数据。输入最多 1,000 个种子关键词，即可为每个不重复关键词获得一条结构化 Dataset 数据。

这款**红果短剧关键词爬虫**适用于搜索词研究、自动补全分析、内容规划和短剧发现。它可以作为简单的红果搜索建议 API 替代方案，通过 Apify Console、API、定时任务和集成工具使用。

### 为什么使用红果短剧关键词建议爬虫？

- 单次运行处理最多 1,000 个种子关键词。
- 获取红果短剧自动补全和相关搜索响应。
- 删除重复输入，同时保留第一次出现的位置。
- 保留完整建议数据，方便按业务需要解析。
- 支持 JSON、CSV、Excel、XML 或 HTML 导出。
- 可连接 Apify API、Webhook、Make、n8n 或自有应用。

它适用于**红果短剧关键词**、中国短剧 SEO 研究、搜索框分析、用户用词发现、内容目录探索，以及把少量种子词扩展为更多内容创意。

### 可以提取哪些红果搜索建议数据？

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `query` | string | 输入中的不重复种子关键词。 |
| `success` | boolean | 是否成功获取搜索建议数据。 |
| `data` | object | 完整的红果自动补全或相关搜索响应。 |
| `error` | string 或 null | 关键词处理失败时的错误信息。 |

### 如何获取红果短剧搜索建议？

1. 打开 Actor 的 **Input** 标签页。
2. 在 `queries` 中添加类型、题材、剧名片段等种子关键词。
3. 点击 **Start**。
4. 打开 Dataset，在成功结果中查看 `data`。
5. 下载结果，或将其发送到关键词研究流程。

### 红果关键词建议如何计费？

每 1,000 个成功处理的不重复关键词收费 **2 美元**，即每个成功关键词 0.002 美元。`success: false` 的诊断数据不收费，重复关键词不会产生额外结果费用。

### 输入

完整选项请查看 **Input** 标签页。支持 1 到 1,000 个关键词，每项最长 100 个字符。

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

### 输出

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

```json
{
  "query": "重生",
  "success": true,
  "data": {
    "message": "SUCCESS",
    "data": {}
  },
  "error": null
}
```

每个不重复输入关键词最多产生一条 Dataset 数据，因此可以方便地与原始种子词列表进行关联。

### 红果短剧关键词研究与 SEO 使用场景

- 将短剧主题扩展为相关搜索短语。
- 研究剧名片段、类型、角色设定和热门题材。
- 分析中国短剧内容规划中的自动补全用词。
- 发现可发送给红果短剧搜索 Actor 的新关键词。
- 定期追踪指定种子词的搜索建议变化。

### 相关红果短剧 Actor

| Actor | 用途 |
| --- | --- |
| [红果短剧推荐流 API](https://apify.com/spider_studio/hongguo-recommend-feed) | 无需种子关键词即可发现热门短剧。 |
| [红果短剧搜索与数据爬虫 API](https://apify.com/spider_studio/hongguo-search) | 将建议关键词转换为短剧结果和 `seriesId`。 |
| [红果短剧详情与剧集列表爬虫 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 个不重复种子词。每个成功处理的查询会生成一条 Dataset 数据，方便与原始关键词列表关联。

#### 搜索建议与普通搜索有什么区别？

搜索建议 Actor 返回自动补全和相关查询数据，适合关键词研究；普通搜索 Actor 返回短剧搜索结果页和短剧卡片。

#### 适合中文关键词研究吗？

适合。它主要面向红果短剧和中国短剧关键词，同时接受任何有效的 Unicode 文本。

#### 会删除重复关键词吗？

会。重复关键词只处理一次，并保留第一次出现的顺序。

### 合法使用与支持

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

如需帮助，请使用 **Issues** 标签页；程序化调用示例请查看 **API** 标签页。

***

### Hongguo short drama keyword suggestions and autocomplete API

**Hongguo Short Drama Keyword Suggestions API** extracts autocomplete, keyword suggestions, and related-search data from [红果短剧 (Hongguo Duanju)](https://hongguoduanju.com/). Enter up to 1,000 seed keywords and receive one structured Dataset item for every unique query.

This **红果短剧 keyword scraper** is designed for search-term research, autocomplete analysis, content planning, and short-drama discovery. It provides a simple Hongguo suggestions API alternative that works from the Apify Console, API, schedules, and integrations.

### Why use this Hongguo keyword suggestion scraper?

- Process up to 1,000 seed keywords in one run.
- Collect Hongguo autocomplete and related-search responses.
- Remove duplicate inputs while preserving the first occurrence.
- Keep the complete suggestion payload for flexible downstream parsing.
- Export data to JSON, CSV, Excel, XML, or HTML.
- Connect results to the Apify API, webhooks, Make, n8n, or your own application.

Use it for **红果短剧关键词**, Chinese short-drama SEO research, search-box analysis, audience-language discovery, catalog exploration, and expanding a small keyword list into new content ideas.

### What Hongguo suggestion data can the Actor extract?

| Field | Type | Description |
| --- | --- | --- |
| `query` | string | Unique seed keyword supplied in the input. |
| `success` | boolean | Whether suggestion data was retrieved successfully. |
| `data` | object | Complete Hongguo autocomplete or related-search response. |
| `error` | string or null | Error message for an unsuccessful keyword. |

### How to get Hongguo search suggestions and autocomplete keywords

1. Open the Actor's **Input** tab.
2. Add one or more seed terms to `queries`, such as a genre, trope, or title fragment.
3. Click **Start**.
4. Open the Dataset and inspect `data` for each successful keyword.
5. Download the results or send them to your keyword-research workflow.

### How much do Hongguo keyword suggestions cost?

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

### Input

See the **Input** tab for all options. The Actor accepts between 1 and 1,000 keywords, with a maximum length of 100 characters per entry.

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

### Output

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

```json
{
  "query": "重生",
  "success": true,
  "data": {
    "message": "SUCCESS",
    "data": {}
  },
  "error": null
}
```

Every unique input keyword produces at most one Dataset item, making it straightforward to join results back to the original seed list.

### Hongguo keyword research and SEO use cases

- Expand short-drama topics into related search phrases.
- Research title fragments, genres, character types, and popular tropes.
- Study autocomplete language for Chinese short-drama content planning.
- Find new queries to send to the Hongguo Short Drama Search API.
- Track how suggestions change for selected seed keywords over time.

### 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 Search & Data Scraper API](https://apify.com/spider_studio/hongguo-search) | Turn suggested keywords into short-drama results and series IDs. |
| [Hongguo Series Details & Episodes Scraper API](https://apify.com/spider_studio/hongguo-series-detail) | Turn a `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 collect Hongguo keyword suggestions in bulk?

Yes. Add up to 1,000 unique seed terms to one run. Each successfully processed query produces one Dataset row that can be joined back to the original keyword list.

#### What is the difference between Search Suggestions and Search?

Search Suggestions returns autocomplete and related-query data for keyword research. The separate Search Actor returns short-drama search-result pages and series cards.

#### Is this useful for Chinese keyword research?

Yes. It is optimized for 红果短剧 and Chinese short-drama queries, while accepting any valid Unicode text.

#### Does the Actor remove duplicate keywords?

Yes. A repeated keyword is processed once, and the order of first occurrence is preserved.

### Legal use and support

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

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

# Actor input Schema

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

Keywords for Hongguo suggestions. Duplicates are ignored while order is preserved.

## Actor input object example

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

# 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-suggest").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-suggest").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-suggest --silent --output-dataset

```

## MCP server setup

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

```

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/c9PdFBzn7PsDUsvSY/builds/dm2GrEoi7b1Grw9U3/openapi.json