Hongguo Video Downloader & Decryption to KVS

What does Hongguo Short Drama Video Downloader do? (Deprecated)

Deprecated as of November 2, 2026. This Actor is no longer recommended for new integrations. Actor charges are scheduled to end on November 16, 2026 at 11:25:22 UTC; the existing pricing below applies until then. Apify platform usage charges still apply after the Actor becomes free.

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).

This Actor delivers the actual decrypted MP4. 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?

Scheduled change: From November 16, 2026 at 11:25:22 UTC, this Actor uses the FREE pricing model with no Actor event fees. Until that time, the following pricing remains active.

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

Example ID mapping: 7678236482489830424 identifies the full drama 垂竿向晚; 7678238971456932889 identifies its first episode. This Actor accepts the episode ID in videoIds.

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

{
  "videoIds": ["7678238971456932889"]
}

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": "7678238971456932889",
  "success": true,
  "definition": "1080p",
  "width": 1080,
  "height": 1920,
  "codec": "hevc",
  "provider": "apify-kvs",
  "keyValueStoreId": "AbCdEfGhIjKlMnOpQ",
  "videoRecordKey": "video-7678238971456932889.mp4",
  "metaRecordKey": "meta-7678238971456932889.json",
  "videoUrl": "https://api.apify.com/v2/key-value-stores/AbCdEfGhIjKlMnOpQ/records/video-7678238971456932889.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":["7678238971456932889"]}'

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.

• 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 Release Calendar Scraper API	Find released dramas by date, then retrieve episode IDs for authorized video downloads.
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.

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.

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

No. This edition stores output directly in Apify KVS.

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.