Hongguo Short Drama Keyword Suggestions API

💡 红果关键词建议与自动补全 API / Hongguo Keyword Suggestions API

🔗 配套红果工具 / Related Hongguo APIs

• 🎙️ 台词转写 / Hongguo Transcript API — 对白、时间轴、说话人及首句 hooks。 Dialogue, timestamps, speaker labels, and opening-sentence hooks.
• 📚 剧集详情 / Hongguo Series Details API — 剧集元数据和单集 ID。 Series metadata and episode IDs.
• 🔎 短剧搜索 / Hongguo Search API — 按剧名或关键词查找剧集。 Find dramas by title or keyword.
• 🔥 推荐短剧 / Hongguo Recommendation Feed API — 发现推荐内容和剧集 ID。 Discover recommended titles and series IDs.
• 📅 上新日历 / Hongguo Release Calendar API — 按日期查看新剧与待上线内容。 Explore releases and upcoming titles by date.
• 💬 整剧评论 / Hongguo Series Comments API — 获取整剧评论区的观众反馈。 Collect audience feedback from a drama’s series comment section.
• 🎬 单集评论 / Hongguo Episode Comments API — 使用单集 ID 和所属整剧 ID 获取评论。 Collect episode comments using the video ID and parent series ID.

红果关键词建议 API 从 红果短剧 Hongguo Duanju 获取自动补全和相关搜索数据。每次最多输入 1,000 个种子关键词，每个去重后的查询返回一条结果。

Hongguo Short Drama Keyword Suggestions API retrieves autocomplete and related-search data from Hongguo Duanju. Supply up to 1,000 seed keywords per run and receive one result per unique query.

✨ 功能与使用场景 / Features and use cases

• 扩展搜索词： 从题材、人物类型或剧名片段寻找相关表达。 Query expansion: explore related wording from genres, character types, or title fragments.
• 内容研究： 观察红果搜索建议，辅助中文短剧选题与关键词规划。 Content research: study Hongguo suggestions for Chinese short-drama topic and keyword planning.
• 批量处理： 自动去除重复输入，保留原始建议响应。 Batch collection: deduplicate input terms and preserve the original suggestion response.
• 衔接找剧： 把建议词交给上方搜索工具，再获取剧集详情或台词。 Discovery workflows: send suggested terms to Search, then obtain series details or transcripts.

🚀 如何获取关键词建议 / How to collect keyword suggestions

1. 在 Input 的 queries 中填写种子词。 Enter seed terms in queries.
2. 设置运行最高花费并点击 Start。 Set your maximum run spend and click Start.
3. 在 Dataset 中查看每个成功查询的 data。 Inspect data for each successful query in the Dataset.
4. 导出建议，或通过 API 送入搜索与分析流程。 Export suggestions or use the API in a discovery workflow.

📥 输入参数 / Input parameters

参数 / Field	说明 / Description
queries	必填，1–1,000 个关键词字符串，每项 1–100 个字符。 Required: 1–1,000 keyword strings, each 1–100 characters long.

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

重复关键词只处理一次，并保留首次出现的顺序。支持中文和其他有效 Unicode 文本；完整限制见 Input 页。

Duplicate keywords are processed once in first-seen order. Chinese and other valid Unicode text are accepted; see the Input tab for full limits.

📤 建议结果与字段 / Suggestion output and fields

每个唯一查询最多对应一行 Dataset。data 保留完整上游响应，便于按需提取建议词。以下为结构示例，不代表实时建议内容。

Each unique query produces at most one Dataset row. data preserves the full upstream response for flexible suggestion parsing. This example illustrates the structure, not live suggestions.

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

字段 / Field	含义 / Meaning
query	去重后的种子关键词。 Unique seed keyword.
success	是否成功取得该查询的响应。 Whether the query response was retrieved successfully.
data	完整自动补全或相关搜索响应。 Complete autocomplete or related-search response.
error, errorCode	错误或配额诊断，可用时返回。 Error or quota diagnostics when applicable.

可通过 Dataset 导出 JSON、CSV、Excel、HTML 或 XML，也可通过 Apify API、定时任务、webhook、Make 或 n8n 使用结果。

Export JSON, CSV, Excel, HTML, or XML from the Dataset, or use results with the Apify API, schedules, webhooks, Make, or n8n.

💳 价格与月度配额 / Pricing and monthly quota

Apify 套餐 / Plan	每个成功关键词 / Per successful keyword	每 1,000 个关键词 / Per 1,000
FREE	$0.003	$3.00
BRONZE / SILVER / GOLD / PLATINUM / DIAMOND	$0.002	$2.00

按成功处理并写入的唯一关键词计费，不是按返回的建议词数量计费。重复关键词不重复产生结果费用，success: false 诊断行不收成功结果事件费。

Billing is per unique keyword successfully processed and saved, not per individual suggestion returned. Duplicate keywords do not create additional result charges, and success: false diagnostics incur no successful-result event fee.

Apify Free 账户每个 UTC 自然月最多保存 100 个成功关键词结果，每月 1 日 00:00 UTC 重置。付费账户不受这项产品月度配额限制。FREE 是账户套餐名称，不代表这些结果免费。

Apify Free-plan accounts can save up to 100 successful keyword results per UTC calendar month, resetting at 00:00 UTC on the first day of the month. Paid plans have no such product quota. FREE is the account-plan name; it does not mean the results are free.

达到月度配额时，Actor 会返回不收结果事件费的 FREE_TIER_MONTHLY_QUOTA_REACHED 诊断行，并提供配额或重置相关信息。请结合最终运行状态判断是否采集完整。

When the monthly quota is reached, the Actor returns an uncharged FREE_TIER_MONTHLY_QUOTA_REACHED diagnostic row with quota or reset information. Check the final run status before treating the collection as complete.

平台用量另计。 除结果事件费外，Apify 会另行收取适用的计算、代理、存储和流量费用。空结果或失败请求可能产生平台用量，但不产生成功结果事件费。启动前请查看 Pricing 页和运行花费上限。

Platform usage is charged separately. Applicable Apify compute, proxy, storage, and transfer charges are additional to result-event fees. Empty or failed requests may consume platform resources without successful-result event charges. Check the Pricing tab and your maximum run spend before starting.

❓ 常见问题 / Frequently asked questions

和短剧搜索 API 有什么区别？ / How is this different from Search?

本 Actor 返回关键词建议和相关查询响应。搜索 Actor 接受关键词并返回短剧搜索结果与剧集卡片。

This Actor returns keyword suggestions and related-query responses. Search accepts keywords and returns drama search results and series cards.

可以直接拿这些关键词转写吗？ / Can I submit these keywords for transcription?

不能直接提交。先通过搜索工具取得剧集 ID，再交给转写工具；转写 Actor 接受剧集或单集 ID。

Not directly. Use Search to obtain series IDs, then pass them to the Transcript API, which accepts series or episode IDs.

返回搜索量或关键词排名吗？ / Does this provide search volume or keyword rankings?

本 Actor 采集建议响应，不提供搜索量测算或独立排名统计。可保存多次结果来比较建议变化。

The Actor collects suggestion responses; it does not calculate search volume or independent ranking metrics. Save multiple runs to compare how suggestions change.

🤝 维护与支持 / Maintainer and support

由 spider_studio 维护。请在 Issues 页提供运行链接和错误信息，API 页提供程序化调用示例。请遵守红果平台条款、版权、隐私要求及适用法律，在授权范围内使用数据。

Maintained by spider_studio. Include the run URL and error details in the Issues tab; see the API tab for integration examples. Use the data within your authorization and comply with Hongguo's terms, copyright, privacy requirements, and applicable law.

文档更新：2026-11-05。 / Documentation updated: November 5, 2026.