Hongguo Short Drama Recommendation Feed API

中文 | English

红果短剧推荐流爬虫与 API

红果短剧推荐流是一款用于发现 红果短剧（Hongguo Duanju）推荐内容的红果短剧爬虫和推荐 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；重复短剧不会计入成功结果数量。

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

输出

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

{
  "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	发现自动补全词和相关关键词。
红果短剧搜索与数据爬虫 API	按关键词查找短剧和 seriesId。
红果短剧详情与剧集列表爬虫 API	将 seriesId 转换为完整元数据和剧集视频 ID。
红果短剧最佳画质视频地址提取 API	为已授权的视频 ID 获取最佳地址和画质元数据。
红果短剧全部视频画质与地址提取 API	为已授权的视频 ID 获取全部画质和地址。
红果短剧视频下载与视频解密 API	下载并解密视频，将可播放 MP4 上传到用户自有存储。
红果短剧视频下载与解密到 Apify 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). 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.

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

Output

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

{
  "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	Discover autocomplete and related keywords.
Hongguo Short Drama Search & Data Scraper API	Find short dramas and series IDs by keyword.
Hongguo Series Details & Episodes Scraper API	Turn a seriesId into complete metadata and episode video IDs.
Hongguo Best Quality Video URL Extractor API	Resolve the best available URL and quality metadata for an authorized video ID.
Hongguo All Video Qualities & URL Extractor API	Retrieve every available quality and URL for an authorized video ID.
Hongguo Video Downloader & Decryption API	Download and decrypt videos to playable MP4 files in user-owned storage.
Hongguo Short Drama Video Downloader API to 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.