# Hongguo Short Drama Recommendation Feed API (`spider_studio/hongguo-recommend-feed`) Actor

Scrape Hongguo short drama recommendations, trending titles, covers, episode counts, series IDs, and first video IDs. Export results via API or Dataset.

- **URL**: https://apify.com/spider\_studio/hongguo-recommend-feed.md
- **Developed by:** [NewLai](https://apify.com/spider_studio) (community)
- **Categories:** Automation, Social media, Videos
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 successful results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[中文](#红果短剧推荐流爬虫与-api) | [English](#hongguo-short-drama-recommendation-scraper-and-feed-api)

### 红果短剧推荐流爬虫与 API

**红果短剧推荐流**是一款用于发现 [红果短剧（Hongguo Duanju）](https://hongguoduanju.com/)推荐内容的**红果短剧爬虫和推荐 API**。它会为每部短剧输出一条结构化 Dataset 数据，包括剧名、封面、简介、集数、短剧 ID、首集视频 ID 和推荐标签。

当你需要获取红果短剧推荐、热门中国短剧、内容发现数据，或者希望用机器可读数据代替手动浏览推荐页时，可以使用此 Actor。它只提取元数据，不下载或分发剧集视频。

### 为什么使用红果短剧推荐流？

- 无需准备关键词即可发现推荐短剧。
- 单次运行最多请求 5,000 条不重复推荐结果。
- 获取适合研究、监控和内容目录的标准化短剧数据。
- 获得可用于其他红果 Actor 的 `seriesId` 和 `firstVideoId`。
- 通过 `includeRaw` 保留原始推荐对象，方便读取额外字段。
- 支持 Apify API、定时任务、Webhook、Make 和 n8n 自动化。
- 可将结果下载为 JSON、CSV、Excel、XML 或 HTML。

常见用途包括**红果短剧推荐监控**、中国短剧发现、内容研究、剧名追踪、目录补全以及创建红果短剧数据集。

### 可以提取哪些红果短剧推荐数据？

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `position` | integer | 短剧在本次运行中首次出现的位置。 |
| `seriesId` | string | 红果短剧的短剧 ID。 |
| `title` | string | 短剧名称。 |
| `intro` | string | 可用时返回剧情简介。 |
| `coverUrl` | string | 封面图片地址。 |
| `episodeCount` | integer | 短剧总集数。 |
| `firstVideoId` | string | 第一集的视频 ID。 |
| `recommendReasons` | array | 推荐或热度标签。 |
| `raw` | object | 启用时返回原始推荐数据。 |

### 如何获取红果短剧推荐？

1. 打开 Actor 的 **Input** 标签页。
2. 使用 `maxResults` 设置最多需要多少条不重复推荐。
3. 选择是否在 `raw` 中包含原始数据。
4. 点击 **Start**。
5. 打开 Dataset 查看、下载结果，或把结果发送到其他服务。

### 红果短剧推荐提取如何计费？

每 1,000 条成功推荐结果收费 **2 美元**，即每条成功结果 0.002 美元。`success: false` 的诊断数据不收费。只需要少量样本时，可以设置较小的 `maxResults`。

### 输入

完整选项请查看 **Input** 标签页。`maxResults` 支持 1 到 5,000，默认值为 50；重复短剧不会计入成功结果数量。

```json
{
  "maxResults": 50,
  "includeRaw": true
}
```

### 输出

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

```json
{
  "success": true,
  "position": 1,
  "seriesId": "7639686403294497854",
  "title": "示例短剧",
  "intro": "一部热门短剧的剧情简介",
  "coverUrl": "https://example.com/cover.jpg",
  "episodeCount": 80,
  "firstVideoId": "7639688323115519038",
  "recommendReasons": ["热播推荐"],
  "error": null
}
```

### 红果短剧推荐数据使用场景

- 追踪当前正在被推荐的红果短剧。
- 在获取剧集详情前发现短剧 ID。
- 创建短剧片单、内容目录或编辑研究数据集。
- 按 `seriesId` 对比不同时间的推荐结果。
- 用封面、集数和推荐原因补充分析数据。

### 相关红果短剧 Actor

| Actor | 用途 |
| --- | --- |
| [红果短剧关键词建议与自动补全 API](https://apify.com/spider_studio/hongguo-search-suggest) | 发现自动补全词和相关关键词。 |
| [红果短剧搜索与数据爬虫 API](https://apify.com/spider_studio/hongguo-search) | 按关键词查找短剧和 `seriesId`。 |
| [红果短剧详情与剧集列表爬虫 API](https://apify.com/spider_studio/hongguo-series-detail) | 将 `seriesId` 转换为完整元数据和剧集视频 ID。 |
| [红果短剧最佳画质视频地址提取 API](https://apify.com/spider_studio/hongguo-video-best) | 为已授权的视频 ID 获取最佳地址和画质元数据。 |
| [红果短剧全部视频画质与地址提取 API](https://apify.com/spider_studio/hongguo-video-variants) | 为已授权的视频 ID 获取全部画质和地址。 |
| [红果短剧视频下载与视频解密 API](https://apify.com/spider_studio/hongguo-video-download) | 下载并解密视频，将可播放 MP4 上传到用户自有存储。 |
| [红果短剧视频下载与解密到 Apify KVS](https://apify.com/spider_studio/hongguo-video-download-kvs) | 无需对象存储凭证，下载并解密视频，将可播放 MP4 保存到运行 KVS。 |

### 常见问题

#### 推荐流会返回红果短剧 ID 和视频 ID 吗？

会。成功结果包含 `seriesId`，并在可用时返回 `firstVideoId`，可以把推荐发现与短剧详情及已授权的剧集工作流连接起来。

#### 这是红果短剧 API 的替代方案吗？

是。它通过 Apify Console 和 API 提供结构化的红果推荐数据，可用于无代码自动化或应用程序集成。

#### 为什么结果可能少于 `maxResults`？

`maxResults` 是上限而不是保证数量。推荐流可能包含较少的不重复短剧，并且可用内容会随时间变化。

#### 可以下载红果短剧剧集吗？

不可以。此 Actor 返回短剧发现元数据。返回的 ID 只能用于你有权处理的内容和工作流。

### 合法使用与支持

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

如需帮助，请使用 **Issues** 标签页；程序化调用示例请查看 **API** 标签页。

***

### Hongguo short drama recommendation scraper and feed API

**Hongguo Short Drama Recommendation Feed API** is a **红果短剧 scraper and recommendation API** for discovering titles featured by [红果短剧 (Hongguo Duanju)](https://hongguoduanju.com/). It exports one normalized Dataset item per short-drama series, including the title, cover, synopsis, episode count, series ID, first video ID, and recommendation labels.

Use it when you need Hongguo recommendations, trending Chinese short dramas, catalog discovery data, or a machine-readable alternative to manually browsing the 红果短剧 recommendation feed. The Actor extracts metadata only; it does not download or redistribute episodes.

### Why use this Hongguo recommendation scraper?

- Discover short dramas without preparing search keywords.
- Request up to 5,000 unique recommendations in one run.
- Export clean series metadata for research, monitoring, and catalog workflows.
- Get `seriesId` and `firstVideoId` values for use with other Hongguo Actors.
- Keep the original recommendation object with `includeRaw` when you need additional fields.
- Automate collection through the Apify API, schedules, webhooks, Make, or n8n.
- Download results as JSON, CSV, Excel, XML, or HTML.

Common use cases include **红果短剧推荐 monitoring**, Chinese short-drama discovery, content research, title tracking, catalog enrichment, and building a Hongguo short drama dataset.

### What Hongguo recommendation data can the Actor extract?

| Field | Type | Description |
| --- | --- | --- |
| `position` | integer | First appearance of the series in the run. |
| `seriesId` | string | Hongguo short-drama series identifier. |
| `title` | string | Series title. |
| `intro` | string | Short-drama synopsis when available. |
| `coverUrl` | string | Cover image URL. |
| `episodeCount` | integer | Reported number of episodes. |
| `firstVideoId` | string | First episode video ID. |
| `recommendReasons` | array | Recommendation or popularity labels. |
| `raw` | object | Original recommendation data when requested. |

### How to scrape Hongguo short-drama recommendations

1. Open the Actor's **Input** tab.
2. Set `maxResults` to the maximum number of unique recommendations you want.
3. Choose whether to include the original data in `raw`.
4. Click **Start**.
5. Open the Dataset to review, download, or send the results to another service.

### How much does Hongguo recommendation extraction cost?

FREE-tier users pay **$3 per 1,000 successful recommendations** ($0.003 per successful result). Users on BRONZE, SILVER, GOLD, PLATINUM, and DIAMOND tiers continue to pay **$2 per 1,000** ($0.002 per result). Diagnostic rows with `success: false` are not charged. Set a smaller `maxResults` value when you only need a sample of the feed.

### Input

See the **Input** tab for all options. `maxResults` accepts values from 1 to 5,000 and defaults to 50. Duplicate series are excluded from the successful result count.

```json
{
  "maxResults": 50,
  "includeRaw": true
}
```

### Output

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

```json
{
  "success": true,
  "position": 1,
  "seriesId": "7639686403294497854",
  "title": "示例短剧",
  "intro": "一部热门短剧的剧情简介",
  "coverUrl": "https://example.com/cover.jpg",
  "episodeCount": 80,
  "firstVideoId": "7639688323115519038",
  "recommendReasons": ["热播推荐"],
  "error": null
}
```

### Hongguo recommendation scraper use cases

- Track which 红果短剧 titles are currently being recommended.
- Discover series IDs before collecting episode details.
- Build short-drama watchlists, catalogs, or editorial research datasets.
- Compare recommendation snapshots over time by `seriesId`.
- Enrich analytics pipelines with covers, episode counts, and recommendation reasons.

### Related Hongguo Actors

| Actor | Purpose |
| --- | --- |
| [Hongguo Short Drama Keyword Suggestions API](https://apify.com/spider_studio/hongguo-search-suggest) | Discover autocomplete and related keywords. |
| [Hongguo Short Drama Search & Data Scraper API](https://apify.com/spider_studio/hongguo-search) | Find short dramas and series IDs by keyword. |
| [Hongguo Series Details & Episodes Scraper API](https://apify.com/spider_studio/hongguo-series-detail) | Turn a `seriesId` into complete metadata and episode video IDs. |
| [Hongguo Best Quality Video URL Extractor API](https://apify.com/spider_studio/hongguo-video-best) | Resolve the best available URL and quality metadata for an authorized video ID. |
| [Hongguo All Video Qualities & URL Extractor API](https://apify.com/spider_studio/hongguo-video-variants) | Retrieve every available quality and URL for an authorized video ID. |
| [Hongguo Video Downloader & Decryption API](https://apify.com/spider_studio/hongguo-video-download) | Download and decrypt videos to playable MP4 files in user-owned storage. |
| [Hongguo Short Drama Video Downloader API to KVS](https://apify.com/spider_studio/hongguo-video-download-kvs) | Download and decrypt videos to playable MP4 files in the run KVS without cloud-storage credentials. |

### Frequently asked questions

#### Does the recommendation feed return Hongguo series and video IDs?

Yes. Successful results include `seriesId` and, when available, `firstVideoId`, so you can connect recommendation discovery to series-detail and authorized episode workflows.

#### Is this a Hongguo API alternative?

Yes. It provides structured Hongguo recommendation data through the Apify Console and API, so you can use the feed in no-code automations or application code.

#### Why can a run return fewer items than `maxResults`?

`maxResults` is a maximum, not a guarantee. The available feed may contain fewer unique series, and recommendation availability can change between runs.

#### Can this Actor download Hongguo episodes?

No. It returns short-drama discovery metadata. Use the returned IDs only in workflows 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. The Actor is intended for public catalog metadata and does not access private user accounts.

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

# Actor input Schema

## `maxResults` (type: `integer`):

Hard limit for unique successful recommendations. Diagnostic failure rows do not count toward this limit and are not charged.

## `includeRaw` (type: `boolean`):

Include the original per-series Hongguo object beside normalized fields.

## Actor input object example

```json
{
  "maxResults": 50,
  "includeRaw": true
}
```

# Actor output Schema

## `dataset` (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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("spider_studio/hongguo-recommend-feed").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("spider_studio/hongguo-recommend-feed").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 '{}' |
apify call spider_studio/hongguo-recommend-feed --silent --output-dataset

```

## MCP server setup

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

```

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/zG0RuJzsDXmbEPOE6/builds/pXfkXrfB9tGd9Aj9n/openapi.json