Hongguo Release Calendar API

Query Hongguo release and subscription calendar data for a specific date. Nested upstream calendar sections are flattened into one convenient Dataset row per title. Users do not need a Hongguo API key.

What you get

• Date-based release discovery using YYYYMMDD
• Offset pagination metadata on every returned title
• Normalized bookId and videoId values for downstream Actors
• No upstream billing balances, credentials, or raw response envelopes
• A trace ID for support and debugging

Input

{
  "targetDate": "20261010",
  "offset": 0
}

Leave targetDate empty to let the upstream service use the current Asia/Shanghai date. If hasMore is true, call the Actor again with the returned nextOffset.

Call with curl

curl -L "https://api.apify.com/v2/actors/dramadatalab~hongguo-release-calendar/run-sync-get-dataset-items?timeout=120" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"targetDate":"20261010","offset":0}'

Call with JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('dramadatalab/hongguo-release-calendar').call({
    targetDate: '20261010',
    offset: 0,
});
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-release-calendar").call(run_input={
    "targetDate": "20261010",
    "offset": 0,
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
print(items)

Example result

{
  "status": "success",
  "bookId": "7651964941498338328",
  "title": "Example calendar title",
  "cover": "https://example.invalid/cover.jpg",
  "targetDate": "20261010",
  "offset": 0,
  "hasMore": true,
  "nextOffset": 20,
  "traceId": "request-trace-id"
}

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 titles are returned

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

Troubleshooting

• targetDate must be a real date in YYYYMMDD format.
• offset must be zero or greater.
• Set maxTotalChargeUsd to at least $0.00205 for a successful result-bearing run.

Related Actors

• Hongguo Latest Releases — today's full release snapshot.
• Hongguo Drama Rankings — ranked discovery.
• Hongguo Drama Episodes — list episodes for a returned bookId.

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