Hongguo Video Downloader & Decryption to KVS

What does Hongguo Short Drama Video Downloader do?

Hongguo Short Drama Video Downloader API bulk-downloads and decrypts authorized episodes from Hongguo Duanju. Submit one or more Hongguo videoId values and the Actor selects the best available rendition, creates a playable MP4, validates the media, and stores the video plus redacted metadata in the run's Apify Key-value store (KVS).

Unlike Hongguo URL extractors, this Actor delivers the actual decrypted MP4 rather than only a temporary CDN link. Unlike the S3/OSS/COS edition, it requires no external bucket, cloud account, or storage credentials. It is designed for authorized Hongguo video downloads, Chinese short-drama archiving, transcription preparation, subtitle workflows, media analysis, and automation pipelines.

Use it only for content you own or are explicitly authorized to download, decrypt, and store.

Why use this Hongguo video downloader API?

• Process up to 1,000 unique Hongguo episode IDs in one run.
• Run eight video jobs concurrently by default with a bounded rolling task pool.
• Select the best available quality automatically.
• Produce a real playable MP4, not just a short-lived source URL.
• Store MP4 and JSON metadata directly in Apify KVS with no S3 setup.
• Return signed download links, KVS keys, resolution, codec, file size, and SHA-256 in Dataset.
• Integrate through the Apify REST API, Python/JavaScript clients, schedules, webhooks, Make, n8n, or MCP.
• Charge the success event only after both KVS records are available.

How does Hongguo video download and decryption work?

Stage	Action	Result
Resolve	Fetch fresh media details and rank available renditions.	Best available rendition for the episode.
Download	Transfer the encrypted media with size limits and retries.	Complete source media file.
Decrypt and validate	Produce and inspect the MP4 duration, codec, and dimensions.	Playable MP4 preserving supported source quality.
Deliver	Store MP4 and redacted metadata in the default KVS.	Signed links plus a searchable Dataset row.

Successful episodes create video-{videoId}.mp4 and meta-{videoId}.json records.

video-{videoId}.mp4
meta-{videoId}.json

What Hongguo video data does the API return?

Field	Description
videoId, success, error	Requested episode ID and processing status.
definition, width, height, codec	Selected and validated media properties.
keyValueStoreId	Default KVS containing the output files.
videoRecordKey, metaRecordKey	Stable record keys for MP4 and metadata.
videoUrl, metaUrl	Signed links for retrieving the records.
fileSize, sha256	MP4 size and integrity digest.

Temporary source URLs, content keys, decryption envelopes, and internal signing data are excluded from public results.

How to download Hongguo short drama episodes

1. Obtain authorized episode IDs with the Hongguo Series Details Actor.
2. Open this Actor's Input tab.
3. Add one or more numeric IDs to videoIds.
4. Click Start and wait while videos are processed concurrently.
5. Open Output → Video files, or read videoUrl from Dataset.

How much does Hongguo video downloading cost?

FREE-tier runs cost $0.0035 per successfully stored video. BRONZE through DIAMOND tiers cost $0.0025 per success. Apify FREE-plan accounts can store up to 100 successful videos 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. Failed videos do not trigger the video-uploaded event or consume quota.

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.

Apify compute, proxy, transfer, KVS operations, and timed storage are separate platform usage. Retaining videos longer or downloading them repeatedly increases storage and transfer costs.

Input

See the Input tab for validation details. No storage credentials are required.

{
  "videoIds": ["7639688323115519038"]
}

Output

You can download the default Dataset as JSON, HTML, CSV, or Excel. The actual MP4 and JSON files are stored in the run's default KVS and exposed through the signed links in successful Dataset rows.

{
  "videoId": "7639688323115519038",
  "success": true,
  "definition": "1080p",
  "width": 1080,
  "height": 1920,
  "codec": "hevc",
  "provider": "apify-kvs",
  "keyValueStoreId": "AbCdEfGhIjKlMnOpQ",
  "videoRecordKey": "video-7639688323115519038.mp4",
  "metaRecordKey": "meta-7639688323115519038.json",
  "videoUrl": "https://api.apify.com/v2/key-value-stores/AbCdEfGhIjKlMnOpQ/records/video-7639688323115519038.mp4?signature=...",
  "fileSize": 17080494,
  "sha256": "f7db5d68490b3080fe35fbff46dfc425d1967bd0de9c0bead8b164ec9bbc838e",
  "error": null
}

Hongguo video downloader API integration

Actor page: Hongguo Short Drama Video Downloader API to KVS

Start an asynchronous run with the stable Actor name:

curl -X POST \
  'https://api.apify.com/v2/acts/spider_studio~hongguo-video-download-kvs/runs' \
  -H 'Authorization: Bearer YOUR_APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"videoIds":["7639688323115519038"]}'

The run response includes defaultDatasetId and defaultKeyValueStoreId. Open the API tab for Python, JavaScript, CLI, HTTP, OpenAPI, and MCP examples.

Reliability, retention, and limits

• Temporary upstream media details can expire; rerunning resolves the latest available URL.

• This edition suits temporary downloads, internal processing, small authorized archives, and workflows without an external bucket. Use the object-storage edition for long-term storage, CDN delivery, versioning, lifecycle policies, or large-scale playback.

• Cloud-verified on September 2, 2026 with a representative episode of about 17 MB; the run produced an MP4 record, metadata record, and successful Dataset row.

• Default concurrency is 8 and can be configured from 1 to 20.

• The Actor preserves supported source quality but does not upscale video.

• Default KVS retention follows the user's Apify storage settings.

• Signed record URLs are bearer links and should be shared only with authorized recipients.

• KVS is convenient result storage, not a replacement for a high-volume video CDN.

Related Hongguo short drama Actors

Actor	Purpose
Hongguo Short Drama Search API	Find dramas and series IDs by title, trope, or keyword.
Hongguo Series Details & Episodes API	Retrieve full episode lists and accepted videoId values.
Hongguo Full Series Downloader & Video Decryption API	Submit seriesIds directly to download and decrypt every episode into Apify KVS.
Hongguo Best Quality Video URL API	Resolve the best rendition and temporary media URL without downloading.
Hongguo All Video Qualities API	Inspect every available resolution, bitrate, codec, and URL.
Hongguo Video Downloader to Object Storage	Deliver decrypted MP4 files to S3, OSS, COS, or compatible storage.

Frequently asked questions

Is this a Hongguo short drama downloader?

Yes. For authorized Hongguo episode IDs, it downloads the media, performs the supported decryption process, validates the output, and delivers a playable MP4.

Can I bulk-download a full Hongguo series?

Yes. This Actor accepts up to 1,000 episode videoIds. For a simpler series-level workflow, send one or more seriesIds directly to the Hongguo Full Series Downloader & Video Decryption API, which discovers and downloads the complete episode lists automatically.

Does it need AWS S3, Alibaba OSS, or Tencent COS?

No. This edition stores output directly in Apify KVS. Choose the object-storage edition when you need CDN delivery, lifecycle policies, versioning, or long-term archives.

Does KVS contain the actual video or only a URL?

Both are provided: KVS contains the actual MP4 record, while Dataset contains its record key and signed videoUrl for convenient retrieval.

Does it always download the highest quality?

It selects the best rendition available for the episode and preserves supported source quality. It does not invent 4K or upscale lower-resolution media.

Are Hongguo videos stored permanently?

Not necessarily. The default KVS follows Apify run-retention settings. Use named or external object storage when permanent retention is required.

Can I use it without content authorization?

No. You must have the legal right to download, decrypt, store, and process the submitted content and comply with Hongguo's terms, copyright rules, and applicable law.

Legal use and support

This Actor is intended only for Hongguo content that the user owns or is explicitly authorized to process. It does not log into private accounts, collect private user data, or override entitlement checks. Laws vary by jurisdiction; consult qualified counsel if you are unsure whether your use is permitted.

For help, open the Issues tab and include the run URL. For programmatic integration, use the API tab.