Hongguo Series Details & Episodes Scraper API

中文 | English

红果短剧详情与剧集列表爬虫 API

红果短剧详情与剧集列表爬虫 API用于获取 红果短剧（Hongguo Duanju）完整短剧元数据和剧集目录。提交一个或多个 seriesId，即可提取剧名、简介、封面、播放量、集数、首集视频 ID 和标准化剧集列表。

它可以作为红果短剧详情 API 的替代方案，用于内容目录补全、剧集发现、元数据数据库，以及需要建立短剧与各集视频 ID 对应关系的工作流。单次运行最多支持 1,000 个不重复短剧 ID。

为什么使用红果短剧剧集列表爬虫？

• 一次获取最多 1,000 部短剧的完整元数据。
• 为每部成功获取的短剧提取标准化剧集列表。
• 返回各集的视频 ID、集数、标题、封面、时长和可用状态。
• 保留完整详情数据，方便读取标准字段之外的信息。
• 单个短剧失败不会影响其他成功结果。
• 支持 JSON、CSV、Excel、XML 或 HTML 导出。
• 可通过 Apify API、定时任务、Webhook、Make 或 n8n 自动化。

常见用途包括红果短剧剧集详情、中国短剧目录、剧集索引、短剧元数据补全、内容研究和已授权的视频处理准备。

可以提取哪些短剧和剧集数据？

字段	类型	说明
seriesId	string	请求的红果短剧 ID。
success	boolean	是否成功获取短剧详情。
series	object	剧名、简介、封面、播放量、集数、平台和首集视频 ID。
episodes	array	包含视频 ID、集数、标题、封面、时长和状态的剧集目录。
data	object	完整的红果短剧详情数据。
error	string 或 null	短剧不可用时的错误信息。

如何获取完整的红果短剧剧集列表？

1. 通过红果搜索 Actor、推荐流 Actor 或其他授权来源找到 seriesId。
2. 打开此 Actor 的 Input 标签页。
3. 在 seriesIds 中添加一个或多个短剧 ID。
4. 点击 Start。
5. 打开 Dataset，在成功结果中读取 series 和 episodes。

红果短剧详情如何计费？

每 1,000 个成功解析的不重复短剧 ID 收费 2 美元，即每个成功 ID 0.002 美元。success: false 的诊断数据不收费，重复输入 ID 不会产生额外结果费用。

输入

完整校验规则请查看 Input 标签页。支持提交 1 到 1,000 个短剧 ID。

{
  "seriesIds": [
    "7639686403294497854"
  ]
}

输出

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

{
  "seriesId": "7639686403294497854",
  "success": true,
  "series": {
    "title": "示例短剧",
    "episodeCount": 80,
    "firstVideoId": "7639688323115519038"
  },
  "episodes": [
    {
      "videoId": "7639688323115519038",
      "episodeIndex": "1"
    }
  ],
  "error": null
}

红果短剧详情与剧集数据使用场景

• 创建可搜索的中国短剧与剧集数据库。
• 使用封面、简介、播放量和剧集目录补全搜索结果。
• 将红果短剧 ID 映射到所有可用的剧集视频 ID。
• 监控指定短剧的集数或元数据变化。
• 为已授权的媒体分析或转录任务准备结构化输入。

相关红果短剧 Actor

Actor	用途
红果短剧推荐流 API	发现热门短剧及其 seriesId。
红果短剧关键词建议与自动补全 API	发现自动补全词和相关关键词。
红果短剧搜索与数据爬虫 API	按关键词查找短剧和 seriesId。
红果短剧最佳画质视频地址提取 API	为已授权的剧集 ID 获取最佳地址和画质元数据。
红果短剧全部视频画质与地址提取 API	为已授权的剧集 ID 获取全部画质和地址。
红果短剧视频下载与视频解密 API	下载并解密剧集，将可播放 MP4 上传到用户自有存储。
红果短剧视频下载与解密到 Apify KVS	无需对象存储凭证，下载并解密剧集，将可播放 MP4 保存到运行 KVS。

常见问题

可以批量获取多部红果短剧的详情和剧集列表吗？

可以。单次运行最多提交 1,000 个不重复 seriesIds。每条成功结果都包含标准化 series 元数据和该短剧的 episodes 数组。

从哪里获取红果 seriesId？

可以使用红果搜索 Actor 或推荐流 Actor，它们返回的 seriesId 可以直接传给此 Actor。

会返回全部剧集吗？

它会返回运行时可获取的剧集目录。不同短剧的可用情况可能不同，部分有效短剧当前也可能没有剧集数据。

会返回可播放视频地址吗？

不会。此 Actor 返回短剧元数据和剧集视频 ID。对于你有权处理的内容，可以使用单独的视频 Actor 获取媒体信息。

合法使用与支持

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

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

---

Hongguo series details and episodes scraper API

Hongguo Series Details & Episodes Scraper API is a 红果短剧 series scraper that retrieves complete short-drama metadata and episode lists from 红果短剧 (Hongguo Duanju). Provide one or more seriesId values to extract titles, synopses, covers, play counts, episode counts, first video IDs, and normalized episode directories.

The Actor works as a Hongguo series details API alternative for catalog enrichment, episode discovery, metadata databases, and workflows that need reliable links between a series and its individual episode video IDs. Up to 1,000 unique series IDs can be submitted in one run.

Why use this Hongguo episode list scraper?

• Get complete metadata for up to 1,000 short-drama series at once.
• Extract a normalized episode list for each successful series.
• Receive episode video IDs, indexes, titles, covers, durations, and availability flags.
• Preserve the complete source response for fields beyond the normalized schema.
• Keep failures isolated to their corresponding series IDs.
• Export results to JSON, CSV, Excel, XML, or HTML.
• Automate collection through the Apify API, schedules, webhooks, Make, or n8n.

Popular use cases include 红果短剧剧集详情, Chinese short-drama catalogs, episode indexing, series metadata enrichment, content research, and preparing authorized video-processing workflows.

What Hongguo series and episode data can the API extract?

Field	Type	Description
seriesId	string	Requested Hongguo series identifier.
success	boolean	Whether series details were retrieved.
series	object	Title, synopsis, cover, play count, episode count, platform, and first video ID.
episodes	array	Episode directory with video IDs, indexes, titles, covers, durations, and status flags.
data	object	Complete Hongguo series-detail response.
error	string or null	Error message for an unavailable series.

How to get a complete Hongguo short-drama episode list

1. Find a seriesId using the Hongguo Search Actor, Recommendation Feed Actor, or another authorized source.
2. Open this Actor's Input tab.
3. Add one or more values to seriesIds.
4. Click Start.
5. Open the Dataset and read series and episodes from successful rows.

How much do Hongguo series details cost?

FREE-tier users pay $3 per 1,000 successfully resolved series IDs ($0.003 per successful unique ID). Users on BRONZE, SILVER, GOLD, PLATINUM, and DIAMOND tiers continue to pay $2 per 1,000 ($0.002 per ID). Diagnostic rows with success: false are not charged, and duplicate input IDs do not generate additional result charges.

Input

See the Input tab for complete validation details. You can submit between 1 and 1,000 series IDs.

{
  "seriesIds": [
    "7639686403294497854"
  ]
}

Output

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

{
  "seriesId": "7639686403294497854",
  "success": true,
  "series": {
    "title": "示例短剧",
    "episodeCount": 80,
    "firstVideoId": "7639688323115519038"
  },
  "episodes": [
    {
      "videoId": "7639688323115519038",
      "episodeIndex": "1"
    }
  ],
  "error": null
}

Hongguo series details and episode data use cases

• Build a searchable database of Chinese short dramas and episodes.
• Enrich search results with covers, summaries, counts, and episode directories.
• Map a Hongguo series ID to all available episode video IDs.
• Monitor episode-count or metadata changes for selected titles.
• Prepare structured inputs for authorized media analysis or transcription.

Related Hongguo Actors

Actor	Purpose
Hongguo Short Drama Recommendation Feed API	Discover trending short dramas and their series IDs.
Hongguo Short Drama Keyword Suggestions API	Discover autocomplete and related keywords.
Hongguo Short Drama Search & Data Scraper API	Find short dramas and series IDs by keyword.
Hongguo Best Quality Video URL Extractor API	Resolve the best available URL and quality metadata for an authorized episode ID.
Hongguo All Video Qualities & URL Extractor API	Retrieve every available quality and URL for an authorized episode ID.
Hongguo Video Downloader & Decryption API	Download and decrypt episodes to playable MP4 files in user-owned storage.
Hongguo Short Drama Video Downloader API to KVS	Download and decrypt episodes to playable MP4 files in the run KVS without cloud-storage credentials.

Frequently asked questions

Can I get details and episode lists for multiple Hongguo series?

Yes. Submit up to 1,000 unique seriesIds in one run. Each successful row contains normalized series metadata and an episodes array for that title.

Where can I find a Hongguo seriesId?

Use the Hongguo Search or Recommendation Feed Actor. Both return seriesId values that can be sent directly to this Actor.

Does the Actor return every episode?

It returns the episode directory available for the requested series at run time. Availability can vary by title, and some valid series may currently contain no episodes.

Does this Actor return playable video URLs?

No. It returns series metadata and episode video IDs. The separate video Actors resolve media information for content you are authorized to process.

Legal use and support

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

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