Hongguo Episode Comments Scraper API

Hongguo episode comments scraper and API / 红果短剧单集评论采集

Hongguo Episode Comments Scraper API extracts public comments from Hongguo Duanju (红果短剧). Enter a list of episodes with their parent series IDs, set your comment limit per episode, and export comment text, likes, reply counts and public author information for audience research.

红果短剧单集评论采集 API 用于获取指定单集评论区的公开观众反馈。输入包含单集 ID 与所属整剧 ID 的列表，并设置每集评论上限，即可导出评论原文、点赞数、回复数及可用的公开作者信息，供观众反馈研究使用。

🧭 Explore more Hongguo Actors / 更多红果工具

Build a short-drama research workflow with these related tools:

Actor	What you can do
🔎 Hongguo Short Drama Search	Find dramas and series IDs by title or keyword / 搜索短剧
📚 Hongguo Series Details & Episodes	Get drama information and episode IDs / 获取剧集详情与单集 ID
💬 Hongguo Series Comments	Collect the whole-drama comment section / 采集整剧评论
🎬 Hongguo Episode Comments	Collect comments for a specific episode / 采集单集评论
🔥 Hongguo Recommendation Feed	Discover recommended short dramas / 发现推荐短剧
📅 Hongguo Release Calendar	Find releases by date / 按日期查找新剧
💡 Hongguo Keyword Suggestions	Explore autocomplete and related searches / 获取搜索建议

Why collect Hongguo episode comments? / 适用场景

Explore viewer reactions to individual episodes, scenes and plot turns. Compare discussion across episodes, identify comments attracting engagement, or prepare datasets for your own sentiment and topic analysis.

研究观众对指定单集、场景与剧情转折的反应，比较不同集数的讨论，或关注互动较多的评论。导出的数据可用于你自己的情感分析与话题研究；本工具不直接提供情感评分或话题标签。

Run from Apify Console or the API tab. Use schedules for recurring collection and download results for spreadsheets, dashboards or other analysis tools.

支持从 Apify 控制台或 API 运行，也可配置定时任务，将结果用于表格、看板或其它分析工具。

How to scrape Hongguo episode comments / 使用步骤

1. Find a drama with Hongguo Search. Use Series Details & Episodes to get the episode video ID. / 使用短剧搜索查找作品。再通过剧集详情工具获取单集 videoId。
2. Add each videoId and parent seriesId pair to episodes. / 在 episodes 中逐项填写单集 videoId 和所属整剧 seriesId。
3. Set maxCommentsPerTarget and click Start. / 设置每个目标的最大评论数并点击 Start。
4. Open Dataset to review and download comments. / 在 Dataset 中查看和下载评论。
5. Check OUTPUT for the returned count and completion status. / 在 OUTPUT 摘要中确认返回数量与完成状态。

This Actor collects the comment sections of the episodes you list. Use Series Comments for the drama’s overall discussion.

本工具批量采集所列单集的评论区。研究整部作品的讨论，请使用上方的整剧评论工具。

Input / 输入参数

Each run accepts 1–1,000 episode objects. Add more entries to the list for batch collection. IDs must be quoted nonzero numeric strings without leading zeros. See the Input tab for all options.

每次运行支持 1–1,000 个单集对象，向列表中添加项目即可批量采集。ID 须为带引号的非零数字字符串，不带前导零。完整配置见 Input 页面。

Input / 参数	Required / 必填	Description / 说明
episodes	Yes / 是	List of objects, each containing videoId and parent seriesId / 对象列表，每项包含 videoId 与所属整剧 seriesId
maxCommentsPerTarget	No / 否	Maximum unique comments per episode; default 100, range 1–100,000 / 每个单集的最大去重评论数；默认 100，范围 1–100,000

{
  "episodes": [
    {
      "videoId": "7460864933329112089",
      "seriesId": "7460844305129688126"
    },
    {
      "videoId": "7678238971456932889",
      "seriesId": "7678236482489830424"
    }
  ],
  "maxCommentsPerTarget": 100
}

The example contains two targets; add or remove entries to choose your batch. Duplicate targets are processed once, in first-seen order. Every episode requires its own parent series ID. The same video ID cannot be paired with conflicting parent IDs. The limit applies to each target, while your monthly allowance and run charge limit cover the entire batch.

示例包含两个目标，可增删列表项来选择本次批量采集的对象。重复目标只处理一次，保留首次出现顺序。每个单集都必须填写所属整剧 ID，同一单集不能填写不同的所属整剧 ID。评论数量上限作用于每个目标，月度额度和单次费用上限则由整个批次共同使用。

maxCommentsPerTarget is an upper limit. Actual results depend on available comments. Targets are processed in input order; reaching the monthly allowance or charge limit skips the remaining targets. A failed target is recorded in the summary; other targets are attempted and the run reports failure if any target failed.

maxCommentsPerTarget 是上限，实际结果取决于可获取的评论。目标按输入顺序处理；达到月度额度或费用上限时，后续目标会跳过。单个目标失败会记录在摘要中，其它目标会继续尝试；存在失败目标时，整体运行报告失败。

Only batch input is accepted. Replace the former top-level seriesId, videoId and maxResults fields with the format above. Even a single target must be placed in a list.

仅支持上述批量输入格式。原有顶层 seriesId、videoId 和 maxResults 参数已移除；即使只采集一个目标，也需放入列表。

Output: Hongguo comment data / 输出数据

Each Dataset row represents one comment. Optional fields depend on what Hongguo makes available. Comment text stays in its original language.

Dataset 每条记录对应一条评论，可选字段取决于红果返回的信息。评论保留原文，不自动翻译。

Field / 字段	Description / 说明
commentId	Comment identifier / 评论 ID
text	Original comment text / 评论原文
seriesId, videoId	Associated drama and episode IDs, where available / 可用的整剧与单集 ID
createdAt	Unix timestamp in seconds, when available / 评论时间，Unix 秒级时间戳
likeCount, replyCount	Reported likes and replies / 点赞数与回复数
author	Public author information / 公开作者信息
images	Attached image information, when available / 可用的配图信息
offsetTimeMs	Playback position in milliseconds, when available / 可用的关联播放位置，单位毫秒

Download the dataset as JSON, HTML, CSV or Excel. The abbreviated example below illustrates the format; it is not a real comment.

可导出 JSON、HTML、CSV 或 Excel。下面是简化格式示例，并非真实评论。

{
  "commentId": "1234567890123456789",
  "scope": "episode",
  "text": "Example audience comment",
  "likeCount": 12,
  "replyCount": 2,
  "author": {"name": "Example viewer"}
}

The OUTPUT summary includes batch totals (returnedCount, processedTargets, failedTargets, skippedTargets), overall success and stopReason, plus a targets list containing each target’s IDs, count and completion status. Check completion before using a collection as a full sample; an interrupted or failed run may contain partial results.

OUTPUT 摘要包含批量总评论数、已处理目标数、失败目标数、跳过目标数、整体状态和停止原因，并通过 targets 列表分别记录每个目标的 ID、评论数与完成状态。使用数据前请确认运行是否完成；中断或失败的运行可能只返回部分结果。

How much does comment collection cost? / 费用说明

FREE-plan users pay $0.002 per comment ($2 per 1,000). All paid-plan users pay $0.001 per comment ($1 per 1,000). Only unique comments successfully saved in the current run are charged. Empty results and repeated comments within the same run do not incur comment charges. A new run collecting the same comment is charged again.

Apify 免费套餐用户每条评论 $0.002（每千条 $2），所有付费套餐用户每条 $0.001（每千条 $1）。仅对本次运行成功保存的去重评论计费，空结果和本次运行内的重复评论不收取评论费。新运行再次采集同一条评论会重新计费。

FREE-plan users can retrieve 100 comments per Actor per UTC calendar month, across all runs. Series Comments and Episode Comments have separate allowances: using one does not reduce the other. The quota resets at 00:00 UTC on the first day of each month. Paid-plan users have no monthly product quota.

免费套餐用户在每个 UTC 自然月内，每个 Actor 最多获取 100 条评论，多次运行累计计算。整剧评论与单集评论分别计限额，互不占用。额度在每月 1 日 UTC 00:00 重置。付费套餐用户不受这项月度产品限额限制。

Collection stops at your result limit, monthly allowance or run charge limit. Check OUTPUT.stopReason for completion details; free_tier_monthly_quota means the monthly allowance stopped collection. The summary is not charged as a comment.

达到结果数量、月度额度或单次费用上限时，采集停止。可通过 OUTPUT.stopReason 查看原因；free_tier_monthly_quota 表示月度额度已用尽。运行摘要不作为评论收费。

Apify platform usage is charged separately, including compute, proxy and storage usage, according to the effective Pricing tab. Start with a small result limit to evaluate your total cost.

Apify 平台用量费用另计，包括计算、代理与存储费用，具体以生效的 Pricing 页面为准。建议先少量运行，评估总成本。

Frequently asked questions / 常见问题

Where can I find a episode ID? / 去哪里查找单集 ID？

Find the drama with Hongguo Search, then use Series Details & Episodes to retrieve episode video IDs. These tools are linked near the top of this page.

先使用短剧搜索找到作品，再通过剧集详情工具获取单集 videoId。相关工具链接位于本页靠前的位置。

Are replies included? / 是否采集楼中楼回复？

The output includes a reported reply count. Reply threads are not collected separately.

输出包含回复数量，但不单独采集楼中楼回复内容。

Will I receive exactly the requested number? / 一定返回指定数量吗？

The Actor returns up to maxCommentsPerTarget unique comments per target. Source availability can change, so results may be fewer and do not guarantee every comment ever posted.

每个目标最多返回 maxCommentsPerTarget 条去重评论。评论可见性和可获取数量会变化，因此可能少于上限，也不保证包含历史上发布的所有评论。

Can I use an API or schedule? / 支持 API 和定时运行吗？

Yes. Open the API tab for execution examples, or configure an Apify schedule to collect fresh samples over time.

支持。在 API 页面查看调用示例，或通过 Apify 定时任务持续采集新的评论样本。

Support and responsible use / 支持与使用须知

Report problems through the Issues tab with your run ID and expected result. Use public comments lawfully and respect Hongguo’s terms and applicable privacy rules. Public author information may contain personal data; retain only what you need for your permitted purpose.

遇到问题请在 Issues 页面提供运行 ID 和预期结果。请合法使用公开评论，遵守红果条款及适用的隐私规定。公开作者信息仍可能属于个人数据，请仅保留合法用途所需的信息。