# Hongguo All Video Qualities & URL Extractor API (`spider_studio/hongguo-video-variants`) Actor

Extract every available Hongguo short drama video quality by episode ID, including CDN URLs, resolution, bitrate, codec, file size, and playback metadata.

- **URL**: https://apify.com/spider\_studio/hongguo-video-variants.md
- **Developed by:** [NewLai](https://apify.com/spider_studio) (community)
- **Categories:** Automation, Social media, Videos
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 successful video ids

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[中文](#红果短剧全部视频画质与地址提取-api) | [English](#hongguo-all-video-qualities-and-url-extractor-api)

### 红果短剧全部视频画质与地址提取 API

**红果短剧全部视频画质与地址提取 API**是一款用于获取 [红果短剧（Hongguo Duanju）](https://hongguoduanju.com/)剧集全部可用清晰度的**红果短剧视频画质爬虫**。提交最多 1,000 个剧集视频 ID，即可提取加密的直接和备用 CDN 地址、分辨率、码率、编码、格式、文件大小和播放元数据。

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

每条成功 Dataset 数据包含完整的 `variants` 数组，以及方便直接使用的 `best` 对象。此 Actor 只返回媒体地址和元数据，不下载、解密、托管、存储或分发视频文件。

### 为什么使用红果全部画质视频解析器？

- 单次为最多 1,000 个不重复视频 ID 获取全部可用画质。
- 可用时对比高清、全高清和低带宽版本。
- 返回直接地址、备用地址、分辨率、码率、编码、格式和文件大小。
- 同时获得最佳画质和所有其他画质。
- 为已授权的下游工作流保留额外播放元数据。
- 支持 JSON、CSV、Excel、XML 或 HTML 导出。
- 可通过 Apify API、定时任务、Webhook、Make 或 n8n 集成。

常见用途包括**红果短剧视频画质查询**、剧集媒体元数据、画质可用性监控、带宽自适应播放、授权归档规划、转录准备和媒体分析。

### 可以提取哪些红果视频画质数据？

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `videoId` | string | 请求的红果剧集视频 ID。 |
| `success` | boolean | 是否至少找到一个视频画质。 |
| `variantCount` | integer | 返回的不重复画质数量。 |
| `variants` | array | 所有可用画质及其媒体元数据。 |
| `best` | object | 方便直接访问的最佳可用画质。 |
| `definition` | string | 每个画质中的清晰度标签。 |
| `width`, `height` | integer | 每个画质的视频尺寸。 |
| `downloadUrl`, `backupUrls` | string / array | 加密的直接和备用 CDN 地址。 |
| `codec`, `format`, `bitrate`, `fileSize` | mixed | 每个画质的技术媒体属性。 |
| `videoMeta` | object | 可用时为每个画质返回的额外媒体元数据。 |
| `error` | string 或 null | 无法解析时的错误信息。 |

### 如何获取红果短剧全部视频画质？

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

### 视频画质提取如何计费？

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

### 输入

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

```json
{
  "videoIds": [
    "7639688323115519038",
    "7639688303955938366"
  ]
}
```

### 输出

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

```json
{
  "videoId": "7639688323115519038",
  "success": true,
  "variantCount": 2,
  "variants": [
    {
      "definition": "1080p",
      "width": 1080,
      "height": 1920,
      "downloadUrl": "https://example.com/video.mp4"
    }
  ],
  "best": {
    "definition": "1080p",
    "downloadUrl": "https://example.com/video.mp4"
  },
  "error": null
}
```

### 红果视频画质和地址使用场景

- 根据分辨率、码率、编码或文件大小选择画质。
- 对比不同剧集可以使用哪些清晰度。
- 为已授权的播放工作流选择低带宽媒体。
- 收集用于分析、审核或转录的技术元数据。
- 在保留原视频 ID 的情况下刷新过期媒体地址。

### 相关红果短剧 Actor

| Actor | 用途 |
| --- | --- |
| [红果短剧推荐流 API](https://apify.com/spider_studio/hongguo-recommend-feed) | 发现热门短剧及其 ID。 |
| [红果短剧关键词建议与自动补全 API](https://apify.com/spider_studio/hongguo-search-suggest) | 发现自动补全词和相关关键词。 |
| [红果短剧搜索与数据爬虫 API](https://apify.com/spider_studio/hongguo-search) | 按关键词查找短剧和 `seriesId`。 |
| [红果短剧详情与剧集列表爬虫 API](https://apify.com/spider_studio/hongguo-series-detail) | 获取此 Actor 接受的剧集视频 ID。 |
| [红果短剧最佳画质视频地址提取 API](https://apify.com/spider_studio/hongguo-video-best) | 使用更简单的扁平结果，只获取最佳地址和画质元数据。 |
| [红果短剧视频下载与视频解密 API](https://apify.com/spider_studio/hongguo-video-download) | 下载并解密视频，将可播放 MP4 上传到用户自有存储。 |
| [红果短剧视频下载与解密到 Apify KVS](https://apify.com/spider_studio/hongguo-video-download-kvs) | 无需对象存储凭证，下载并解密视频，将可播放 MP4 保存到运行 KVS。 |

### 常见问题

#### 与最佳画质视频 API 有什么区别？

此 Actor 在 `variants` 中返回全部可用画质；最佳画质 Actor 只返回包含最佳画质的扁平结果。

#### 会下载或解密视频吗？

不会。它只返回加密地址和元数据。如需将解密后的可播放 MP4 直接保存到 Apify，请使用 [红果短剧视频下载与解密到 KVS（`video-download-kvs`）](https://apify.com/spider_studio/hongguo-video-download-kvs)；如需上传到自有对象存储，请使用 [红果短剧视频下载与视频解密 API（`video-download`）](https://apify.com/spider_studio/hongguo-video-download)。使用这些结果时，必须遵守版权、授权要求和适用法律。

#### 红果视频地址会过期吗？

会。媒体地址可能短期有效。请在运行后尽快使用；需要新地址时，可再次提交相同视频 ID。

### 合法使用与支持

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

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

***

### Hongguo all video qualities and URL extractor API

**Hongguo All Video Qualities & URL Extractor API** is a **红果短剧 video quality scraper** for episodes on [红果短剧 (Hongguo Duanju)](https://hongguoduanju.com/). Provide up to 1,000 episode video IDs to extract every available rendition, including encrypted direct and backup CDN URLs, resolution, bitrate, codec, format, 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`)](https://apify.com/spider_studio/hongguo-video-download-kvs). For delivery to your own S3, OSS, COS, or compatible storage, use the [Hongguo Video Downloader & Decryption API (`video-download`)](https://apify.com/spider_studio/hongguo-video-download).

Each successful Dataset item includes the complete `variants` array plus a convenient `best` object. The Actor returns media URLs and metadata only; it does not download, decrypt, host, store, or redistribute video files.

### Why use this Hongguo all-qualities video resolver?

- Resolve all available qualities for up to 1,000 unique video IDs.
- Compare HD, Full HD, and lower-bandwidth renditions when available.
- Receive direct URLs, backup URLs, resolution, bitrate, codec, format, and file size.
- Get the best available rendition together with every alternative.
- Keep additional playback metadata available for authorized downstream workflows.
- Export results to JSON, CSV, Excel, XML, or HTML.
- Integrate through the Apify API, schedules, webhooks, Make, or n8n.

Use cases include **Hongguo video quality lookup**, 红果短剧 media metadata, rendition availability monitoring, bandwidth-aware playback, authorized archival planning, transcription preparation, and media analysis.

### What Hongguo video quality data can the API extract?

| Field | Type | Description |
| --- | --- | --- |
| `videoId` | string | Requested Hongguo episode video ID. |
| `success` | boolean | Whether at least one video rendition was found. |
| `variantCount` | integer | Number of unique qualities returned. |
| `variants` | array | All available renditions and their media metadata. |
| `best` | object | Best available rendition for convenient access. |
| `definition` | string | Quality label inside each variant. |
| `width`, `height` | integer | Dimensions inside each variant. |
| `downloadUrl`, `backupUrls` | string / array | Encrypted direct and alternate CDN URLs. |
| `codec`, `format`, `bitrate`, `fileSize` | mixed | Technical media properties for each rendition. |
| `videoMeta` | object | Additional media metadata returned for each rendition when available. |
| `error` | string or null | Error message for an unresolved video. |

### How to get all Hongguo short-drama video qualities

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 inspect `variants` for each successful item.

### How much does Hongguo video quality 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.

```json
{
  "videoIds": [
    "7639688323115519038",
    "7639688303955938366"
  ]
}
```

### Output

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

```json
{
  "videoId": "7639688323115519038",
  "success": true,
  "variantCount": 2,
  "variants": [
    {
      "definition": "1080p",
      "width": 1080,
      "height": 1920,
      "downloadUrl": "https://example.com/video.mp4"
    }
  ],
  "best": {
    "definition": "1080p",
    "downloadUrl": "https://example.com/video.mp4"
  },
  "error": null
}
```

### Hongguo video quality and URL use cases

- Select a rendition based on resolution, bitrate, codec, or file size.
- Compare which qualities are available across different episodes.
- Choose lower-bandwidth media for an authorized playback workflow.
- Collect technical metadata for analysis, moderation, or transcription.
- Refresh expired media URLs while retaining the same video IDs.

### Related Hongguo Actors

| Actor | Purpose |
| --- | --- |
| [Hongguo Short Drama Recommendation Feed API](https://apify.com/spider_studio/hongguo-recommend-feed) | Discover trending short dramas and their IDs. |
| [Hongguo Short Drama Keyword Suggestions API](https://apify.com/spider_studio/hongguo-search-suggest) | Discover autocomplete and related keywords. |
| [Hongguo Short Drama Search & Data Scraper API](https://apify.com/spider_studio/hongguo-search) | Find short dramas and series IDs by keyword. |
| [Hongguo Series Details & Episodes Scraper API](https://apify.com/spider_studio/hongguo-series-detail) | Get the episode video IDs accepted by this Actor. |
| [Hongguo Best Quality Video URL Extractor API](https://apify.com/spider_studio/hongguo-video-best) | Retrieve only the best URL and quality metadata in a simpler flat result. |
| [Hongguo Video Downloader & Decryption API](https://apify.com/spider_studio/hongguo-video-download) | Download and decrypt videos to playable MP4 files in user-owned storage. |
| [Hongguo Short Drama Video Downloader API to KVS](https://apify.com/spider_studio/hongguo-video-download-kvs) | Download and decrypt videos to playable MP4 files in the run KVS without cloud-storage credentials. |

### Frequently asked questions

#### What is the difference between this Actor and Best Quality Video URL API?

This Actor returns every available rendition in `variants`. The Best Quality Actor returns one flat result containing only the best available rendition.

#### Does this Actor download or decrypt videos?

No. It returns encrypted URLs and metadata only. To store decrypted, playable MP4 files directly in Apify, use the [Hongguo Short Drama Video Downloader API to KVS (`video-download-kvs`)](https://apify.com/spider_studio/hongguo-video-download-kvs). For delivery to your own object storage, use the [Hongguo Video Downloader & Decryption API (`video-download`)](https://apify.com/spider_studio/hongguo-video-download). Your use of those results must comply with copyright, authorization, and applicable law.

#### Can Hongguo video URLs expire?

Yes. Media URLs can be short-lived. Use them soon after a run and resolve the same video ID again when fresh URLs are required.

### Legal use and support

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

# Actor input Schema

## `videoIds` (type: `array`):

Episode video IDs to resolve in API batches of at most 50. Duplicates are ignored.

## Actor input object example

```json
{
  "videoIds": [
    "7639688323115519038"
  ]
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "videoIds": [
        "7639688323115519038"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("spider_studio/hongguo-video-variants").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "videoIds": ["7639688323115519038"] }

# Run the Actor and wait for it to finish
run = client.actor("spider_studio/hongguo-video-variants").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "videoIds": [
    "7639688323115519038"
  ]
}' |
apify call spider_studio/hongguo-video-variants --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,spider_studio/hongguo-video-variants"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/UgDyXjHP6DeFycMsB/builds/R6OUnsyrpKSN6Zjyz/openapi.json