Hongguo Best Quality Video URL Extractor API

中文 | English

红果短剧最佳画质视频地址提取 API

红果短剧最佳画质视频地址提取 API是一款面向 红果短剧（Hongguo Duanju）剧集的红果短剧视频地址提取器。提交最多 1,000 个剧集视频 ID，即可为每个 ID 获取当前最佳画质，包括加密 CDN 地址、备用地址、分辨率、码率、编码、文件大小和播放元数据。

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

此 Actor 只返回短期有效的媒体地址和元数据，不下载、解密、托管或永久存储视频文件。请仅将其用于你有权处理的内容。

为什么使用红果最佳画质视频解析器？

• 支持单个视频 ID，也支持单次最多 1,000 个不重复 ID。
• 无需自行比较全部清晰度即可获得最佳可用画质。
• 返回尺寸、码率、编码、格式、文件大小和备用地址。
• 为已授权的下游工作流保留额外播放元数据。
• 单个剧集不可用不会影响其他成功结果。
• 支持 JSON、CSV、Excel、XML 或 HTML 导出。
• 可通过 Apify API、定时任务、Webhook、Make 或 n8n 集成。

常见用途包括红果短剧视频地址查询、剧集媒体元数据、授权系统中的画质控制播放、转录准备、媒体分析和刷新过期 CDN 地址。

最佳画质视频 API 返回哪些数据？

字段	类型	说明
videoId	string	请求的红果剧集视频 ID。
success	boolean	是否找到视频画质。
availableVariantCount	integer	可用画质数量。
definition	string	选中的清晰度标签，例如 1080p。
width, height	integer	视频尺寸。
bitrate, fileSize	integer	可用时返回码率和文件大小。
codec, format	string	选中媒体的编码和容器格式。
downloadUrl, backupUrls	string / array	加密的直接和备用 CDN 地址。
videoMeta	object	可用时返回的额外媒体元数据。
error	string 或 null	无法解析时的错误信息。

如何获取红果短剧最佳画质视频地址？

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

视频地址提取如何计费？

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

输入

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

{
  "videoIds": [
    "7639688323115519038"
  ]
}

输出

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

{
  "videoId": "7639688323115519038",
  "success": true,
  "availableVariantCount": 3,
  "definition": "1080p",
  "width": 1080,
  "height": 1920,
  "downloadUrl": "https://example.com/video.mp4",
  "error": null
}

红果短剧视频地址提取使用场景

• 按剧集视频 ID 获取当前最佳画质。
• 刷新已经失效的 CDN 地址。
• 收集视频分辨率、码率、编码和文件大小元数据。
• 准备已授权的转录、审核或媒体分析任务。
• 对比不同剧集可用画质的数量。

相关红果短剧 Actor

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

常见问题

API 会自动选择最佳可用视频画质吗？

会。每条成功结果包含一个最佳可用画质，并返回当时可用画质的数量。如需自行对比全部画质，请使用全部画质视频 Actor。

这是红果短剧视频下载器吗？

不是。此 Actor 提取加密媒体地址和元数据，但不会下载、解密或存储视频。如需将解密后的可播放 MP4 直接保存到 Apify，请使用 红果短剧视频下载与解密到 KVS（video-download-kvs）；如需上传到自有对象存储，请使用 红果短剧视频下载与视频解密 API（video-download）。

红果 CDN 地址能使用多久？

CDN 地址可能会过期。请在运行后尽快使用；需要新地址时，可以再次提交相同视频 ID。

如果需要全部画质怎么办？

请使用红果短剧全部画质视频 API，它会返回完整 variants 数组，而不仅是最佳画质。

合法使用与支持

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

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

---

Hongguo best-quality video URL extractor API

Hongguo Best Quality Video URL Extractor API is a 红果短剧 video URL extractor for episodes on 红果短剧 (Hongguo Duanju). Submit up to 1,000 episode video IDs and receive the best available rendition for each ID, including an encrypted CDN URL, backup URLs, resolution, bitrate, codec, 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).

The Actor returns short-lived media URLs and metadata. It does not download, decrypt, host, or permanently store video files, and it should only be used with content you are authorized to process.

Why use this Hongguo best-quality video resolver?

• Resolve one video ID or up to 1,000 unique IDs in a single run.
• Get the best available quality without comparing every rendition yourself.
• Receive dimensions, bitrate, codec, format, file size, and backup links.
• Keep additional playback metadata available for authorized downstream workflows.
• Keep unavailable episodes isolated from successful results.
• Export data to JSON, CSV, Excel, XML, or HTML.
• Integrate through the Apify API, schedules, webhooks, Make, or n8n.

Common use cases include Hongguo video URL lookup, 红果短剧 episode media metadata, quality-controlled playback in authorized systems, transcription preparation, media analysis, and refreshing expired CDN links.

What data does the best-quality Hongguo video API return?

Field	Type	Description
videoId	string	Requested Hongguo episode video ID.
success	boolean	Whether a video rendition was found.
availableVariantCount	integer	Number of available qualities considered.
definition	string	Selected quality label, such as 1080p.
width, height	integer	Video dimensions.
bitrate, fileSize	integer	Media bitrate and file size when available.
codec, format	string	Selected media codec and container format.
downloadUrl, backupUrls	string / array	Encrypted direct and alternate CDN URLs.
videoMeta	object	Additional media metadata returned when available.
error	string or null	Error message for an unresolved video.

How to get the best Hongguo short-drama video URL

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 read downloadUrl from successful rows.

How much does Hongguo video URL 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"
  ]
}

Output

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

{
  "videoId": "7639688323115519038",
  "success": true,
  "availableVariantCount": 3,
  "definition": "1080p",
  "width": 1080,
  "height": 1920,
  "downloadUrl": "https://example.com/video.mp4",
  "error": null
}

Hongguo video URL extractor use cases

• Retrieve the highest-quality rendition for an episode video ID.
• Refresh a CDN URL that is no longer available.
• Collect video resolution, bitrate, codec, and file-size metadata.
• Prepare authorized transcription, moderation, or media-analysis jobs.
• Compare the number of available renditions across selected episodes.

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 All Video Qualities & URL Extractor API	Retrieve every quality and URL instead of only the best one.
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 API automatically select the best available video quality?

Yes. Each successful row contains one best available rendition and reports how many qualities were available. Use the All Video Qualities Actor when you need to compare every rendition yourself.

Is this a Hongguo video downloader?

No. The Actor extracts an encrypted media URL and metadata but does not download, decrypt, or store the video itself. 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).

How long do Hongguo CDN URLs remain valid?

CDN URLs can expire. Use the result soon after the run and resolve the same video ID again when a fresh URL is needed.

What if I need every available video quality?

Use the Hongguo Video All Qualities API, which returns the complete variants array instead of only the best rendition.

Legal use and support

Use this Actor only for videos you are authorized to process. Respect Hongguo's terms, copyright rules, 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 generated integration examples.