Hongguo Drama Rankings API

Get normalized Hongguo overall-hot and comic-drama ranking data. Complex ranking cards are flattened into one Dataset row per title with reusable IDs, rank context, and popularity metadata. Users do not need a Hongguo API key.

Supported rankings

rankType	Ranking
totalHot	Overall hot ranking
comicHot	Comic-drama hot ranking
comicPlay	Comic-drama play ranking
comicNew	New comic-drama ranking

Input

{
  "rankType": "totalHot",
  "page": 1
}

Each run fetches one ranking page. Increase page to continue through the upstream ranking session.

Call with curl

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

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-rankings').call({
    rankType: 'totalHot',
    page: 1,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Call with Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("dramadatalab/hongguo-drama-rankings").call(run_input={
    "rankType": "totalHot",
    "page": 1,
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
print(items)

Example result

{
  "status": "success",
  "bookId": "7651964941498338328",
  "title": "Example ranked title",
  "cover": "https://example.invalid/cover.jpg",
  "rankType": "totalHot",
  "rank": 1,
  "hotValue": 9988.5,
  "page": 1,
  "traceId": "request-trace-id"
}

If the upstream response omits an explicit rank number, the Actor assigns the title's stable one-based position in its ranking list.

Pricing

Event	Price	Charged when
Actor start	$0.00005	Once per run at up to 1 GB memory
Successful metadata query	$0.002	Once when one or more valid ranked titles are returned

A typical successful run costs $0.00205. Empty pages and failed queries do not trigger the metadata event. Platform usage is included.

Related Actors

• Hongguo Latest Releases — discover new releases.
• Hongguo Release Calendar — browse releases by date.
• Hongguo Drama Search — search titles by keyword.
• Hongguo Drama Episodes — list episodes from a ranked bookId.

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