# Hongguo Episode Comments Scraper API (`spider_studio/hongguo-episode-comments`) Actor

Batch scrape Hongguo short drama episode comments, likes and reply counts. Set a comment limit per target and export JSON, CSV or Excel.

- **URL**: https://apify.com/spider_studio/hongguo-episode-comments.md
- **Developed by:** [Tarique](https://apify.com/spider_studio) (community)
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 comments

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

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

**Hongguo Episode Comments Scraper API** extracts public comments from [Hongguo Duanju (红果短剧)](https://www.hongguo.com/). 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](https://apify.com/spider_studio/hongguo-search) | Find dramas and series IDs by title or keyword / 搜索短剧 |
| 📚 [Hongguo Series Details & Episodes](https://apify.com/spider_studio/hongguo-series-detail) | Get drama information and episode IDs / 获取剧集详情与单集 ID |
| 💬 [Hongguo Series Comments](https://apify.com/spider_studio/hongguo-series-comments) | Collect the whole-drama comment section / 采集整剧评论 |
| 🎬 [Hongguo Episode Comments](https://apify.com/spider_studio/hongguo-episode-comments) | Collect comments for a specific episode / 采集单集评论 |
| 🔥 [Hongguo Recommendation Feed](https://apify.com/spider_studio/hongguo-recommend-feed) | Discover recommended short dramas / 发现推荐短剧 |
| 📅 [Hongguo Release Calendar](https://apify.com/spider_studio/hongguo-calendar) | Find releases by date / 按日期查找新剧 |
| 💡 [Hongguo Keyword Suggestions](https://apify.com/spider_studio/hongguo-search-suggest) | 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 |

```json
{
  "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。下面是简化格式示例，并非真实评论。

```json
{
  "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 和预期结果。请合法使用公开评论，遵守红果条款及适用的隐私规定。公开作者信息仍可能属于个人数据，请仅保留合法用途所需的信息。

# Actor input Schema

## `episodes` (type: `array`):

Enter 1 to 1000 objects with videoId and parent seriesId strings. Duplicate episodes are processed once in input order.

## `maxCommentsPerTarget` (type: `integer`):

Maximum unique comments per series or episode. Monthly quotas and run charge limits apply to the entire batch.

## Actor input object example

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

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "episodes": [
        {
            "videoId": "7460864933329112089",
            "seriesId": "7460844305129688126"
        },
        {
            "videoId": "7678238971456932889",
            "seriesId": "7678236482489830424"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("spider_studio/hongguo-episode-comments").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "episodes": [
        {
            "videoId": "7460864933329112089",
            "seriesId": "7460844305129688126",
        },
        {
            "videoId": "7678238971456932889",
            "seriesId": "7678236482489830424",
        },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("spider_studio/hongguo-episode-comments").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "episodes": [
    {
      "videoId": "7460864933329112089",
      "seriesId": "7460844305129688126"
    },
    {
      "videoId": "7678238971456932889",
      "seriesId": "7678236482489830424"
    }
  ]
}' |
apify call spider_studio/hongguo-episode-comments --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,spider_studio/hongguo-episode-comments"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ElgWvbASJAbCyhouC/builds/qWOs7GWfEFoukazXC/openapi.json