Hongguo All Video Qualities & URL Extractor API

中文 | English

红果短剧全部视频画质与地址提取 API

红果短剧全部视频画质与地址提取 API是一款用于获取 红果短剧（Hongguo Duanju）剧集全部可用清晰度的红果短剧视频画质爬虫。提交最多 1,000 个剧集视频 ID，即可提取加密的直接和备用 CDN 地址、分辨率、码率、编码、格式、文件大小和播放元数据。

⚠️ 加密视频提示： 此 Actor 的 downloadUrl 和 backupUrls 指向加密视频文件，不能作为普通 MP4 直接播放。如需将解密后的可播放 MP4 直接保存到 Apify，请使用 红果短剧视频下载与解密到 KVS（video-download-kvs）；如需上传到自有 S3、OSS、COS 或兼容存储，请使用 红果短剧视频下载与视频解密 API（video-download）。

每条成功 Dataset 数据包含完整的 variants 数组，以及方便直接使用的 best 对象。此 Actor 只返回媒体地址和元数据，不下载、解密、托管、存储或分发视频文件。

为什么使用红果全部画质视频解析器？

• 单次为最多 1,000 个不重复视频 ID 获取全部可用画质。
• 可用时对比高清、全高清和低带宽版本。
• 返回直接地址、备用地址、分辨率、码率、编码、格式和文件大小。
• 同时获得最佳画质和所有其他画质。
• 为已授权的下游工作流保留额外播放元数据。
• 支持 JSON、CSV、Excel、XML 或 HTML 导出。
• 可通过 Apify API、定时任务、Webhook、Make 或 n8n 集成。

常见用途包括红果短剧视频画质查询、剧集媒体元数据、画质可用性监控、带宽自适应播放、授权归档规划、转录准备和媒体分析。

可以提取哪些红果视频画质数据？

字段	类型	说明
videoId	string	请求的红果剧集视频 ID。
success	boolean	是否至少找到一个视频画质。
variantCount	integer	返回的不重复画质数量。
variants	array	所有可用画质及其媒体元数据。
best	object	方便直接访问的最佳可用画质。
definition	string	每个画质中的清晰度标签。
width, height	integer	每个画质的视频尺寸。
downloadUrl, backupUrls	string / array	加密的直接和备用 CDN 地址。
codec, format, bitrate, fileSize	mixed	每个画质的技术媒体属性。
videoMeta	object	可用时为每个画质返回的额外媒体元数据。
error	string 或 null	无法解析时的错误信息。

如何获取红果短剧全部视频画质？

1. 从红果短剧详情 Actor 或其他授权来源获取剧集 videoId。
2. 打开此 Actor 的 Input 标签页。
3. 在 videoIds 中添加一个或多个视频 ID。
4. 点击 Start。
5. 打开 Dataset，查看每条成功数据中的 variants。

视频画质提取如何计费？

每 1,000 个成功解析的不重复视频 ID 收费 2 美元，即每个成功 ID 0.002 美元。success: false 的诊断数据不收费，重复视频 ID 不会产生额外结果费用。

输入

完整校验规则请查看 Input 标签页。支持提交 1 到 1,000 个视频 ID。

{
  "videoIds": [
    "7639688323115519038",
    "7639688303955938366"
  ]
}

输出

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

{
  "videoId": "7639688323115519038",
  "success": true,
  "variantCount": 2,
  "variants": [
    {
      "definition": "1080p",
      "width": 1080,
      "height": 1920,
      "downloadUrl": "https://example.com/video.mp4"
    }
  ],
  "best": {
    "definition": "1080p",
    "downloadUrl": "https://example.com/video.mp4"
  },
  "error": null
}

红果视频画质和地址使用场景

• 根据分辨率、码率、编码或文件大小选择画质。
• 对比不同剧集可以使用哪些清晰度。
• 为已授权的播放工作流选择低带宽媒体。
• 收集用于分析、审核或转录的技术元数据。
• 在保留原视频 ID 的情况下刷新过期媒体地址。

相关红果短剧 Actor

Actor	用途
红果短剧推荐流 API	发现热门短剧及其 ID。
红果短剧关键词建议与自动补全 API	发现自动补全词和相关关键词。
红果短剧搜索与数据爬虫 API	按关键词查找短剧和 seriesId。
红果短剧详情与剧集列表爬虫 API	获取此 Actor 接受的剧集视频 ID。
红果短剧最佳画质视频地址提取 API	使用更简单的扁平结果，只获取最佳地址和画质元数据。
红果短剧视频下载与视频解密 API	下载并解密视频，将可播放 MP4 上传到用户自有存储。
红果短剧视频下载与解密到 Apify KVS	无需对象存储凭证，下载并解密视频，将可播放 MP4 保存到运行 KVS。

常见问题

与最佳画质视频 API 有什么区别？

此 Actor 在 variants 中返回全部可用画质；最佳画质 Actor 只返回包含最佳画质的扁平结果。

会下载或解密视频吗？

不会。它只返回加密地址和元数据。如需将解密后的可播放 MP4 直接保存到 Apify，请使用 红果短剧视频下载与解密到 KVS（video-download-kvs）；如需上传到自有对象存储，请使用 红果短剧视频下载与视频解密 API（video-download）。使用这些结果时，必须遵守版权、授权要求和适用法律。

红果视频地址会过期吗？

会。媒体地址可能短期有效。请在运行后尽快使用；需要新地址时，可再次提交相同视频 ID。

合法使用与支持

请仅将此 Actor 用于你有权处理的媒体，并遵守红果短剧的条款、版权、速率限制和适用法律。它不访问私人账户，也不绕过内容授权检查。

媒体地址和播放元数据应视为敏感数据。如需帮助，请使用 Issues 标签页；集成示例请查看 API 标签页。

---

Hongguo all video qualities and URL extractor API

Hongguo All Video Qualities & URL Extractor API is a 红果短剧 video quality scraper for episodes on 红果短剧 (Hongguo Duanju). Provide up to 1,000 episode video IDs to extract every available rendition, including encrypted direct and backup CDN URLs, resolution, bitrate, codec, format, file size, and playback metadata.

⚠️ Encrypted video notice: The downloadUrl and backupUrls returned by this Actor point to encrypted video files and are not directly playable as standard MP4 files. To store decrypted, playable MP4 files directly in Apify, use the Hongguo Short Drama Video Downloader API to KVS (video-download-kvs). For delivery to your own S3, OSS, COS, or compatible storage, use the Hongguo Video Downloader & Decryption API (video-download).

Each successful Dataset item includes the complete variants array plus a convenient best object. The Actor returns media URLs and metadata only; it does not download, decrypt, host, store, or redistribute video files.

Why use this Hongguo all-qualities video resolver?

• Resolve all available qualities for up to 1,000 unique video IDs.
• Compare HD, Full HD, and lower-bandwidth renditions when available.
• Receive direct URLs, backup URLs, resolution, bitrate, codec, format, and file size.
• Get the best available rendition together with every alternative.
• Keep additional playback metadata available for authorized downstream workflows.
• Export results to JSON, CSV, Excel, XML, or HTML.
• Integrate through the Apify API, schedules, webhooks, Make, or n8n.

Use cases include Hongguo video quality lookup, 红果短剧 media metadata, rendition availability monitoring, bandwidth-aware playback, authorized archival planning, transcription preparation, and media analysis.

What Hongguo video quality data can the API extract?

Field	Type	Description
videoId	string	Requested Hongguo episode video ID.
success	boolean	Whether at least one video rendition was found.
variantCount	integer	Number of unique qualities returned.
variants	array	All available renditions and their media metadata.
best	object	Best available rendition for convenient access.
definition	string	Quality label inside each variant.
width, height	integer	Dimensions inside each variant.
downloadUrl, backupUrls	string / array	Encrypted direct and alternate CDN URLs.
codec, format, bitrate, fileSize	mixed	Technical media properties for each rendition.
videoMeta	object	Additional media metadata returned for each rendition when available.
error	string or null	Error message for an unresolved video.

How to get all Hongguo short-drama video qualities

1. Obtain episode videoId values from the Hongguo Series Details Actor or another authorized source.
2. Open this Actor's Input tab.
3. Add one or more values to videoIds.
4. Click Start.
5. Open the Dataset and inspect variants for each successful item.

How much does Hongguo video quality extraction cost?

FREE-tier users pay $3 per 1,000 successfully resolved video IDs ($0.003 per successful unique ID). Users on BRONZE, SILVER, GOLD, PLATINUM, and DIAMOND tiers continue to pay $2 per 1,000 ($0.002 per ID). Diagnostic rows with success: false are not charged, and duplicate video IDs do not generate additional result charges.

Input

See the Input tab for complete validation details. You can submit between 1 and 1,000 video IDs.

{
  "videoIds": [
    "7639688323115519038",
    "7639688303955938366"
  ]
}

Output

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

{
  "videoId": "7639688323115519038",
  "success": true,
  "variantCount": 2,
  "variants": [
    {
      "definition": "1080p",
      "width": 1080,
      "height": 1920,
      "downloadUrl": "https://example.com/video.mp4"
    }
  ],
  "best": {
    "definition": "1080p",
    "downloadUrl": "https://example.com/video.mp4"
  },
  "error": null
}

Hongguo video quality and URL use cases

• Select a rendition based on resolution, bitrate, codec, or file size.
• Compare which qualities are available across different episodes.
• Choose lower-bandwidth media for an authorized playback workflow.
• Collect technical metadata for analysis, moderation, or transcription.
• Refresh expired media URLs while retaining the same video IDs.

Related Hongguo Actors

Actor	Purpose
Hongguo Short Drama Recommendation Feed API	Discover trending short dramas and their IDs.
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	Get the episode video IDs accepted by this Actor.
Hongguo Best Quality Video URL Extractor API	Retrieve only the best URL and quality metadata in a simpler flat result.
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

What is the difference between this Actor and Best Quality Video URL API?

This Actor returns every available rendition in variants. The Best Quality Actor returns one flat result containing only the best available rendition.

Does this Actor download or decrypt videos?

No. It returns encrypted URLs and metadata only. To store decrypted, playable MP4 files directly in Apify, use the Hongguo Short Drama Video Downloader API to KVS (video-download-kvs). For delivery to your own object storage, use the Hongguo Video Downloader & Decryption API (video-download). Your use of those results must comply with copyright, authorization, and applicable law.

Can Hongguo video URLs expire?

Yes. Media URLs can be short-lived. Use them soon after a run and resolve the same video ID again when fresh URLs are required.

Legal use and support

Use this Actor only for media you are authorized to process. Respect Hongguo's terms, copyright, rate limits, and applicable law. The Actor does not access private accounts or override entitlement checks.

Treat media URLs and playback metadata as sensitive. Use the Issues tab for support and the API tab for integration examples.