Hongguo Video Downloader & Decryption to OSS

Hongguo video downloader and decryption API

Hongguo Video Downloader & Decryption API is an end-to-end Hongguo short drama video downloader for authorized episodes from Hongguo Duanju. Submit one or more video IDs and the Actor selects the best available rendition, downloads and decrypts the video, validates the result, and uploads a playable MP4 plus metadata to your own object-storage bucket.

Use it when you need the actual decrypted video file rather than a temporary video URL. The Actor supports AWS S3, Alibaba Cloud OSS, Tencent Cloud COS, and S3-compatible storage. Large video files go directly to user-owned storage; Apify Dataset contains only processing results and object locations.

Use this Actor only for videos that you own or are explicitly authorized to download, decrypt, and store.

What happens during a Hongguo decrypted video download?

Stage	What the Actor does	Result
Resolve	Fetches fresh media details and selects the highest-ranked available rendition.	Best available source quality for each video ID.
Download and decrypt	Securely processes the selected rendition into a playable video file.	Decrypted MP4 that preserves the supported source quality.
Validate and deliver	Checks the finished file and uploads the video plus redacted metadata.	Verified video.mp4 and meta.json in your bucket.

Why use this Hongguo decrypted video downloader?

• Process multiple authorized Hongguo video IDs in one run.
• Write each Dataset result as soon as that individual video finishes.
• Upload completed videos concurrently, bounded by the same video concurrency limit.
• Select the best available rendition automatically.
• Produce a playable decrypted MP4 while preserving the supported source quality.
• Validate every finished MP4 before upload.
• Upload decrypted videos directly to your own private object-storage bucket.
• Store normalized media metadata beside each decrypted MP4.
• Use stable, predictable object keys based only on the video ID.
• Protect storage credentials with Apify encrypted secret inputs.
• Integrate through the Apify API, schedules, webhooks, Make, n8n, or other workflows.

Common use cases include authorized video archiving, transcription preparation, media analysis, moderation workflows, internal playback systems, and transferring decrypted media into an existing data pipeline.

What files and metadata does the Actor produce?

Each successful video ID produces two objects in the configured bucket:

{prefix}/videos/{videoId}/video.mp4
{prefix}/videos/{videoId}/meta.json

video.mp4 is the downloaded and decrypted playable video. meta.json describes the selected rendition and uploaded object without exposing sensitive processing data or source access information.

Dataset field	Type	Description
videoId	string	Requested Hongguo episode video ID.
success	boolean	Whether the decrypted video and metadata were uploaded.
definition	string	Best selected rendition definition.
width, height	integer	Validated decrypted video dimensions.
codec	string	Codec detected in the decrypted MP4.
videoObjectKey	string	Stable key of the decrypted video.mp4.
metaObjectKey	string	Stable key of the companion meta.json.
fileSize	integer	Decrypted MP4 size in bytes.
sha256	string	SHA-256 digest of the decrypted MP4.
error	string or null	Safe error message for a failed video.

Sensitive processing data, source access information, and object-storage credentials are never written to Dataset rows or uploaded metadata.

How to download and decrypt Hongguo short drama videos

1. Obtain authorized episode videoId values from the Hongguo Series Details Actor or another permitted source.
2. Create a dedicated IAM, RAM, or CAM sub-account restricted to the destination bucket and prefix.
3. Open this Actor's Input tab and add one or more values to videoIds.
4. Select AWS S3, Alibaba OSS, Tencent COS, or an S3-compatible provider.
5. Enter the Region, Bucket, optional Prefix, and provider credentials.
6. For Alibaba OSS or S3-compatible storage, enter the public HTTPS endpoint. Leave Endpoint empty for AWS S3 and Tencent COS.
7. Click Start. The Actor prepares and uploads each decrypted video to the configured bucket.
8. Open the Dataset to find the exact object keys and provider URIs.

How much does Hongguo video download and decryption cost?

FREE-tier users pay $3.50 per 1,000 successful video uploads ($0.0035 each). Users on BRONZE, SILVER, GOLD, PLATINUM, and DIAMOND tiers continue to pay $2.50 per 1,000 ($0.0025 each). Apify FREE-plan accounts can upload 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. One video-uploaded event is charged and consumes quota only after both video.mp4 and meta.json have been uploaded successfully for a video ID. Failed uploads and diagnostic Dataset rows do not trigger this 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.

Users also pay the Actor's Apify platform usage costs separately. Those costs depend mainly on video size, run memory, execution time, network traffic, and upload traffic to the user's storage provider. The final total is shown in Apify Console.

The Actor processes up to eight videos concurrently by default. Increase run memory when processing multiple large videos because concurrent jobs require additional disk, memory, CPU, and network capacity.

Input

See the Input tab for the complete form and validation rules.

{
  "videoIds": [
    "7639688323115519038",
    "7639688303955938366"
  ],
  "storageProvider": "aws-s3",
  "storageRegion": "ap-southeast-1",
  "storageEndpoint": "",
  "storageBucket": "my-video-bucket",
  "storagePrefix": "hongguo",
  "storageKeyId": "AKIA...",
  "storageKeySecret": "..."
}

Provider requirements:

Provider	Region	Endpoint	Credential mapping
AWS S3	Required	Leave empty	Access Key ID / Secret Access Key
Alibaba OSS	Required	Public HTTPS OSS endpoint	AccessKey ID / AccessKey Secret
Tencent COS	Required	Empty or COS accelerate endpoint	SecretId / SecretKey
S3-compatible	Required	Public HTTPS endpoint	Access Key ID / Secret Access Key

Tencent COS bucket names must include the numeric AppId suffix, and storageRegion must match the Bucket's COS Region shown in Tencent Cloud Console (for example, ap-guangzhou). After enabling global acceleration for the Bucket, enter a Tencent endpoint containing cos.accelerate.myqcloud.com; the Actor detects it automatically. storageKeyId and storageKeySecret are encrypted secret inputs. Never use root-account credentials; grant only the upload and multipart permissions required for the configured bucket and prefix.

Global acceleration for cross-border object-storage uploads

Global acceleration can improve upload speed and stability when the Actor runs outside the country or region where the destination Bucket is located. The acceleration service must be enabled on the Bucket before starting the Actor, and cloud providers may charge additional acceleration traffic fees.

Tencent COS global acceleration

1. Open the target Bucket in Tencent Cloud COS Console.
2. Go to Domain and Transfer Management > Global Acceleration and enable the feature.
3. Keep storageRegion set to the Bucket's actual Region, such as ap-guangzhou.
4. Set storageEndpoint to https://cos.accelerate.myqcloud.com.

{
  "storageProvider": "tencent-cos",
  "storageRegion": "ap-guangzhou",
  "storageEndpoint": "https://cos.accelerate.myqcloud.com",
  "storageBucket": "my-video-1250000000"
}

Either of the following Endpoint formats automatically enables Tencent COS global acceleration:

https://cos.accelerate.myqcloud.com
https://my-video-1250000000.cos.accelerate.myqcloud.com

The Actor normalizes both forms to the official Tencent COS acceleration endpoint. If global acceleration is not enabled for the Bucket, Tencent COS will reject the upload. See Tencent COS Global Acceleration.

Alibaba OSS transfer acceleration

1. Open the target Bucket in Alibaba Cloud OSS Console.
2. Go to Bucket Configuration > Transfer Acceleration and enable the feature.
3. Keep storageRegion set to the Bucket's actual Region, such as cn-hangzhou.
4. Set storageEndpoint to https://oss-accelerate.aliyuncs.com.

{
  "storageProvider": "aliyun-oss",
  "storageRegion": "cn-hangzhou",
  "storageEndpoint": "https://oss-accelerate.aliyuncs.com",
  "storageBucket": "my-video-bucket"
}

Alibaba Cloud states that transfer acceleration may take about 30 minutes to become effective after it is enabled. Using an acceleration endpoint without enabling the Bucket feature causes an upload error. See Alibaba OSS Transfer Acceleration.

Tencent and Alibaba acceleration are detected from storageEndpoint. This does not automatically enable AWS S3 Transfer Acceleration or a vendor-specific S3-compatible acceleration feature. For those providers, use only endpoints and acceleration options explicitly supported by that storage vendor.

Output

Decrypted video and metadata objects use stable paths:

hongguo/videos/7639688323115519038/video.mp4
hongguo/videos/7639688323115519038/meta.json

Running the same video ID again replaces objects at the same keys. Enable bucket versioning if previous copies must remain recoverable.

The default Dataset records the upload status and object locations. You can download the Dataset in formats such as JSON, HTML, CSV, or Excel.

{
  "videoId": "7639688323115519038",
  "success": true,
  "definition": "1080p",
  "width": 1080,
  "height": 1920,
  "codec": "hevc",
  "provider": "aws-s3",
  "bucket": "my-video-bucket",
  "videoObjectKey": "hongguo/videos/7639688323115519038/video.mp4",
  "metaObjectKey": "hongguo/videos/7639688323115519038/meta.json",
  "videoUri": "s3://my-video-bucket/hongguo/videos/7639688323115519038/video.mp4",
  "metaUri": "s3://my-video-bucket/hongguo/videos/7639688323115519038/meta.json",
  "fileSize": 17080494,
  "sha256": "f7db5d68490b3080fe35fbff46dfc425d1967bd0de9c0bead8b164ec9bbc838e",
  "error": null
}

Tips for reliable decrypted video uploads

• Keep the destination bucket private and manage download access separately.
• Enable bucket versioning before using stable keys if accidental overwrites are a concern.
• Allocate enough Actor memory and disk capacity for the expected video sizes.
• Use a provider region close to the Actor runtime when possible to reduce upload time.
• Restrict credentials to the configured bucket and object prefix.
• Run the Actor again if a temporary upstream media reference has expired.

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 episode video IDs accepted by this Actor.
Hongguo Full Series Downloader & Video Decryption API	Download every episode directly from seriesIds into Apify KVS.
Hongguo Best Quality Video URL Extractor API	Resolve the best URL and quality metadata without downloading video.
Hongguo All Video Qualities & URL Extractor API	Inspect every available quality and URL without downloading video.
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

Can this Actor decrypt encrypted Hongguo videos?

Yes. For an authorized Hongguo video ID with supported media information, the Actor handles the decryption process internally and produces a playable MP4. Internal processing details are not exposed in Dataset rows, uploaded metadata, or logs.

Does it download the MP4 file or only return a video URL?

It downloads, decrypts, validates, and uploads the actual MP4 file. If you only need a fresh media URL or want to inspect available renditions, use the related URL resolver Actors instead.

Can I decrypt and download multiple Hongguo episodes in one run?

Yes. Add up to 1,000 authorized videoIds to one run. The Actor processes them with bounded concurrency and writes each result to the Dataset as soon as it finishes. If you have seriesIds and want every episode stored in Apify KVS without configuring a bucket, use the Hongguo Full Series Downloader & Video Decryption API.

Does decryption change or reduce the video quality?

The Actor selects the best available rendition and preserves the supported source quality in the delivered MP4. It does not claim to enhance or upscale the original video.

Does this Actor output the decrypted video itself?

Yes. Unlike the URL resolver Actors, this Actor delivers a decrypted playable MP4 to the user's configured object-storage bucket.

Does the Actor expose sensitive processing data?

No. Internal processing data is excluded from uploaded metadata, Dataset rows, and application logs.

Why did an upload fail with access denied?

Confirm that the credential can upload normal objects and multipart parts under the exact bucket and prefix. Tencent COS bucket names must include the AppId suffix. Alibaba OSS and S3-compatible providers also require a valid HTTPS endpoint.

Can this Actor be used without content authorization?

No. It is intended only for submitted Hongguo video IDs that the user is authorized to process. It must not be used to infringe copyright, bypass entitlement checks, or redistribute content without permission.

Legal use and support

Use this Actor only for videos that you own or are explicitly authorized to download, decrypt, store, and process. Respect Hongguo's terms, copyright, rate limits, storage-provider rules, and applicable laws. The Actor does not access private accounts or override entitlement checks.

Laws vary by jurisdiction. Consult qualified counsel if you are unsure whether your use is permitted. Use the Issues tab for support and the API tab for programmatic integration examples.