Hongguo Series Episodes API

List every episode for a Hongguo title and receive normalized episode metadata with reusable videoId values. Use it after the search Actor or whenever you already have a bookId.

What you get

• One Dataset row per episode
• bookId, videoId, episode title, volume name, and publication time
• IDs ready for the standard, direct, or batch video parsers
• A traceId for support and troubleshooting

Quick start

{
  "bookId": "7651964941498338328"
}

Call with curl

curl -L "https://api.apify.com/v2/actors/dramadatalab~hongguo-drama-episodes/run-sync-get-dataset-items?timeout=120" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"bookId":"7651964941498338328"}'

Call with JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('dramadatalab/hongguo-drama-episodes').call({
    bookId: '7651964941498338328',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.map(({ videoId, title }) => ({ videoId, title })));

Call with Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("dramadatalab/hongguo-drama-episodes").call(run_input={
    "bookId": "7651964941498338328",
})
episodes = list(client.dataset(run["defaultDatasetId"]).iterate_items())
print([(episode["videoId"], episode.get("title")) for episode in episodes])

Example result

{
  "status": "success",
  "bookId": "7651964941498338328",
  "videoId": "7601395019102047257",
  "title": "Episode 1",
  "volumeName": "1",
  "firstPassTime": "2026-01-01T00:00:00Z",
  "traceId": "request-trace-id"
}

The example shows the output shape. Live episode metadata comes from the Actor run.

Which parser should you use next?

Need	Actor
One episode plus quality, codec, dimensions, bitrate, and duration	Hongguo Video Parser
One episode with automatic playback-line selection	Hongguo Direct Video
Up to ten episode IDs in one upstream request	Hongguo Batch Video Parser

Pricing

Event	Price	When it is charged
Actor start	$0.00005	Once per run at up to 1 GB memory
Successful metadata query	$0.002	Once only when one or more episodes are returned

A typical successful episode lookup costs $0.00205, whether the title has one episode or many. Empty and failed lookups do not trigger the metadata event. Platform usage is included.

Troubleshooting

• No rows: confirm that bookId came from the Hongguo catalog.
• Invalid input: bookId must be a non-empty string.
• Run spending limit reached: set maxTotalChargeUsd to at least $0.00205.
• Temporary upstream error: retry later and include traceId in an issue.

Related Actors

• Hongguo Drama Search — find titles and obtain bookId values.
• Hongguo Video Parser — detailed single-episode parsing.
• Hongguo Direct Video — smart direct-route parsing.
• Hongguo Batch Video Parser — parse up to ten IDs per request.
• Hongguo Latest Releases — discover titles released today.
• Hongguo Release Calendar — find releases by date.
• Hongguo Drama Rankings — find ranked bookId values.

Use this Actor only for content and data you are authorized to access and process.