Hongguo Short Drama Recommendation Feed API

🔥 红果推荐短剧采集 API / Hongguo Recommendation Feed API

🔗 配套红果工具 / Related Hongguo APIs

• 🎙️ 台词转写 / Hongguo Transcript API — 对白、时间轴、说话人及首句 hooks。 Dialogue, timestamps, speaker labels, and opening-sentence hooks.
• 📚 剧集详情 / Hongguo Series Details API — 剧集元数据和单集 ID。 Series metadata and episode IDs.
• 🔎 短剧搜索 / Hongguo Search API — 按剧名或关键词查找剧集。 Find dramas by title or keyword.
• 💡 关键词建议 / Hongguo Keyword Suggestions API — 自动补全与相关搜索词。 Autocomplete and related-query suggestions.
• 📅 上新日历 / 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 从 红果短剧 Hongguo Duanju 的推荐流发现内容，返回剧名、简介、封面、集数、剧集 ID、首集 ID 和推荐标签。每次最多获取 5,000 个唯一推荐剧集。

Hongguo Short Drama Recommendation Feed API discovers titles from the Hongguo Duanju recommendation feed and returns names, synopses, covers, episode counts, series IDs, first episode IDs, and recommendation labels. Request up to 5,000 unique recommended series per run.

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

• 无关键词发现： 不必先准备剧名或种子词。 Discovery without keywords: explore titles without a seed-query list.
• 目录建设： 获取可用于后续详情查询的 seriesId。 Catalog building: collect seriesId values for subsequent detail requests.
• 推荐监测： 保存推荐快照，按剧集 ID 比较变化。 Feed monitoring: save recommendation snapshots and compare them by series ID.
• 对白研究： 将发现的剧集交给开头的转写工具分析台词和首句。 Dialogue research: send discovered series to the Transcript API for dialogue and opening-line analysis.

本 Actor 提供推荐元数据，不下载视频，也不生成台词转写。

This Actor provides recommendation metadata; it does not download videos or generate transcripts.

🚀 如何采集推荐内容 / How to collect Hongguo recommendations

1. 在 Input 设置 maxResults，控制唯一成功推荐的数量上限。 Set maxResults to cap unique successful recommendations.
2. 选择是否通过 includeRaw 保留原始数据。 Choose whether includeRaw should retain the original data.
3. 配置运行预算并点击 Start。 Set the run budget and click Start.
4. 在 Dataset 查看、导出或通过 API 读取结果。 View, export, or fetch results from the Dataset.

📥 输入参数 / Input parameters

参数 / Field	说明 / Description
maxResults	1–5,000，默认 50；只计算唯一成功推荐，诊断行不占此上限。 1–5,000, default 50; counts unique successful recommendations, excluding diagnostic rows.
includeRaw	是否返回原始推荐对象，默认 true。 Include the original recommendation object; defaults to true.

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

maxResults 是最大数量，不保证一定返回这么多内容。推荐流可能较短、包含重复剧集，或因预算和配额提前结束。

maxResults is a maximum, not a guaranteed count. The feed may be shorter, contain duplicate series, or stop early because of budget or quota limits.

📤 推荐结果与字段 / Recommendation output and fields

每个成功的唯一剧集对应一行。下面是虚构的字段示例，非实际推荐或热度排名；启用 includeRaw 时完整结果还包含 raw。

Each successful unique series produces one row. The fictional example below is not a live recommendation or popularity ranking; full results also contain raw when includeRaw is enabled.

{
  "success": true,
  "position": 1,
  "page": 1,
  "offset": 0,
  "pagePosition": 1,
  "tabType": 16,
  "seriesId": "7000000000000000001",
  "title": "示例短剧",
  "intro": "一个关于重新开始的故事。",
  "coverUrl": "https://example.com/cover.jpg",
  "episodeCount": 80,
  "firstVideoId": "7000000000000000002",
  "recommendReasons": ["热门"],
  "error": null
}

字段 / Field	含义 / Meaning
position, seriesId	本次运行中的首次出现位置与剧集 ID。 First appearance in the run and series ID.
title, intro, coverUrl	剧名、可用时的简介与封面。 Title, synopsis when available, and cover image.
episodeCount, firstVideoId	集数与首集视频 ID。 Episode count and first episode video ID.
recommendReasons	上游推荐或热度标签。 Upstream recommendation or popularity labels.
page, offset, pagePosition, tabType	请求分页与位置数据。 Request pagination and position data.
raw	启用 includeRaw 后的原始推荐对象。 Original recommendation object when includeRaw is enabled.
success, error, errorCode	处理状态与可用的诊断信息。 Processing status and applicable diagnostics.

Dataset 支持导出 JSON、CSV、Excel、HTML 或 XML，也可接入 Apify API、定时任务、webhook、Make 和 n8n。

Export the Dataset as JSON, CSV, Excel, HTML, or XML, or connect the Apify API, schedules, webhooks, Make, and n8n.

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

Apify 套餐 / Plan	每个成功推荐 / Per successful recommendation	每 1,000 个结果 / Per 1,000
FREE	$0.003	$3.00
BRONZE / SILVER / GOLD / PLATINUM / DIAMOND	$0.002	$2.00

仅对成功写入的唯一推荐剧集收取结果事件费。重复剧集和 success: false 诊断行不计入成功结果数，也不产生该事件费。

Successful-result event fees apply only to unique recommended series that are saved successfully. Duplicate series and success: false diagnostics are excluded from the successful-result count and event charges.

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

Apify Free-plan accounts can save up to 200 successful recommendations 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

推荐顺序代表官方排行榜吗？ / Is the feed order an official ranking?

结果反映该次推荐请求返回的内容和首次出现顺序，不应把采集位置当作独立核实的全站排名。

Results reflect that recommendation session and the order of first appearance. Collection position should not be treated as an independently verified platform-wide ranking.

返回的 ID 可以用来做什么？ / How can I use the returned IDs?

seriesId 可用于剧集详情或转写；可用的 firstVideoId 可用于指定首集的处理流程。相关工具已放在文档开头。

Use seriesId for series details or transcription. When available, firstVideoId identifies the first episode for episode-specific workflows. Related tools are linked at the top.

为什么两次推荐结果不同？ / Why do results differ between runs?

推荐内容会随时间和请求会话变化。比较时建议保留采集时间，并以 seriesId 关联剧集。

Recommendations can change over time and between sessions. Retain collection times and match series by seriesId when comparing snapshots.

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