Hongguo Short Drama Search API

Search Hongguo short dramas, comic dramas, and film/TV titles by name. Get normalized metadata and the reusable bookId required by the episode-list Actor. Users do not need to provide a Hongguo API key.

What you get

• One Dataset row per matching title
• Normalized bookId, title, author, cover, introduction, and episode count
• Short drama, comic drama, and film/TV search modes
• A traceId for troubleshooting without exposing upstream billing or credentials
• JSON, CSV, Excel, and other Dataset export formats provided by Apify

Quick start

{
  "name": "重生",
  "page": 1,
  "tabType": 11
}

tabType	Catalog
11	Short dramas
19	Comic dramas
21	Film and TV

Call with curl

Keep your Apify token in an environment variable. Never put it in client-side code.

curl -L "https://api.apify.com/v2/actors/dramadatalab~hongguo-drama-search/run-sync-get-dataset-items?timeout=120" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"重生","page":1,"tabType":11}'

Call with JavaScript

$npm install apify-client

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('dramadatalab/hongguo-drama-search').call({
    name: '重生',
    page: 1,
    tabType: 11,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Call with Python

$pip install apify-client

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("dramadatalab/hongguo-drama-search").call(run_input={
    "name": "重生",
    "page": 1,
    "tabType": 11,
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
print(items)

Example result

{
  "status": "success",
  "bookId": "7651964941498338328",
  "title": "Example title",
  "author": "Example author",
  "episodeCount": 80,
  "cover": "https://example.invalid/cover.jpg",
  "intro": "Example introduction",
  "traceId": "request-trace-id"
}

The example shows the output shape. Live catalog data comes from the Actor run.

Complete workflow

1. Search here and copy a bookId.
2. Send it to Hongguo Drama Episodes to obtain episode videoId values.
3. Resolve those IDs with the detailed, direct, or batch 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 valid title records are returned

A typical successful search costs $0.00205. Empty results and failed metadata queries do not trigger the metadata event. Platform usage is included in the event prices.

Troubleshooting

• No results: confirm the title, page, and catalog type.
• Run spending limit reached: set maxTotalChargeUsd to at least $0.00205.
• Temporary upstream error: retry later and include traceId when opening an issue.

Related Actors

• Hongguo Drama Episodes — list episodes and obtain videoId values.
• Hongguo Video Parser — detailed quality and media metadata.
• Hongguo Direct Video — automatic direct-route resolution.
• Hongguo Batch Video Parser — parse up to ten episode IDs per request.
• Hongguo Latest Releases — discover newly released titles.
• Hongguo Release Calendar — browse releases by date.
• Hongguo Drama Rankings — discover ranked titles.

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