Hongguo Short Drama Search & Data Scraper API

🔎 红果短剧搜索与数据采集 API / Hongguo Short Drama Search 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 Keyword Suggestions API — 自动补全与相关搜索词。 Autocomplete and related-query suggestions.
• 🔥 推荐短剧 / 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，返回可通过 Apify API 读取的搜索结果卡片、剧集信息和分页数据。每次最多提交 1,000 个关键词。

Hongguo Short Drama Search & Data Scraper API searches Hongguo Duanju by title, genre, or keyword and returns structured result cards, series metadata, and pagination data through Apify. Submit up to 1,000 search terms per run.

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

• 批量找剧： 按标题片段、人物、题材或剧情关键词搜索。 Bulk discovery: search title fragments, characters, genres, and plot keywords.
• 分页采集： 每个关键词最多请求 20 页。 Pagination: request up to 20 pages per keyword.
• 目录关联： 从搜索卡片提取可用的剧集 ID，再接入上方的剧集详情与转写工具。 Catalog workflows: use available series IDs with the Series Details and Transcript APIs above.
• 研究与监测： 保存关键词与剧集的对应关系，比较不同时间的搜索快照。 Research and monitoring: build keyword-to-series datasets and compare search snapshots over time.

🚀 如何使用 / How to search Hongguo dramas

1. 在 Input 的 queries 中填写关键词或剧名。 Enter keywords or titles in queries.
2. 设置每个关键词的最大页数 maxPages。 Set maxPages for each keyword.
3. 配置运行最高花费并点击 Start。 Set your maximum run spend and click Start.
4. 在 Dataset 查看结果，或通过 API 接入后续流程。 Read the Dataset or retrieve results through the API.

📥 输入参数 / Input parameters

参数 / Field	说明 / Description
queries	必填，1–1,000 个字符串，每项 1–100 个字符；重复关键词按首次出现顺序去重。 Required: 1–1,000 strings of 1–100 characters each; duplicates are removed in first-seen order.
maxPages	每个关键词的最大页数，1–20，默认 1。 Maximum pages per keyword: 1–20, default 1.

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

maxPages 是上限。若红果返回没有更多内容，采集会提前结束。中文和其他有效 Unicode 搜索词均可使用；完整校验规则见 Input 页。

maxPages is a ceiling. Collection stops earlier when Hongguo reports no more results. Chinese and other valid Unicode queries are accepted; see the Input tab for complete validation rules.

📤 搜索结果与字段 / Search output and fields

每个真实搜索结果卡片单独保存一行，并保留原始 data。以下是虚构的结构示例，不代表当前搜索结果或排名。

Each real search-result card is stored as a separate row with its original data. The fictional example below illustrates the structure, not current results or rankings.

{
  "query": "重生",
  "success": true,
  "page": 1,
  "offset": 0,
  "tabType": 11,
  "resultPosition": 1,
  "searchResultId": "7000000000000000001",
  "hasMore": true,
  "nextOffset": 6,
  "data": {
    "search_result_id": "7000000000000000001",
    "show_type": 369,
    "video_data": []
  },
  "error": null
}

字段 / Field	含义 / Meaning
query, success	原始搜索词和该行是否成功。 Original query and whether the row is successful.
page, offset, tabType	请求页与分页上下文。 Page and pagination context.
resultPosition, searchResultId	页面内从 1 开始的位置，以及红果返回的结果 ID。 One-based position on the page and upstream result ID.
hasMore, nextOffset	上游分页信息。 Upstream pagination information.
data	当前卡片的完整原始对象；不同卡片结构可能不同。 Complete raw card; structures can vary between cards.
error, errorCode	失败或配额诊断信息，可用时返回。 Failure or quota diagnostics when applicable.

Dataset 可通过通用导出界面下载为 JSON、CSV、Excel、HTML 或 XML，也可接入 API、定时任务、webhook、Make 或 n8n。

Use the Dataset export interface for JSON, CSV, Excel, HTML, or XML, or connect the API, schedules, webhooks, Make, or n8n.

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

Apify 套餐 / Plan	每个成功搜索结果 / Per successful result	每 1,000 个结果 / Per 1,000
FREE	$0.003	$3.00
BRONZE / SILVER / GOLD / PLATINUM / DIAMOND	$0.002	$2.00

按成功写入 Dataset 的真实搜索结果计费，不是按关键词或页数计费。结果须包含 search_result_id；插入的榜单模块、空页和 success: false 诊断行不收成功结果事件费。

Billing is per real result successfully written to the Dataset, not per keyword or page. Billable cards contain search_result_id; inserted ranking modules, empty pages, and success: false diagnostics do not incur successful-result event charges.

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

Apify Free-plan accounts can save up to 100 successful search 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

为什么返回页数少于 maxPages？ / Why are fewer pages returned?

因为 maxPages 只是请求上限。内容耗尽、运行预算或账户配额都可能让采集提前结束。

maxPages is only a request limit. Exhausted results, the run budget, or account quota can stop collection earlier.

如何从搜索结果获取台词？ / How do I get transcripts from search results?

先取得结果中的剧集 ID，再使用开头的转写工具。推荐传入 seriesIds，转写时会附加剧名和简介作为识别上下文。

Obtain the series ID from the result and use the Transcript API linked above. Series IDs are recommended because the title and introduction provide recognition context.

这些结果等于完整平台目录吗？ / Is this the complete Hongguo catalog?

不是。结果是当前关键词和分页请求返回的卡片，内容和排序可能随时间变化。

No. Results reflect the cards returned for the supplied queries and pages; availability and ordering can change over time.

🤝 维护与支持 / 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.