Hongguo Short Drama Search & Data Scraper API

中文 | English

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

红果短剧搜索与数据爬虫 API是一款用于搜索 红果短剧（Hongguo Duanju）中国短剧的红果短剧搜索爬虫。你可以提交最多 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。重复关键词会被忽略，并保留第一次出现的顺序。

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

输出

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

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

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

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

相关红果短剧 Actor

Actor	用途
红果短剧推荐流 API	无需种子关键词即可发现热门短剧。
红果短剧关键词建议与自动补全 API	使用自动补全词和相关关键词扩展种子词。
红果短剧详情与剧集列表爬虫 API	将搜索结果中的 seriesId 转换为完整元数据和剧集视频 ID。
红果短剧最佳画质视频地址提取 API	为已授权的视频 ID 获取最佳地址和画质元数据。
红果短剧全部视频画质与地址提取 API	为已授权的视频 ID 获取全部画质和地址。
红果短剧视频下载与视频解密 API	下载并解密视频，将可播放 MP4 上传到用户自有存储。
红果短剧视频下载与解密到 Apify 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). 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.

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

Output

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

{
  "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	Discover trending short dramas without seed keywords.
Hongguo Short Drama Keyword Suggestions API	Expand seed terms with autocomplete and related keywords.
Hongguo Series Details & Episodes Scraper API	Turn a search result's seriesId into complete metadata and episode video IDs.
Hongguo Best Quality Video URL Extractor API	Resolve the best available URL and quality metadata for an authorized video ID.
Hongguo All Video Qualities & URL Extractor API	Retrieve every available quality and URL for an authorized video ID.
Hongguo Video Downloader & Decryption API	Download and decrypt videos to playable MP4 files in user-owned storage.
Hongguo Short Drama Video Downloader API to 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.