Hongguo Best Quality Video URL Extractor API

Hongguo best-quality video URL extractor API

Hongguo Best Quality Video URL Extractor API is a Hongguo short-drama 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, Hongguo 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). Apify FREE-plan accounts can persist up to 100 successfully resolved video IDs per UTC calendar month in this Actor; the quota resets at 00:00 UTC on the first day of each month. Paid-plan accounts are not subject to this product quota. Diagnostic rows with success: false are not charged and do not consume the quota, and duplicate video IDs do not generate additional result charges.

If a FREE-plan run requests more than the remaining monthly quota, the Actor writes one uncharged Dataset diagnostic row with errorCode: "FREE_TIER_MONTHLY_QUOTA_REACHED", including processed, requested, skipped, limit, and reset details. Paid-plan runs never receive this quota row.

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 Full Series Downloader & Video Decryption API	Download and decrypt complete series from seriesIds into Apify KVS.
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. This Actor returns an encrypted media URL and metadata but does not download, decrypt, or store the video itself.

Download need	Recommended Actor
Every episode from one or more seriesIds	Hongguo Full Series Downloader & Video Decryption API
Selected videoIds stored in Apify KVS	Hongguo Video Downloader API to KVS
Selected videoIds delivered to your own bucket	Hongguo Video Downloader & Decryption API

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.