Hongguo Series Details & Episodes Scraper API

📚 红果剧集详情与单集目录 API / Hongguo Series Details & Episodes API

🔗 配套红果工具 / Related Hongguo APIs

• 🎙️ 台词转写 / Hongguo Transcript API — 对白、时间轴、说话人及首句 hooks。 Dialogue, timestamps, speaker labels, and opening-sentence hooks.
• 🔎 短剧搜索 / Hongguo Search API — 按剧名或关键词查找剧集。 Find dramas by title or keyword.
• 💡 关键词建议 / 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 根据剧集 ID 获取 红果短剧 Hongguo Duanju 的标题、简介、封面、播放数据及可用单集目录。每次支持 1–1,000 个剧集 ID，便于关联剧集和单集视频。

Hongguo Series Details & Episodes Scraper API retrieves titles, synopses, covers, available playback metadata, and episode directories from Hongguo Duanju by series ID. Submit 1–1,000 series IDs per run to map dramas to their episode videos.

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

• 补全剧集资料： 获取简介、封面、集数和首集 ID。 Catalog enrichment: collect synopses, covers, episode counts, and first episode IDs.
• 建立单集索引： 获取视频 ID、集序、标题、时长及可用的状态信息。 Episode indexing: obtain video IDs, episode order, titles, durations, and available status details.
• 批量查询： 去重输入 ID，并分别记录每部剧的成功或失败结果。 Batch lookup: deduplicate input IDs and report each series independently.
• 衔接台词转写： 推荐把 seriesId 交给开头的转写工具，自动利用剧名和简介作为上下文。 Transcription workflow: use series IDs with the Transcript API above to include title and introduction context.

🚀 如何获取剧集与单集目录 / How to retrieve series and episode details

1. 从搜索、推荐或日历工具获取 seriesId。 Obtain a series ID from Search, Recommendations, or Calendar.
2. 在 Input 的 seriesIds 中添加一个或多个剧集 ID。 Add one or more IDs to seriesIds.
3. 设置运行预算并点击 Start。 Set the run budget and click Start.
4. 在 Dataset 的 series 和 episodes 中查看资料。 Inspect series and episodes in the Dataset.

📥 输入参数 / Input parameters

参数 / Field	说明 / Description
seriesIds	必填，1–1,000 个剧集 ID 字符串，重复项会去重。 Required: 1–1,000 series-ID strings; duplicates are removed.

{
  "seriesIds": ["7678236482489830424"]
}

在 2026-11-05 的实测中，7678236482489830424 对应《垂竿向晚》，7678238971456932889 是其首集视频 ID。本 Actor 的输入使用前者；后者出现在返回的单集目录中。可用性可能变化，完整规则见 Input 页。

During testing on November 5, 2026, 7678236482489830424 identified 垂竿向晚 and 7678238971456932889 identified its first episode. This Actor accepts the former; the latter appears in the returned episode directory. Availability can change; see Input for complete rules.

📤 剧集详情输出 / Series-details output

每个唯一输入剧集最多返回一行。以下为虚构的结构示例；实际结果还会包含更多元数据和完整原始响应。

Each unique input series produces at most one row. The fictional example below illustrates the structure; actual results include additional metadata and the complete original response.

{
  "seriesId": "7000000000000000001",
  "success": true,
  "series": {
    "title": "示例短剧",
    "intro": "一个关于重新开始的故事。",
    "episodeCount": "80",
    "firstVideoId": "7000000000000000002"
  },
  "episodes": [
    {
      "seriesId": "7000000000000000001",
      "videoId": "7000000000000000002",
      "episodeIndex": "1",
      "title": "第一集",
      "duration": "120"
    }
  ],
  "error": null
}

字段 / Field	含义 / Meaning
seriesId, success	请求的剧集 ID 与是否成功取得详情。 Requested series ID and whether details were retrieved successfully.
series	标题、简介、封面、播放信息、集数、首集 ID 等。 Title, synopsis, cover, playback metadata, episode count, first episode ID, and more.
episodes	单集目录，含视频 ID、集序、标题、时长和可用的状态信息。 Episode directory with IDs, order, titles, durations, and available status details.
data	完整原始剧集详情响应。 Complete original series-details response.
error, errorCode	不可用剧集或配额限制的诊断，可用时返回。 Diagnostics for unavailable series or quota limits when applicable.

可导出 JSON、CSV、Excel、HTML 或 XML，并通过 Apify API、定时任务、webhook、Make 或 n8n 接入目录与分析流程。

Export JSON, CSV, Excel, HTML, or XML and use the Apify API, schedules, webhooks, Make, or n8n in catalog and analysis workflows.

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

Apify 套餐 / Plan	每个成功剧集 ID / Per successfully resolved series	每 1,000 部剧 / Per 1,000
FREE	$0.003	$3.00
BRONZE / SILVER / GOLD / PLATINUM / DIAMOND	$0.002	$2.00

按成功取得并保存详情的唯一剧集 ID 计费，不按目录里的单集数计费。重复输入和 success: false 诊断行不收成功结果事件费。

Billing is per unique series ID successfully resolved and saved, not per episode listed in its directory. Duplicate inputs and success: false diagnostics do not incur successful-result event fees.

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

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

会返回全部单集吗？ / Does it return every episode?

返回请求时上游提供的可用目录。剧集可能尚未上线、暂不可用或尚无单集，因此不能保证所有 ID 都有完整可播放内容。

It returns the directory supplied upstream at request time. Titles may be upcoming, unavailable, or have no episodes yet, so not every ID is guaranteed to have a complete playable catalog.

能只传单集 videoId 查询吗？ / Can I supply an episode videoId instead?

本 Actor 要求剧集 seriesId，单集 videoId 是输出的一部分。请先通过搜索、推荐或日历取得剧集 ID。

This Actor requires series IDs; episode video IDs are part of its output. Obtain the series ID through Search, Recommendations, or Calendar first.

会返回视频文件或台词吗？ / Does it return video files or dialogue?

本 Actor 提供剧集元数据和目录。需要台词时，可把剧集 ID 传给开头的转写工具。

This Actor returns series metadata and directories. For dialogue, pass the series ID to the Transcript API linked at the top.

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