# Hongguo Best Quality Video URL Extractor API (`spider_studio/hongguo-video-best`) Actor

Get the best available Hongguo short drama video URL by episode ID, with resolution, bitrate, codec, file size, backup links, and playback metadata.

- **URL**: https://apify.com/spider\_studio/hongguo-video-best.md
- **Developed by:** [NewLai](https://apify.com/spider_studio) (community)
- **Categories:** Automation, Social media, Videos
- **Stats:** 6 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-best-quality-video-url-extractor-api)

### 红果短剧最佳画质视频地址提取 API

**红果短剧最佳画质视频地址提取 API**是一款面向 [红果短剧（Hongguo Duanju）](https://hongguoduanju.com/)剧集的**红果短剧视频地址提取器**。提交最多 1,000 个剧集视频 ID，即可为每个 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)。

此 Actor 只返回短期有效的媒体地址和元数据，不下载、解密、托管或永久存储视频文件。请仅将其用于你有权处理的内容。

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

- 支持单个视频 ID，也支持单次最多 1,000 个不重复 ID。
- 无需自行比较全部清晰度即可获得最佳可用画质。
- 返回尺寸、码率、编码、格式、文件大小和备用地址。
- 为已授权的下游工作流保留额外播放元数据。
- 单个剧集不可用不会影响其他成功结果。
- 支持 JSON、CSV、Excel、XML 或 HTML 导出。
- 可通过 Apify API、定时任务、Webhook、Make 或 n8n 集成。

常见用途包括**红果短剧视频地址查询**、剧集媒体元数据、授权系统中的画质控制播放、转录准备、媒体分析和刷新过期 CDN 地址。

### 最佳画质视频 API 返回哪些数据？

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `videoId` | string | 请求的红果剧集视频 ID。 |
| `success` | boolean | 是否找到视频画质。 |
| `availableVariantCount` | integer | 可用画质数量。 |
| `definition` | string | 选中的清晰度标签，例如 1080p。 |
| `width`, `height` | integer | 视频尺寸。 |
| `bitrate`, `fileSize` | integer | 可用时返回码率和文件大小。 |
| `codec`, `format` | string | 选中媒体的编码和容器格式。 |
| `downloadUrl`, `backupUrls` | string / array | 加密的直接和备用 CDN 地址。 |
| `videoMeta` | object | 可用时返回的额外媒体元数据。 |
| `error` | string 或 null | 无法解析时的错误信息。 |

### 如何获取红果短剧最佳画质视频地址？

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

### 视频地址提取如何计费？

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

### 输入

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

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

### 输出

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

```json
{
  "videoId": "7639688323115519038",
  "success": true,
  "availableVariantCount": 3,
  "definition": "1080p",
  "width": 1080,
  "height": 1920,
  "downloadUrl": "https://example.com/video.mp4",
  "error": null
}
```

### 红果短剧视频地址提取使用场景

- 按剧集视频 ID 获取当前最佳画质。
- 刷新已经失效的 CDN 地址。
- 收集视频分辨率、码率、编码和文件大小元数据。
- 准备已授权的转录、审核或媒体分析任务。
- 对比不同剧集可用画质的数量。

### 相关红果短剧 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-variants) | 获取全部画质和地址，而不只返回最佳画质。 |
| [红果短剧视频下载与视频解密 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。

#### 这是红果短剧视频下载器吗？

不是。此 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)。

#### 红果 CDN 地址能使用多久？

CDN 地址可能会过期。请在运行后尽快使用；需要新地址时，可以再次提交相同视频 ID。

#### 如果需要全部画质怎么办？

请使用红果短剧全部画质视频 API，它会返回完整 `variants` 数组，而不仅是最佳画质。

### 合法使用与支持

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

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

***

### Hongguo best-quality video URL extractor API

**Hongguo Best Quality Video URL Extractor API** is a **红果短剧 video URL extractor** for episodes on [红果短剧 (Hongguo Duanju)](https://hongguoduanju.com/). 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`)](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).

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**, 红果短剧 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). 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"
  ]
}
```

### Output

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

```json
{
  "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](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 All Video Qualities & URL Extractor API](https://apify.com/spider_studio/hongguo-video-variants) | Retrieve every quality and URL instead of only the best one. |
| [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

#### 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. The Actor extracts an encrypted media URL and metadata but does not download, decrypt, or store the video itself. 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).

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

# 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-best").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-best").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-best --silent --output-dataset

```

## MCP server setup

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

```

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/qlc9FwP7GWug5DiaV/builds/C3eiEuZrmwIGkiuVQ/openapi.json